Search API

Two reads: GET /api/v2/search finds tokens by ticker, name or contract address on every supported chain, and GET /api/v2/token/{symbol}/{chain} returns one. Both need only an API key. Every parameter and response field is in the API Explorer under Search; this page covers what to do with the answer.

Search

curl -H "X-API-Key: $CHAINDADDY_API_KEY" \
  "https://api.chaindaddy.io/api/v2/search?q=FLUXGP&chain=base&exact=true"

{
  "success": true,
  "query": "FLUXGP",
  "searchMode": "symbol",
  "results": [
    {
      "type": "crown",
      "chainId": 8453,
      "chainKey": "base",
      "chainName": "Base",
      "token": { "address": "0x931fce21ddea0549db70324f44ee2db1cb9f7f22", "symbol": "FLUXGP", "name": "Flux GP", "marketCap": 30017.38, "holders": 12 },
      "crown": { "status": "claimed", "owner": "0x2ca75898788f3aad05e7e4ff247f3db13456b0b4", "tokenId": 8 },
      "hasCrown": true,
      "listed": true
    }
  ],
  "page": 1,
  "pageSize": 25,
  "totalResults": 1,
  "totalPages": 1,
  "sort": "relevance"
}

Reading a result

• A ticker is not unique. One symbol usually matches several unrelated tokens. Tell them apart by chainKey and token.address, never by symbol alone, and treat a token.copycat block as a warning that the token imitates a better-known one.
• type says whether the token is registered. crown: a wallet proved it controls the token, and crown.owner holds the registration. token: the token exists and nobody has registered it. available: no token with that ticker on that chain.
• crown.status is claimed, grace_period (newly registered) or inactive (lapsed; see Coin Health) for a registered token, and unclaimed or available otherwise. On GET /api/v2/token/{symbol}/{chain} the same object is named registration.
• listed: false results did not clear the site's quality bar; they come last. includeInactive=true also returns results that are normally left out for low quality or inactivity.
• No q browses the newest tokens instead, on one chain with chain.

Recipes

Is a ticker free to register on Base? Ask for exact matches there and look for a registration:

curl -H "X-API-Key: $CHAINDADDY_API_KEY" \
  "https://api.chaindaddy.io/api/v2/search?q=MYTKN&chain=base&exact=true&status=registered"
# "totalResults": 0  -> nobody holds it on Base

Just created or registered a token and it is missing? Results are cached for up to a minute. Add refresh=true once.

Paging through everything: raise page until it equals totalPages; pageSize goes up to 100.

Errors

400 names the bad parameter (q over 64 characters, page below 1, a range filter that is not a number, a date that is not ISO 8601). 404 on /token/{symbol}/{chain} means no token with that ticker on that chain. 401 and 429 are covered in Authentication.