get

/v4/tokens/wrappers

List every Merkl token wrapper a creator distributes, one entry per wrapper and distribution chain, live campaigns first. Wrappers are discovered through the campaigns that distribute them, so a wrapper deployed but never used in a campaign is not returned. Only static data is served here — read the holder, balances and allowance from chain.

Query parameters

creatorIdstring
creatorAddressstring

Responses

200
Response for status 200
Schema
object[]
distributionChainIdnumberChain the wrapper is deployed on, i.e. where its campaigns distribute rewards.
wrapperobjectToken
idstring
required
Unique identifier for the token
namestring | null
required
Full name of the token
chainIdinteger
required
Chain Id
addressstring
required
Address
decimalsnumber
required
Number of decimals for the token
symbolstring
required
Symbol of the token
iconstring
required
URL to the token icon image
verifiedboolean
required
Whether the token is verified
isNativeboolean
required
Whether this is a native blockchain token
isTestboolean
required
Whether this is a test token
typeenum
required
Type of the token (TOKEN, PRETGE, POINT)TOKENPRETGEPOINT
pricenumber | nullCurrent price of the token in USD
updatedAtnumber | nullUnix timestamp of last price update
priceSourcestring | nullSource of the price information
displaySymbolstringCustom display symbol override
underlyingTokenIdstringIf this token is a wrapper, the ID of the underlying token
priceAlertDismissedAtnumber
priceAlertCountnumber
underlyingobject | nullToken the wrapper pays out on claim, when Merkl resolved it. Null when unknown.
idstringUnique identifier for the token
namestring | nullFull name of the token
chainIdintegerChain Id
addressstringAddress
decimalsnumberNumber of decimals for the token
symbolstringSymbol of the token
iconstringURL to the token icon image
verifiedbooleanWhether the token is verified
isNativebooleanWhether this is a native blockchain token
isTestbooleanWhether this is a test token
typeenumType of the token (TOKEN, PRETGE, POINT)TOKENPRETGEPOINT
pricenumber | nullCurrent price of the token in USD
updatedAtnumber | nullUnix timestamp of last price update
priceSourcestring | nullSource of the price information
displaySymbolstringCustom display symbol override
underlyingTokenIdstringIf this token is a wrapper, the ID of the underlying token
priceAlertDismissedAtnumber
priceAlertCountnumber
campaignCountnumberMother campaigns of this creator distributing the wrapper.
liveCampaignCountnumberSubset of `campaignCount` currently running.
lastCampaignEndTimestampnumberEnd timestamp (unix seconds) of the latest campaign distributing the wrapper.
Example
[
  {
    "distributionChainId": 0,
    "wrapper": {
      "id": "string",
      "name": "string",
      "chainId": 0,
      "address": "string",
      "decimals": 0,
      "symbol": "string",
      "icon": "string",
      "verified": false,
      "isNative": false,
      "isTest": false,
      "type": "TOKEN",
      "price": 0,
      "updatedAt": 0,
      "priceSource": "string",
      "displaySymbol": "string",
      "underlyingTokenId": "string",
      "priceAlertDismissedAt": 0,
      "priceAlertCount": 0
    },
    "underlying": {
      "id": "string",
      "name": "string",
      "chainId": 0,
      "address": "string",
      "decimals": 0,
      "symbol": "string",
      "icon": "string",
      "verified": false,
      "isNative": false,
      "isTest": false,
      "type": "TOKEN",
      "price": 0,
      "updatedAt": 0,
      "priceSource": "string",
      "displaySymbol": "string",
      "underlyingTokenId": "string",
      "priceAlertDismissedAt": 0,
      "priceAlertCount": 0
    },
    "campaignCount": 0,
    "liveCampaignCount": 0,
    "lastCampaignEndTimestamp": 0
  }
]
get
https://api.merkl.xyz/v4/tokens/wrappers
Merkl API
curl -X GET "https://api.merkl.xyz/v4/tokens/wrappers"