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" }'

Live request: this will call https://api.merkl.xyz/ for real.