{"uid":"cap_eDfEXUoFQ5vMpzaRaMAuH","slug":"brainiac-token-due-diligence-liquidity-9af2a43a","name":"BRAINIAC Token Due Diligence — Liquidity","description":"Inspect supported DEX liquidity pools on Base Mainnet using official Uniswap V2 and V3 factories.","url":"https://www.brainiac.software/api/v1/token-due-diligence/liquidity?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"tokenAddress":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"}}},"responseSchema":{"type":"json","example":{"status":"partial","chainId":8453,"sources":[{"url":"https://mainnet.base.org","source":"Base JSON-RPC","retrievedAt":"2026-10-29T12:00:00.000Z"},{"url":"https://api.llama.fi/prices/current","source":"DeFiLlama","retrievedAt":"2026-10-29T12:00:00.000Z"}],"liquidity":{"pools":[{"type":"V2","price":5000,"token0":"0x4200000000000000000000000000000000000006","token1":"0x833589fcd6edb6e08f4c7c32d4f71b54bdA02913","address":"0x1234567890123456789012345678901234567890","reserve0":"100000000000000000000","reserve1":"500000000000","quoteToken":"0x4200000000000000000000000000000000000006","token0Amount":100,"token0Symbol":"WETH","token1Amount":500000,"token1Symbol":"USDC","liquidityValueUsd":1250000}],"priceUsd":1,"poolCount":1,"supportedPools":true},"result_id":"a1b2c3d4e5f60718293a4b5c6d7e8f90","limitations":["Liquidity inspection is limited to official Uniswap V2 and V3 factories.","Only WETH and native USDC quote tokens are checked.","…"],"received_at":"2026-11-12T12:00:00.000Z","retrievedAt":"2026-10-29T12:00:00.000Z","tokenAddress":"0x833589fcd6edb6e08f4c7c32d4f71b54bdA02913","missing_items":[{"check":"defillama_unavailable","detail":"DeFiLlama valuation was unavailable. Pool reserves below still stand.","reason":"upstream_down"}]}},"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_iZB-LwhTwPNIWliBVHcyC","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 on-chain liquidity data for a Base network token, including Uniswap V2/V3 pool details, reserves, price, and USD liquidity value","exampleAgentPrompt":"Can you check the on-chain liquidity for the token at address 0x833589fcd6edb6e08f4c7c32d4f71b54bdA02913 on Base — I want to see the Uniswap pool details, reserves, and total USD liquidity value before I consider trading it.","exampleUseCases":[{"title":"Pre-trade liquidity check for new token","prompt":"Before I buy into this token at 0x4ed4e862860bed51a9570b96d89af5e1b0ebebc4, can you pull its Uniswap liquidity data on Base so I can see the pool depth and USD value locked?"},{"title":"Token due diligence for DeFi research","prompt":"I'm researching whether 0x940181a94a35a4569e4529a3cdfb74e38fd98631 is safe to invest in — can you check how much liquidity it actually has on Uniswap V2 and V3 on Base?"},{"title":"Automated liquidity alert for portfolio monitor","prompt":"For the token at 0x50c5725949a6f0c72e6c4a641f24049a917db0cb on Base, fetch the current Uniswap pool reserves and USD liquidity so I can decide whether to flag it as low-liquidity in my watchlist."}],"resultDescription":"A JSON object containing the chain ID (8453 for Base), a list of Uniswap V2/V3 pools with their addresses, reserve amounts, token symbols, pair types, and USD liquidity value; the token's current USD price from DeFiLlama; total pool count; data retrieval timestamps; source URLs; and a limitations notice clarifying that only official Uniswap V2/V3 factories and WETH/USDC quote tokens are covered.","failureModes":["Invalid token address format (must be 0x-prefixed 40 hex characters) returns validation error","Token not found in any Uniswap V2/V3 pool on Base returns empty pools array with supportedPools: false","Token exists but uses unsupported quote tokens (non-WETH, non-USDC) may return incomplete pool data","Upstream RPC or DeFiLlama outage may cause partial or failed response","Token on a non-Base chain will not be found as the endpoint is Base-only (chainId 8453)"],"whenToPreferThis":"Use this endpoint when you need on-chain liquidity data specifically for ERC-20 tokens on the Base network via Uniswap V2/V3. It is purpose-built for token due diligence workflows and returns structured pool-level data including reserves, prices, and USD liquidity values sourced directly from Base JSON-RPC and DeFiLlama. Prefer this over generic DeFi APIs when you need a focused, per-token liquidity snapshot on Base without cross-chain noise.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-17T07:01:38.236Z","isFirstParty":false,"canonicalSlug":"brainiac-token-due-diligence-liquidity-9af2a43a"}