{"uid":"cap_qmcAEvamTIODm9cXdlmjl","slug":"curvecall-token-precheck-6e060cda","name":"CurveCall Token Precheck","description":"Pay-per-call market math and token intel for AI agents, via x402.","url":"https://curvecall.onrender.com/v1/precheck/%7Bchain%7D/%7Baddress%7D?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":{"side":{"enum":["buy","sell"],"type":"string","default":"buy","required":false},"fee_bps":{"type":"number","default":100,"required":false},"amount_in":{"type":"number","required":false,"description":"Amount to trade (quote-token units for buys, token units for sells)"}}}},"output":{"type":"object","properties":{"example":{"risk":{"flags":[],"risk_label":"medium","risk_score":45},"chain":"base","quote":{"side":"buy","amount_in":0.5,"amount_out":5136,"amount_in_unit":"WETH","amount_out_unit":"TEST","price_impact_pct":2.39},"market":{"price_usd":0.01,"liquidity_usd":120000},"symbol":"TEST","address":"0x...","verdict":"caution","warnings":[],"disclaimer":"Not financial advice."}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_eaR0R6TitMbVqcRNcWFFI","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns on-chain market math, price impact, and risk assessment for a token trade on a given chain","exampleAgentPrompt":"Before I swap 0.5 ETH into the token at 0x4e84... on Base, can you run a precheck — I want to see the price impact, how much token I'd get out, and whether it's flagged as risky?","exampleUseCases":[{"title":"Pre-trade risk check on new token","prompt":"I'm about to ape into this new Base token at 0xabc123... — can you check it first and tell me the risk score, any red flags, and what verdict the market math gives before I pull the trigger?"},{"title":"Simulate sell impact for large position","prompt":"I hold 50000 units of the token at 0xdef456... on Ethereum and want to sell — how much price impact will that cause with a 1% fee, and what do I actually get out in the quote token?"},{"title":"Agent pre-swap safety gate","prompt":"Before my trading agent executes any swap, run a precheck on the Solana token at address So11...1112 with a buy side and 0.25 SOL in — only proceed if the risk label comes back low and price impact is under 3%."}],"resultDescription":"Returns a JSON object containing: a trade quote (amount in/out with units, price impact %), market data (USD price, liquidity), a risk assessment (score 0-100, label, flags), a verdict string (e.g. 'caution'), any warnings, and a disclaimer. The verdict summarizes whether the trade looks safe to proceed.","failureModes":["Invalid or unsupported chain ID returns an error — use Dexscreener-compatible IDs like 'base', 'solana', 'ethereum'","Unknown or unindexed token contract address may return no market data","Insufficient liquidity for the requested amount_in may produce extreme price impact values","Payment failure via x402 protocol blocks the call before execution","Malformed address format returns a validation error"],"whenToPreferThis":"Use CurveCall's precheck endpoint when an AI agent needs to gate a token swap on risk and price-impact math before execution — especially in autonomous trading workflows where you want a structured risk verdict (score, label, flags) alongside a trade quote in a single call. Prefer this over generic DEX aggregator APIs when you need the risk assessment bundled with the quote, and over static token scanners when you need live price-impact simulation for a specific trade size.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T06:33:39.661Z","isFirstParty":false,"canonicalSlug":"curvecall-token-precheck-6e060cda"}