search_tokens
Read · No sign-in
Search tokens across all chains
Find tokens by ticker, name or contract address on every supported chain, ranked by relevance, with live market data. A result whose type is crown has a registration: its creator proved control of it on Chain Daddy, and crown.owner is the wallet holding it. A ticker is not unique: one symbol usually matches several unrelated tokens on different chains, so tell them apart by chainKey and token.address, never by symbol alone, and read a token.copycat block as a warning that the token imitates a better-known one. Leave q out to browse the newest tokens, on one chain with chain.
| Reads or changes | Reads only |
| Sign-in | No |
| Calls | GET /api/v2/search (API Explorer) |
Input
JSON Schema, as the server serves it.
json
{
"additionalProperties": false,
"properties": {
"chain": {
"description": "Only results on this chain.",
"enum": [
"eth",
"base",
"arbitrum",
"polygon",
"bnb",
"avax",
"robinhood",
"solana"
],
"type": "string"
},
"crownsOnly": {
"default": false,
"description": "Only tokens that have a registration.",
"type": "boolean"
},
"exact": {
"default": false,
"description": "Only exact ticker matches, without fuzzy expansion (PEPE but not PEPE2). Ignored for an address.",
"type": "boolean"
},
"order": {
"default": "desc",
"enum": [
"asc",
"desc"
],
"type": "string"
},
"page": {
"default": 1,
"description": "Page number, from 1.",
"minimum": 1,
"type": "integer"
},
"pageSize": {
"default": 25,
"description": "Results per page.",
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"q": {
"description": "A ticker (PEPE), a token name, or a contract address (an EVM 0x address or a Solana mint). Up to 64 characters.",
"examples": [
"PEPE"
],
"maxLength": 64,
"type": "string"
},
"sort": {
"description": "Sort key. Defaults to `relevance` with a query and `createdat` (newest first) when browsing.",
"enum": [
"relevance",
"market_cap",
"volume",
"liquidity",
"holders",
"price",
"pricechange24h",
"createdat",
"heartbeatscore",
"name"
],
"type": "string"
}
},
"type": "object"
}Example
A tools/call request:
json
{
"name": "search_tokens",
"arguments": {}
}