Skip to content

get_token ​

Read · No sign-in

Get a token by ticker on one chain

The leading token with this ticker on one chain: market data (price, market cap, liquidity, holders), links, and its registration if it has one (hasCrown, registration.owner). When several tokens share a ticker on a chain, this returns the registered one if there is one, else the largest; pass tokenAddress to name the contract you mean, and use search_tokens to see every token with the ticker.

Reads or changesReads only
Sign-inNo
CallsGET /api/v2/token/{symbol}/{chain} (API Explorer)

Input ​

JSON Schema, as the server serves it.

json
{
  "additionalProperties": false,
  "properties": {
    "chain": {
      "description": "Chain key identifier",
      "enum": [
        "eth",
        "arbitrum",
        "arbitrum-sepolia",
        "base",
        "polygon",
        "bnb",
        "avax",
        "robinhood",
        "solana",
        "solana-devnet"
      ],
      "examples": [
        "arbitrum"
      ],
      "type": "string"
    },
    "symbol": {
      "description": "Token ticker, e.g. PEPE (case-insensitive).",
      "examples": [
        "PEPE"
      ],
      "type": "string"
    },
    "tokenAddress": {
      "description": "The token's contract address (or Solana mint), when the chain has several tokens with this ticker.",
      "type": "string"
    }
  },
  "required": [
    "chain",
    "symbol"
  ],
  "type": "object"
}

Example ​

A tools/call request:

json
{
  "name": "get_token",
  "arguments": {
    "chain": "arbitrum",
    "symbol": "PEPE"
  }
}

All MCP tools · Connect an AI app