Token Search Query

This GraphQL query lets you discover actively traded tokens that match a keyword or ticker symbol. Each result includes pricing, volume marketcap, and base/quote metadata. Use it to build comprehensive token search features.

Credit Cost

1 per call

Supported Chains

• BASE_MAINNET
• BSC_MAINNET
• ETH_MAINNET
• MEGAETH_MAINNET
• MONAD_MAINNET
• POLYGON_MAINNET
• ROBINHOOD_MAINNET
• SOLANA_MAINNET

Estimate your monthly cost for this API using the Pricing Calculator.

Parameters

query · string · required

Search query string - can be token name, symbol, or address. Empty string returns all tokens.

chain_name · enum

Optional chain filter. When provided, only tokens on this chain are returned.

Type: ChainName

Query

You can query the searchToken endpoint with:

• Free text (e.g. "skitten")
• Token contract address (e.g. 0x4B6104755AfB5Da4581B81C552DA3A25608c73B8)
• Token pair address (e.g. 0xa46d5090499eFB9c5dD7d95F7ca69F996b9Fb761)

The response is sorted in descending order by volume (in USD).

query {
  searchToken(
    query: "skitten"
    chain_name: BASE_MAINNET
  ) {
    volume
    chain_name
    base_token {
      contract_name
      contract_address
      contract_decimals
      contract_ticker_symbol
    }
    swap_count
    market_cap
    quote_rate
    volume_usd
    quote_token {
      contract_name
      contract_address
      contract_decimals
      contract_ticker_symbol
    }
    quote_rate_usd
    pair_address
  }
}

Response Format

Here’s an example of the response data structure:

{
  "data": {
    "searchToken": [
      {
        "pair_address": "0xa46d5090499efb9c5dd7d95f7ca69f996b9fb761",
        "chain_name": "BASE_MAINNET",
        "quote_rate": 2.3637041719e-7,
        "quote_rate_usd": 0.0007961152019156508,
        "volume": 19888966.385959223,
        "volume_usd": 15833.908490251517,
        "market_cap": 786165.7030043972,
        "base_token": {
          "contract_name": "Ski Mask Kitten",
          "contract_ticker_symbol": "SKITTEN",
          "contract_address": "0x4b6104755afb5da4581b81c552da3a25608c73b8",
          "contract_decimals": 18
        },
        "quote_token": {
          "contract_name": "Wrapped Ether",
          "contract_ticker_symbol": "WETH",
          "contract_address": "0x4200000000000000000000000000000000000006",
          "contract_decimals": 18
        }
      }
    ]
  }
}

Field Descriptions

volume · float

24h trading volume for the pair in quote token units

chain_name · enum

The blockchain network where the token was created

Type: ChainName

base_token · object

Metadata for the searched token, including address, decimals, name, and ticker symbol

Type: TokenContractMetadata

Show properties

contract_name · string

Name of the token contract

contract_address · string

Address of the token contract

contract_decimals · int

Number of decimal places for the token

contract_ticker_symbol · string

Ticker symbol of the token

swap_count · string

Number of swaps in the tracking period

market_cap · float

Estimated market capitalization in USD for the base token

quote_rate · float

Exchange rate between base and quote tokens

volume_usd · float

24h trading volume in USD

quote_token · object

Metadata for the paired quote asset

Type: TokenContractMetadata

Show properties

contract_name · string

Name of the token contract

contract_address · string

Address of the token contract

contract_decimals · int

Number of decimal places for the token

contract_ticker_symbol · string

Ticker symbol of the token

quote_rate_usd · float

USD value of the quote rate

pair_address · string

Liquidity pool contract that backs the result token/quote pair