search_tokens
Read · No sign-in
Search tokens across all chains
Finds 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, which chainKey and token.address tell apart, and a token.copycat block marks a token that imitates a better-known one. Without q it lists 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",
"bnb",
"avax",
"robinhood",
"solana"
],
"type": "string"
},
"claimedAfter": {
"description": "Registered (`crown.mintTimestamp`) on or after this time (ISO 8601, or `YYYY-MM-DD`).",
"type": "string"
},
"claimedBefore": {
"description": "Registered on or before this time.",
"type": "string"
},
"createdAfter": {
"description": "`token.createdAt` on or after this time (ISO 8601, or `YYYY-MM-DD`).",
"type": "string"
},
"createdBefore": {
"description": "`token.createdAt` on or before this time.",
"type": "string"
},
"creatorRecord": {
"description": "Keep coins by their creator's record. `first_launch` keeps first launches, `on_record` creators who launched before, `no_serial` hides creators whose launches mostly stopped trading, `identified` keeps creators who proved an identity (an X account, or Coinbase's verification).",
"enum": [
"first_launch",
"on_record",
"no_serial",
"identified"
],
"type": "string"
},
"crownsOnly": {
"default": false,
"description": "Only tokens that have a registration.",
"type": "boolean"
},
"deployedAfter": {
"description": "`token.deployedAt` on or after this time (ISO 8601, or `YYYY-MM-DD`).",
"type": "string"
},
"deployedBefore": {
"description": "`token.deployedAt` on or before this time.",
"type": "string"
},
"exact": {
"default": false,
"description": "Only exact ticker matches, without fuzzy expansion (PEPE but not PEPE2). Ignored for an address.",
"type": "boolean"
},
"include": {
"description": "`apps` attaches the apps installed on each result's token page.",
"enum": [
"apps"
],
"type": "string"
},
"includeInactive": {
"default": false,
"description": "Also return results normally hidden for low quality or inactivity.",
"type": "boolean"
},
"maxHolders": {
"description": "At most this many holders.",
"minimum": 0,
"type": "integer"
},
"maxLiquidity": {
"description": "Liquidity at most this, in USD.",
"minimum": 0,
"type": "number"
},
"maxMarketCap": {
"description": "Market cap at most this, in USD.",
"minimum": 0,
"type": "number"
},
"maxVolume": {
"description": "24-hour volume at most this, in USD.",
"minimum": 0,
"type": "number"
},
"minHolders": {
"description": "At least this many holders.",
"minimum": 0,
"type": "integer"
},
"minLiquidity": {
"description": "Liquidity at least this, in USD.",
"minimum": 0,
"type": "number"
},
"minMarketCap": {
"description": "Market cap at least this, in USD.",
"minimum": 0,
"type": "number"
},
"minVolume": {
"description": "24-hour volume at least this, in USD.",
"minimum": 0,
"type": "number"
},
"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"
},
"refresh": {
"default": false,
"description": "Skip cached results, so a token created or registered a moment ago is found.",
"type": "boolean"
},
"sort": {
"description": "Sort key, case-insensitive. Defaults to `relevance` with a query and `createdat` (newest first) when browsing. An unknown key falls back to the default.",
"enum": [
"relevance",
"market_cap",
"volume",
"liquidity",
"holders",
"price",
"pricechange1h",
"pricechange6h",
"pricechange24h",
"txns24h",
"age",
"createdat",
"deployedat",
"claimedat",
"heartbeatscore",
"tokenrank",
"name"
],
"type": "string"
},
"status": {
"description": "Only results with this registration status: `registered` (any registration), `unregistered`, or one status value (`claimed`, `grace_period`, `inactive`, `unclaimed`, `available`).",
"type": "string"
}
},
"type": "object"
}Example
A tools/call request:
json
{
"name": "search_tokens",
"arguments": {}
}