Skip to main content

Documentation Index

Fetch the complete documentation index at: https://goldrush.dev/docs/llms.txt

Use this file to discover all available pages before exploring further.

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
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 createdType: ChainName
​
base_token
object
Metadata for the searched token, including address, decimals, name, and ticker symbolType: TokenContractMetadata
​
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 assetType: TokenContractMetadata
​
quote_rate_usd
float
USD value of the quote rate
​
pair_address
string
Liquidity pool contract that backs the result token/quote pair