Benefits by Wallet

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

Benefits Endpoint Examples

The Benefits endpoint allows you to retrieve a list of benefits supported by the Miracle API Protocol. These benefits can include airdrops, event tickets, exclusive content, and more. You will receive a full list of Benefits the Wallet is eligible for.

Important Notes

  • validFrom and validTo:
    • validFrom: The date when the benefit becomes active and trackable on the Miracle.
    • validTo: The date when the benefit expires and is no longer available.
  • Action Date:
    • Represents the deadline for the user to take a specific action, such as claiming or minting a benefit.
    • May differ from validTo in cases like events where tickets need to be claimed by a certain date (actionDate), but the event occurs later (validTo).

Thumbnail Guidelines

For optimal visual presentation across various devices and interfaces, we advise using a 16:9 thumbnail ratio for all benefit visuals. This recommended ratio ensures:

  • Optimal Fit: Thumbnails render properly on different screen sizes including desktop, tablet, and mobile devices.
  • Consistent Appearance: Maintaining a standard 16:9 aspect ratio across your application helps preserve a unified and professional look.
  • Enhanced User Experience: A predictable and balanced thumbnail size boosts visual clarity and focus, especially when displaying multiple benefits.
Path Params
string
required
Defaults to ethereum

Enter the chain(s) in comma separated format.

string
required
Defaults to 0x51787a2C56d710c68140bdAdeFD3A98BfF96FeB4

enter the wallet address you want to check

Query Params
collections
array of strings

The collection name. An Array of Collections Names which can take part in this benefit.

collections
string

enter the contract address to filter

int32

0 excludes expired benefits, 1 includes expired benefits

string

Order of the items are returned in the response. Options are: validFrom, validTo, name

string

Allowed values: ASC or DESC

int32
Defaults to 20

Amount of items returned in response. Default and max limit is 20

string

Search for benefits that match a string in their longtitle. Example: airdrop

string

The category identifier. Supported category filters can be found under the "Supported Category Filters" tab.

string

Filter by valid from date

string

Filter by valid to date

int32
Defaults to 0

Use continuation token to request next offset of items.

Response

Language
LoadingLoading…
Response
Click Try It! to start a request and see the response here!