post

/v4/tokens/whitelist

Submit a token whitelist request for review.

Request body

object
explainerstring
required
Short explanation of the token to add.
addressstring
required
Token address in checksum format.
chainIdnumber | string
required
Chain ID of the network where the token is deployed.
iconUrlstringPublicly accessible HTTPS URL for the token icon. Mutually exclusive with iconFile.
iconFileobject
datastring
required
Base64-encoded icon file bytes (max 1 MB raw).
mimeTypestring
required
Image MIME type (e.g. image/png).
filenamestring
required
Original filename (e.g. token.svg).
protocolNamestring
required
Name of the protocol submitting the request.
requesterTypeenum
required
Whether the requester submits as an individual or a company. Required.individualcompany
companyNamestringCompany name — required when requesterType is 'company'.
telegramHandlestring
required
Telegram handle to notify once the token is whitelisted.
displaySymbolstringOverride symbol shown in the UI. Defaults to on-chain symbol.
coingeckoApiIdstringCoinGecko API ID for price sourcing and APR/TVL calculation.
tokenNamestringToken name, resolved client-side.
tokenSymbolstringToken symbol, resolved client-side.
post
https://api.merkl.xyz/v4/tokens/whitelist
Merkl API
curl -X POST "https://api.merkl.xyz/v4/tokens/whitelist" \
  -H "Content-Type: application/json" \
  -d '{ "explainer": "string", "address": "string", "chainId": 0, "iconUrl": "string", "iconFile": { "data": "string", "mimeType": "string", "filename": "string" }, "protocolName": "string", "requesterType": "individual", "companyName": "string", "telegramHandle": "string", "displaySymbol": "string", "coingeckoApiId": "string", "tokenName": "string", "tokenSymbol": "string" }'
Current params
{
  "body": {
    "explainer": "string",
    "address": "string",
    "chainId": 0,
    "iconUrl": "string",
    "iconFile": {
      "data": "string",
      "mimeType": "string",
      "filename": "string"
    },
    "protocolName": "string",
    "requesterType": "individual",
    "companyName": "string",
    "telegramHandle": "string",
    "displaySymbol": "string",
    "coingeckoApiId": "string",
    "tokenName": "string",
    "tokenSymbol": "string"
  }
}
Live request — this will call https://api.merkl.xyz/ for real.