Skip to main content
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

TBD

Supported Chains

  • BASE_MAINNET
  • SOLANA_MAINNET
  • BSC_MAINNET
  • ETH_MAINNET
  • MONAD_MAINNET
This query is currently in Beta. It is stable for testing and evaluation but may undergo changes in schema or behavior as we continue to improve it. No API credits are currently charged.We welcome your feedback so please reach out to us directly to report issues or request features.

​
Parameters

ParameterTypeRequiredDescription
querystringYesFree-form search string that matches token names or ticker symbols (case-insensitive) or token or pair contract address

​
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).

​
Basic Query

query {
  searchToken(query: "skitten") {
    pair_address
    chain
    quote_rate_usd
    volume_usd
    market_cap
  }
}

​
Complete Query

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

​
Response Format

Here’s an example of the response data structure: 
{
  "data": {
    "searchToken": [
      {
        "pair_address": "0xa46d5090499efb9c5dd7d95f7ca69f996b9fb761",
        "chain": "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

FieldTypeDescription
pair_addressstringLiquidity pool contract that backs the result token/quote pair
chainenumThe blockchain network where the token was created
quote_ratefloatExchange rate between base and quote tokens
quote_rate_usdfloatUSD value of the quote rate
volumefloat24h trading volume for the pair in quote token units
volume_usdfloat24h trading volume in USD.
market_capfloatEstimated market capitalization in USD for the base token
base_tokenobjectMetadata for the searched token, including address, decimals, name, and ticker symbol
quote_tokenobjectMetadata for the paired quote asset