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
  • BSC_MAINNET
  • ETH_MAINNET
  • MEGAETH_MAINNET
  • MONAD_MAINNET
  • POLYGON_MAINNET
  • SOLANA_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

​
query
string
required
Free-form search string that matches token names or ticker symbols (case-insensitive) or token or pair contract address
​
chain_name
enum
Filter results to a specific chain.Available values: BASE_MAINNET, BSC_MAINNET, ETH_MAINNET, HYPERCORE_MAINNET, HYPEREVM_MAINNET, MEGAETH_MAINNET, MONAD_MAINNET, POLYGON_MAINNET, SOLANA_MAINNET

​
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_name
    quote_rate_usd
    volume_usd
    market_cap
  }
}

​
Complete Query

query {
  searchToken(query: "skitten", chain_name: BASE_MAINNET) {
    pair_address
    chain_name
    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_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

​
pair_address
string
Liquidity pool contract that backs the result token/quote pair
​
chain_name
enum
The blockchain network where the token was created
​
quote_rate
float
Exchange rate between base and quote tokens
​
quote_rate_usd
float
USD value of the quote rate
​
volume
float
24h trading volume for the pair in quote token units
​
volume_usd
float
24h trading volume in USD.
​
market_cap
float
Estimated market capitalization in USD for the base token
​
base_token
object
Metadata for the searched token, including address, decimals, name, and ticker symbol
​
quote_token
object
Metadata for the paired quote asset