API Reference

Personalize your application by making benefits available to your users and their specific wallet address. This endpoint includes all benefits gathered from sources coming from Official, Third Party and Community Sources.

Examples

Retrieve benefits for a certain Wallet and certain collection:
Request:

GET https://www.themiracle.io/api/v1/wallet/ethereum/0x2f74ad2c64be7dc07c9f51e9d338ecb7c1ee0b18/fungible/benefits
  ?limit=20
  &offset=0
  &benefit=bet
  &category=Entertainment
  &collection=bonk
  &validFrom=2024-11-06
  &validTo=2024-12-01
  &contract=0x1151CB3d861920e07a38e03eEAd12C32178567F6
  &contractSlug=ethereum.0x1151cb3d861920e07a38e03eead12c32178567f6
  &expired=0

Explanation:
Parameters Breakdown:

  • limit=20: Return up to 20 benefits.
  • offset=0: Start from the first result.
  • benefit=play: Search for benefits containing "bet".
  • category=Game Integration: Filter by the "Entertainment" category.
  • collection=bonk: Filter benefits for the "BONK" token.
  • validFrom=2024-11-06 and validTo=2024-12-01: Date range filter.
  • contract=0x1151CB3d861920e07a38e03eEAd12C32178567F6: Filter by specific NFT contract.
  • contractSlug=ethereum.0x1151cb3d861920e07a38e03eead12c32178567f6s: Filter by contract slug.
  • expired=0: Exclude expired benefits.
Language
Credentials
Header
Click Try It! to start a request and see the response here!