{"uid":"cap_UGA--pGd-sFQqrYQn2nOa","slug":"agentdiet-token-liquidity-lookup-be278928","name":"AgentDiet Token Liquidity Lookup","description":"Deterministic B2A/A2A/MCP/x402/MPP/L402 execution and intelligence node at https://mcp-gateway.agentdiet.dev settling in USDC on Base.","url":"https://mcp-gateway.agentdiet.dev/v1/token-liquidity?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","POST"],"type":"string"},"queryParams":{"type":"object","properties":{"token":{"type":"string"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"data":{},"status":"ok","roi_proof":{"compression_ratio_pct":91.4}}},"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_57yUrIjhCSYe2OTrmyU8g","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 specified token via the AgentDiet MCP Gateway broker network.","exampleAgentPrompt":"Can you check the current liquidity data for the token with symbol USDC on the AgentDiet broker gateway and tell me if it's sufficiently liquid for a swap?","exampleUseCases":[{"title":"Pre-swap liquidity check for DeFi agent","prompt":"Before I execute a swap, check the liquidity for the ETH token on AgentDiet and tell me if there's enough depth to make it worthwhile."},{"title":"Portfolio liquidity monitoring","prompt":"Pull the liquidity stats for CBETH from the AgentDiet token liquidity endpoint so I can decide whether to rebalance my portfolio today."},{"title":"Token research for trading bot","prompt":"I'm building a trading strategy — can you fetch the liquidity data for DEGEN token from AgentDiet's broker to see if it's viable for automated trading?"}],"resultDescription":"Returns a JSON object with a status field ('ok'), a data object containing token liquidity details, and an roi_proof object including a compression_ratio_pct value indicating data efficiency.","failureModes":["Missing or invalid token query parameter returns empty or error data","Token not found in broker registry returns empty data object","Payment not settled in USDC results in 402 Payment Required response","Malformed input schema (missing required 'type' or 'method' fields) causes request rejection","Network or gateway downtime returns 5xx errors"],"whenToPreferThis":"Choose this endpoint when you need token liquidity data within an x402/USDC-payment-enabled agent workflow on Base, particularly when routing through a broker that aggregates MCP servers and x402 APIs. Prefer it over direct DEX queries when you need a single payable endpoint that abstracts multiple liquidity sources.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-22T12:42:32.905Z","isFirstParty":false,"canonicalSlug":"agentdiet-token-liquidity-lookup-be278928"}