{"uid":"cap_b5sN_EAfeQGjZjCizuxWR","slug":"onchainpulse-dex-liquidity-snapshot-ceed2052","name":"OnchainPulse DEX Liquidity Snapshot","description":"Token liquidity and momentum snapshot, half a cent: live DEX liquidity in USD, price, market cap, pair age, 1h/24h volume, buy-vs-sell transaction ratio, price change — the raw DexScreener read for any EVM token, one source, no fusion. Base, Ethereum, BSC, Arbitrum, Polygon, Optimism, Avalanche. Cheapest pre-trade depth check; upgrade to /api/evmtoken ($0.015) for the fused safety verdict or /api/exit-depth for sell-impact modeling.","url":"https://onchainpulse.theaslangroupllc.com/api/facet/liquidity","method":"GET","headers":{},"bodySchema":{"type":"object","required":["address"],"properties":{"chain":{"type":"string","description":"EVM chain (default base) — base, ethereum, bsc, arbitrum, polygon, optimism, avalanche"},"address":{"type":"string","description":"ERC-20 token contract address (0x + 40 hex)"}}},"responseSchema":{"type":"json","example":{"dex":"uniswap","chain":"base","source":"dexscreener","volume":{"h1":310000,"h24":6100000},"address":"0x532f27101965dd16442E59d40670FaF5eBB142E4","txns_h1":{"buys":420,"sells":318},"upgrade":{"full_scan":"/api/evmtoken — $0.015 fused safety verdict","exit_depth":"/api/exit-depth — sell-impact modeling"},"pair_url":"https://dexscreener.com/base/0x…","price_usd":0.0842,"market_cap":812000000,"pair_found":true,"price_change":{"h1":2.1,"h24":-1.4},"liquidity_usd":4200000,"pair_age_hours":9600,"buy_sell_ratio_h1":1.32}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_BltWp0owzzhOohXaDsgQ9","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a live DEX liquidity and momentum snapshot for any EVM token, including USD liquidity, price, market cap, pair age, 1h/24h volume, buy/sell ratio, and price change — sourced directly from DexScreener.","exampleAgentPrompt":"Before I buy this token — contract address 0xabc123... on Base — can you pull a live DEX liquidity snapshot showing the current price, market cap, total liquidity in USD, buy vs sell ratio, and how the price has moved in the last 24 hours?","exampleUseCases":[{"title":"Pre-trade liquidity check on Base","prompt":"I'm about to ape into this Base token at 0x1234abcd... — can you quickly check its current DEX liquidity in USD, 24h volume, and buy/sell transaction ratio so I know if it has enough depth before I put money in?"},{"title":"Momentum scan for Arbitrum token","prompt":"Pull the latest DexScreener snapshot for this Arbitrum token 0xdeadbeef... — I want to see the price, 1h and 24h volume, price change, and how old the trading pair is."},{"title":"Market cap and pair age lookup on Ethereum","prompt":"What's the current market cap, price, and pair age for this Ethereum token 0x7a250d5... on DEX? Also show me the buy vs sell ratio from the last 24 hours."}],"resultDescription":"Returns a real-time snapshot of DEX market data for the requested EVM token, including: live USD liquidity depth, current token price, market cap, trading pair age, 1-hour and 24-hour volume, buy-to-sell transaction count ratio, and recent price change percentage — all sourced from DexScreener with no data fusion or safety scoring applied.","failureModes":["Token address not found on the specified chain — returns empty or error response","Token exists but has no active DEX pair — liquidity data unavailable","Unsupported chain provided — only Base, Ethereum, BSC, Arbitrum, Polygon, Optimism, Avalanche are supported","DexScreener upstream outage — stale or missing data","Malformed token address — request validation error","Very new token with insufficient trading history — pair age and volume fields may be zero or null"],"whenToPreferThis":"Choose this endpoint when you need a cheap ($0.005), fast, raw DexScreener liquidity read for a single EVM token on supported chains — ideal as a pre-trade depth check before committing capital. Prefer this over /api/evmtoken ($0.015) when you only need market data and do not need the fused safety/honeypot verdict. Use /api/exit-depth instead if you specifically need sell-impact modeling for large exits.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:52:04.112Z","isFirstParty":false}