dexscreener_get_pairs_by_chain_and_address
Get every Dexscreener-indexed liquidity pair for a token, restricted to a single chain. Hits `GET /token-pairs/v1/{chainId}/{tokenAddress}`. Returns `{ schemaVersion, pairs: Pair[] }`. Use this when the chain is known — it is faster and cheaper than `dexscreener_get_token_pairs`, which scans every chain Dexscreener indexes. For a chain-agnostic lookup, use `dexscreener_get_token_pairs`; for a batch of up to 30 tokens on the same chain, use `dexscreener_get_tokens_by_chain_and_addresses`.
Get every Dexscreener-indexed liquidity pair for a token, restricted to a single chain. Hits GET /token-pairs/v1/{chainId}/{tokenAddress}.
Endpoint
GET /token-pairs/v1/{chainId}/{tokenAddress}
Input
The tool takes a single JSON object. Every field, its type, and an example are on the generated reference at GET /mcp/tools, under this tool's name.
Calling it
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": { "name": "dexscreener_get_pairs_by_chain_and_address", "arguments": {} }
}Put your arguments in place of the empty object. A call that fails comes back as a normal result carrying isError: true and a message naming what went wrong, not as a JSON-RPC protocol error.
Notes
Returns { schemaVersion, pairs: Pair[] }. Use this when the chain is known — it is faster and cheaper than dexscreener_get_token_pairs, which scans every chain Dexscreener indexes. For a chain-agnostic lookup, use dexscreener_get_token_pairs; for a batch of up to 30 tokens on the same chain, use dexscreener_get_tokens_by_chain_and_addresses.
The full request and response shape, and a live playground, live on the generated reference at GET /mcp/tools.
dexscreener_search_pairs
Search Dexscreener for pairs by free-text query. Hits `GET /latest/dex/search?q=...`. Returns `{ schemaVersion, pairs: Pair[] }` — the array is sorted by Dexscreener's relevance scoring. Use this to resolve a name, symbol, or address to the active liquidity pairs. For a token address where the chain is unknown, prefer `dexscreener_get_token_pairs` (a direct lookup).
dexscreener_get_tokens_by_chain_and_addresses
Get Dexscreener-indexed pairs for up to 30 token addresses on the same chain, in one request. Hits `GET /tokens/v1/{chainId}/{tokenAddresses}` (addresses joined with `,`). Returns `{ schemaVersion, pairs: Pair[] }` — the array contains the union of every pair the addresses share, so a token that has multiple pairs will contribute several rows. Use this to fan out a portfolio or a watchlist of tokens in a single round-trip. For a single token, prefer `dexscreener_get_pairs_by_chain_and_address`; for a chain-agnostic lookup, use `dexscreener_get_token_pairs`.