{"uid":"cap_jzFsntdPlSpa0t4B8_UFu","slug":"curvecall-token-market-snapshot-31954c03","name":"CurveCall Token Market Snapshot","description":"Token market snapshot","url":"https://curvecall.onrender.com/v1/token/base/0x4200000000000000000000000000000000000006?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"input":{"type":"object","properties":{"pathParams":{"chain":{"type":"string","required":true,"description":"Dexscreener chain id, e.g. base, solana, ethereum"},"address":{"type":"string","required":true,"description":"Token contract address"}},"queryParams":{}}},"output":{"type":"object","properties":{"example":{"chain":"base","symbol":"TEST","address":"0x...","fdv_usd":10000000,"top_pair":{"dex":"uniswap"},"price_usd":0.01,"pair_count":2,"liquidity_usd":120000,"txns_24h_buys":120,"pair_age_hours":30.5,"txns_24h_sells":80,"volume_24h_usd":5000}}}}},"responseSchema":null,"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_rvnuYnQ789A0zW6WoH33_","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 real-time market snapshot for a token on a given chain, including price, FDV, liquidity, 24h volume, buy/sell transactions, and top trading pair data sourced from DEX aggregators.","exampleAgentPrompt":"What's the current market snapshot for the WETH token at 0x4200000000000000000000000000000000000006 on Base — give me price, liquidity, FDV, and today's buy/sell counts.","exampleUseCases":[{"title":"Pre-trade token due diligence","prompt":"Before I swap into this token at 0x4200000000000000000000000000000000000006 on Base, can you pull up its current price, liquidity depth, and how many buys and sells it's had in the last 24 hours?"},{"title":"DeFi portfolio market check","prompt":"I hold a position in a token at address 0x4200000000000000000000000000000000000006 on Ethereum — what does the market snapshot look like right now? I want FDV, volume, and which DEX is handling most of the trading."},{"title":"Token activity monitoring for a bot","prompt":"Check the market snapshot for the Solana token at address So11111111111111111111111111111111111111112 — I need to know if 24h volume is above $500k and whether buys are outpacing sells before my bot executes."}],"resultDescription":"A JSON object containing the token's chain, symbol, contract address, current USD price, fully diluted valuation in USD, total liquidity in USD, 24-hour volume in USD, 24-hour buy and sell transaction counts, number of trading pairs, the top DEX pair name, and the age of the primary pair in hours.","failureModes":["Unknown or unlisted token contract address returns empty or error response","Unsupported chain ID causes a 404 or validation error","Token exists but has no active DEX pairs — may return null liquidity/volume fields","Rate limiting or payment failure (x402) if USDC balance is insufficient","Render.com cold-start latency may cause occasional slow or failed responses"],"whenToPreferThis":"Use this endpoint when you need a fast, single-call market snapshot for a specific token contract address on a supported chain, especially when you want DEX-level data like liquidity, pair age, and buy/sell pressure rather than just price. Prefer this over broader market APIs when your agent is already working with on-chain DeFi data and needs enrichment at the token level. It is particularly useful when combined with the sibling risk-screen or bonding-curve endpoints from the same CurveCall suite.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T18:31:58.567Z","isFirstParty":false,"canonicalSlug":"curvecall-token-market-snapshot-31954c03"}