{"category":"crypto-context","description":"Returns the top liquidity pair for a token (or a specific pair) from DexScreener with GeckoTerminal as backup: price, liquidity, 24h volume, FDV/market cap, pair age, transaction counts, and a DEX link.","guardrails":["EVM chains only","top pair by liquidity when a token is given"],"inputExample":{"chain":"base","tokenAddress":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913"},"method":"POST","outputFields":["pairAddress","priceUsd","liquidityUsd","volume24hUsd","fdvUsd","pairCreatedAt","txns24h","url"],"path":"/services/pool-snapshot","payment":{"devMode":false,"enforced":true,"network":"eip155:84532","protocol":"x402"},"price":"$0.01","priceUsd":0.01,"pricingNote":"Free public market data; priced for aggregation and caching value.","providers":[{"docsUrl":"https://docs.dexscreener.com/api/reference","label":"DexScreener","name":"dexscreener","role":"primary"},{"docsUrl":"https://www.geckoterminal.com/dex-api","label":"GeckoTerminal","name":"geckoterminal","role":"fallback"}],"slug":"pool-snapshot","summary":"Price, liquidity, volume, and pair metadata for a token or pair.","tags":["dex","liquidity","price","market-data"],"title":"Pool & Liquidity Snapshot","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"chain":{"type":"string","enum":["arbitrum","base","bsc","ethereum","optimism","polygon"]},"chainId":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"pairAddress":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"},"tokenAddress":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"}}}}