{"uid":"cap_isNL5IF4237Yquh3c9DsS","slug":"dopaminedesk-pool-liquidity-lookup-d7141f53","name":"DopamineDesk Pool Liquidity Lookup","description":"Fetch live pair price, liquidity, volume, and price-change fields for a DEX pool address from DexScreener.","url":"https://ai-data-marketplace-1042299154756.us-central1.run.app/api/v1/pool_liquidity","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"],"type":"string"},"queryParams":{"type":"object","required":["pool_address"],"properties":{"chain":{"type":"string","description":"DexScreener chain id, for example base or ethereum. Defaults to ethereum."},"pool_address":{"type":"string","description":"DEX pair contract address to look up."}},"additionalProperties":true}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["success","source","fetched_at","count","pairs","marketplace_metadata"],"properties":{"count":{"type":"integer"},"pairs":{"type":"array","items":{"type":"string"}},"source":{"type":"string"},"success":{"type":"boolean"},"fetched_at":{"type":"string"},"marketplace_metadata":{"type":"object","required":["data_mode","billable","availability","source"],"properties":{"source":{"type":"string"},"billable":{"type":"boolean"},"data_mode":{"type":"string"},"availability":{"type":"string"}},"additionalProperties":true}},"additionalProperties":true}}}}},"responseSchema":{"type":"json","example":{"count":1,"pairs":["[nested detail omitted from the challenge header; see the full example in /openapi.json]"],"source":"DexScreener pair API","success":true,"fetched_at":"2026-08-07T07:32:32.117Z","marketplace_metadata":{"source":"DexScreener pair API","billable":true,"data_mode":"live_source","availability":"operational"}}},"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_-r55Vzleh7Ge860uPShO0","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 real-time DEX liquidity pool data including token symbols, reserves, and total value locked (TVL) for a given pair contract address.","exampleAgentPrompt":"Can you look up the current liquidity and TVL for the DEX pool at address 0x88e6...abc on Base? I want to see the token reserves and how much total value is locked.","exampleUseCases":[{"title":"Pre-trade liquidity depth check","prompt":"Before I swap a large amount of USDC for WETH, can you check how deep the liquidity is in the USDC/WETH pool at 0x88e6A0c2dDD26FEEb64F039a2c41296FcB3f5640 on Ethereum? I need the reserve amounts and TVL."},{"title":"DeFi portfolio due diligence","prompt":"I'm considering adding liquidity to a pool on Base. Can you pull up the current reserves and TVL for the pool contract at 0xd0b53D9277642d899DF5C87A3966A349A798F224 on Base so I can assess the depth?"},{"title":"Arbitrage opportunity scouting","prompt":"Check the reserve balances and TVL for the pool at 0x4e68Ccd3E89f51C3074ca5072bbAC773960dFa36 on Ethereum — I want to know how much WETH and USDC are sitting in it right now."}],"resultDescription":"Returns a JSON object with the pool contract address, the two token symbols (token0_symbol, token1_symbol), their respective reserve amounts (reserve0, reserve1), and the total value locked in USD (tvl_usd). Example output shows a USDC/WETH pool with $300M TVL.","failureModes":["Invalid or non-existent pool_address returns an error or empty result","Unsupported chain id causes a lookup failure","Pool exists but has zero liquidity, returning zeroed reserve fields","Rate limiting or payment failure (x402) blocks the request","Stale or delayed on-chain data may cause TVL to lag actual state"],"whenToPreferThis":"Use this endpoint when you need quick, structured liquidity data for a specific DEX pair contract — particularly reserve depths and TVL — without building your own on-chain RPC calls. It is well-suited for pre-trade slippage estimation, due diligence on new pools, or feeding liquidity metrics into a DeFi agent workflow. Prefer it over raw RPC calls when you want normalized output (USD TVL, token symbols) with minimal integration overhead and pay-per-use pricing.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T12:51:31.306Z","isFirstParty":false}