{"name":"onyx_base_dex_pair_lookup","tier":"metered","price_usdc":"0.0015","endpoint":"https://onyx-actions.onrender.com/v1/onyx_base_dex_pair_lookup","method":"POST","input_schema":{"type":"object","properties":{"token_address":{"type":"string","description":"Token contract address on Base mainnet (0x...)."},"limit":{"type":"integer","minimum":1,"maximum":30,"default":10,"description":"Max pairs to return (sorted by liquidity desc)."}},"required":["token_address"]},"description":"Every DEX pair for a Base token: DEX name, price USD, 24h volume, liquidity USD, price-change percentages (5m/1h/6h/24h), pool fees. Sorted by liquidity. Backed by DexScreener (free). Use to find where a token is actually trading before routing a swap or assessing rug risk via volume/liquidity ratios.","when_to_use":"Before swapping any Base ERC-20, check where the token actually trades. Tokens with low total liquidity → high slippage. Tokens with sky-high volume:liquidity ratios → possible wash trading.","vs_alternatives":"Web DexScreener UI is browse-only. CoinGecko has API but rate-limited and slower data. DexScreener API is real-time, no auth, no rate limit.","example_request":{"token_address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","limit":5},"example_response":null,"settle_to":"0x3fD9ee1373562f894D322B37DFFAd7a5D2b2d78f","network":"base","facilitator":"https://facilitator.xpay.sh","payment_required":true,"free_introspection":true,"note":"GET this URL = free introspection card. POST with x402 payment header to call."}