Skip to content

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 changesReads only
Sign-inNo
CallsGET /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": {}
}

All MCP tools · Connect an AI app