{"uid":"cap_4yjs8rf9T4-St2iYlEYOG","slug":"defi-oracle-token-liquidity-lookup-9fc2e0d2","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://oraclius.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_B0-qGiSqLB3DuFpKSwIyC","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 liquidity in USD, pool count, and pool details across chains","exampleAgentPrompt":"Can you check the on-chain liquidity for USDC on Ethereum — I want to see how many pools there are and the total liquidity in USD before I make a swap decision?","exampleUseCases":null,"resultDescription":"Returns an 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","Invalid chain name may return no results or error","Token with no DeFi pools returns zero pool_count and zero total_liquidity_usd","Rate limiting or upstream DeFiLlama API downtime causes 5xx errors","Payment failure via x402/USDC on Base blocks request before processing"],"whenToPreferThis":"Use this endpoint when you need on-chain liquidity depth data for a specific token — especially useful before executing swaps to assess slippage risk, or when evaluating a token's DeFi ecosystem health by pool count and TVL. Prefer over generic price feeds when pool-level granularity matters.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:31:39.875Z","isFirstParty":false}