{"uid":"cap_XHhFkDaYaSwNJ-kWWO0qg","slug":"token-dex-liquidity-snapshot-change-monitor-b52c50b6","name":"Token DEX Liquidity Snapshot & Change Monitor","description":"Snapshot of a token's DEX pool liquidity now (DexScreener, deepest pair and every pair's USD liquidity). Stateless: pass the liquidityUsd you saved last time as previousLiquidityUsd and it returns the % change and a DROP/DRAIN flag. It keeps no history itself and does not show lock expiry dates.","url":"https://api.fadeandco.workers.dev/api/agent-intel/token-liquidity-migration-watch?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"],"type":"string"},"queryParams":{"type":"object","required":["address"],"properties":{"chain":{"type":"string","description":"base, ethereum, bsc, arbitrum, polygon or solana (default base)"},"address":{"type":"string","description":"Token contract or mint address"},"previousLiquidityUsd":{"type":"string","description":"Optional: the deepest-pool liquidityUsd from your previous call"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"note":"Stateless snapshot. Liquidity changes between your calls only; there is no lock-expiry data.","alert":"STABLE","chain":"base","pools":[{"dex":"aerodrome","pair":"0x6cDcb1C4A4D1C3C6d054b27AC5B77e89eAFb971d","liquidityUsd":11490316},{"dex":"uniswap","pair":"0xc19d91d99afc0332e5013a569c9721cd9ecb51a14c851f7a189a140950a627fa","liquidityUsd":2468943}],"source":"https://api.dexscreener.com/token-pairs/v1/base/0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","checkedAt":"2026-10-23T09:35:18.118Z","changePercent":7560.21,"deepestLiquidityUsd":11490316,"previousLiquidityUsd":150000}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_ogcr-UCcNF9302q5KjDFl","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a real-time snapshot of a token's DEX pool liquidity across all pairs, optionally computing % change and a DROP/DRAIN alert flag vs. a previously saved liquidity value.","exampleAgentPrompt":"Check the current DEX pool liquidity for token 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 on Base — my last recorded deepest-pool liquidity was $11,490,316, so tell me the percent change and whether there's a DROP or DRAIN alert.","exampleUseCases":[{"title":"Rug pull early warning for new token","prompt":"Monitor the liquidity for token 0xabc123... on Ethereum — last time I checked it was $500,000, so flag any DROP or DRAIN if it's moved significantly since then."},{"title":"Pre-trade liquidity safety check","prompt":"Before I swap into this token at 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 on Base, can you pull the current DEX pool liquidity and show me which pool is deepest and how much USD liquidity is in each?"},{"title":"Automated liquidity watchdog for DeFi portfolio","prompt":"Check the current liquidity for my Solana token at mint address So11111111111111111111111111111111111111112 — my last saved deepest-pool liquidity was $2,000,000, so let me know the percent change and if anything looks like a drain."}],"resultDescription":"Returns a JSON object with: the deepest pool's current USD liquidity, a list of all DEX pools with their pair addresses and USD liquidity, a % change vs. the previousLiquidityUsd you supplied, a DROP/DRAIN/STABLE alert flag, the source DexScreener URL, the chain and token address, and a timestamp. Does not include lock expiry dates or historical data beyond the single comparison point you pass in.","failureModes":["Token address not found on DexScreener — returns empty pools array","Unsupported chain value — may return error or empty result","No liquidity data available for very new or low-volume tokens","previousLiquidityUsd not passed — changePercent and alert still computed but relative to zero","Network timeout from DexScreener upstream — intermittent failures possible"],"whenToPreferThis":"Use this endpoint when you need a real-time, stateless liquidity snapshot for a specific token across all its DEX pools, especially when you want to detect liquidity drain or rug-pull signals by comparing to a previously saved value. Prefer this over on-chain RPC calls when you want aggregated multi-DEX coverage via DexScreener without managing your own data pipeline. Not suitable if you need historical liquidity time-series or lock expiry data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T00:34:01.468Z","isFirstParty":false,"canonicalSlug":"token-dex-liquidity-snapshot-change-monitor-b52c50b6"}