{"uid":"cap_z2TAFYtLi25uNU0w2jxya","slug":"dexl-agents-token-liquidity-lookup-9a155cad","name":"DexL Agents Token Liquidity Lookup","description":"Read a token's DEX pair straight from the chain: pair address, both reserves, the implied price, LP total supply and how much of that LP sits in burn addresses. Base, Arbitrum and BNB Chain, Uniswap V2-style factories against the wrapped native token. Read-only eth_call, no API key. The answer states its own limits: no pair here does not mean no liquidity, because V3, other DEXes and non-native quote pairs are not covered.","url":"https://agents.dexl.io/v1/tools/token-liquidity","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"chain":{"enum":["base","arbitrum","bsc","robinhood"],"type":"string","default":"base","description":"Which chain the token lives on."},"token":{"type":"string","description":"ERC-20 contract address (0x...)."}}},"responseSchema":{"type":"json","example":{"units":1,"cached":false,"output":{}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_N7yiFyUA32JPU2qPTYo0W","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns liquidity data for a given ERC-20 token contract address on a specified EVM chain","exampleAgentPrompt":"What's the liquidity for the token at 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 on Base?","exampleUseCases":[{"title":"Pre-swap liquidity check","prompt":"Before I swap, can you check the liquidity for the token at 0x6B175474E89094C44Da98b954EedeAC495271d0F on Arbitrum? I want to know if there's enough depth to execute a large trade."},{"title":"DeFi portfolio risk assessment","prompt":"I'm considering adding 0x2260FAC5E5542a773Aa44fBCfeDf7C193bc2C599 on BSC to my portfolio — can you pull its liquidity data so I can gauge the risk?"},{"title":"New token vetting on Base","prompt":"I just heard about a new token at 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 on Base — can you check its liquidity to see if it's legit or super thin?"}],"resultDescription":"Returns a JSON object containing liquidity metrics for the specified ERC-20 token on the chosen chain, along with cache status and unit count. The output field contains the actual liquidity data (depth, pool info, or related metrics).","failureModes":["Invalid or non-existent contract address returns empty or error output","Chain not supported beyond the four enum values (base, arbitrum, bsc, robinhood) causes rejection","Token exists but has zero or negligible liquidity, returning empty output object","Payment failure via x402 prevents request from being processed","Network or RPC issues on the target chain may cause timeouts"],"whenToPreferThis":"Use this endpoint when you need fast, pay-per-call liquidity data for a specific ERC-20 token on Base, Arbitrum, BSC, or Robinhood chain without setting up API keys or accounts. It is ideal for AI agents that need to assess token tradability, screen new tokens, or enrich DeFi decision-making with on-chain liquidity signals on a per-request basis.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:42:04.420Z","isFirstParty":false}