{"uid":"cap_zx8IWR78W-qDYqijtQLKS","slug":"defi-oracle-token-liquidity-lookup-abd996af","name":"DeFi Oracle Token Liquidity Lookup","description":"DeFi data for AI agents — yield rates, swap routes, IL calculator, liquidation risk, MEV scanner, TVL tracking. Powered by DeFiLlama + on-chain RPC data. Pay with USDC on Base via x402.","url":"https://aracil.vercel.app/api/token-liquidity","method":"POST","headers":{},"bodySchema":{"type":"object","required":["symbol"],"properties":{"chain":{"type":"string"},"symbol":{"type":"string","description":"Token symbol"}}},"responseSchema":{"type":"object","properties":{"chain":{"type":"string"},"pools":{"type":"array"},"token":{"type":"string"},"pool_count":{"type":"number"},"total_liquidity_usd":{"type":"number"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","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.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_mS0X-MLfobnAvLCxIzDsx","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns liquidity pool data for a given token symbol, including total USD liquidity, pool count, and individual pool details across DeFi protocols.","exampleAgentPrompt":"Can you check the liquidity pools for WETH on Base — I want to know how many pools exist and what the total liquidity in USD looks like before I plan a large swap?","exampleUseCases":[{"title":"Pre-swap slippage risk check","prompt":"Before I swap 500k USDC worth of ARB, can you look up how many liquidity pools exist for ARB and what the total USD liquidity is? I want to make sure I won't get crushed by slippage."},{"title":"Token liquidity research for new listing","prompt":"I'm evaluating whether to list OP on our platform — can you pull all the liquidity pool data for OP on Optimism, including how many pools there are and the total liquidity in USD?"},{"title":"Cross-chain liquidity comparison","prompt":"Can you check the liquidity pool count and total USD liquidity for USDC on Ethereum versus Base? I need to decide which chain to route a large institutional trade through."}],"resultDescription":"Returns a JSON object containing the token symbol, chain, total liquidity in USD, pool count, and an array of individual pool details sourced from DeFiLlama and on-chain RPC data.","failureModes":["Unknown or unsupported token symbol returns empty pools array or error","Chain parameter mismatch results in no matching pools found","DeFiLlama data unavailable or stale during outage windows","Very new or obscure tokens may have zero indexed pools","Missing required 'symbol' field returns a validation error"],"whenToPreferThis":"Use this endpoint when you need to assess token liquidity depth across DeFi pools before executing swaps, routing trades, or evaluating market risk. It is particularly valuable for agents doing pre-trade due diligence, TVL monitoring, or liquidity-aware routing decisions. Prefer this over generic price feeds when pool-level granularity (pool count, per-pool breakdown) matters.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:35:19.703Z","isFirstParty":false}