{"uid":"cap_Hmp6rPx0WxlhlK6TfsjfB","slug":"pre-trade-token-check-aebaed95","name":"Pre-Trade Token Check","description":"Wallet balances, tokens, transactions and prices on Base, Ethereum and Solana. Other Tollkit tools are described at: https://extract.tollkit.dev/openapi.json, https://attest.tollkit.dev/openapi.json, https://web.tollkit.dev/openapi.json, https://data.tollkit.dev/openapi.json.","url":"https://chain.tollkit.dev/chain/pretrade?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"chain":{"enum":["base","ethereum","solana"],"type":"string","default":"base","description":"Which chain to read: \"base\" (default), \"ethereum\" or \"solana\"."},"token":{"type":"string","pattern":"^(0x[0-9a-fA-F]{40}|[1-9A-HJ-NP-Za-km-z]{32,44})$","description":"ERC-20 contract or SPL mint."},"wallet":{"type":"string","pattern":"^(0x[0-9a-fA-F]{40}|[1-9A-HJ-NP-Za-km-z]{32,44})$","description":"Optional: your wallet, to see your current holding."},"amount_usd":{"type":"number","description":"Optional: planned trade size in USD.","exclusiveMinimum":0}}},"responseSchema":{"type":"json","example":{"name":"Jupiter","note":"Facts read from the chain and the web, not a rating or advice. No warnings does not mean safe.","chain":"solana","token":"JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN","symbol":"JUP","decimals":6,"position":null,"warnings":[],"news_note":"Top web results for the token's name and symbol; titles and links as published.","price_usd":0.336803,"checked_at":"2026-10-05T08:43:25.149Z","trade_size":{"flag":"ok","amount_usd":500,"pool_depth_usd":407369,"share_of_pool_pct":0.12,"rough_price_impact_pct":0.12},"recent_news":[{"url":"https://thedefiant.io/news/defi/jupiter-token-spikes-as-dex-aggregator-plans-to-spend-half-its-fees-on-buybacks","date":null,"title":"Jupiter Token Spikes as DEX Aggregator Plans to Spend Half its Fees On Buybacks","snippet":null},{"url":"https://www.theblock.co/amp/post/337071/jupiter-spikes-40-as-founder-says-50-of-fees-will-go-to-token-buybacks","date":null,"title":"Jupiter spikes 40% as founder says 50% of fees will go to token buybacks","snippet":null}],"explorer_url":"https://solscan.io/token/JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN","price_source":{"dex":"Orca Whirlpools","pool":"C1MgLojNLWBKADvu9BHdtgzz1oZX4dZ5zGdGcgvvW8Wz","fee_tier":500,"quote_token":"SOL","tick_spacing":8},"total_supply":"6861486339.419214","warning_count":0,"mint_authority":null,"pool_depth_usd":407369,"freeze_authority":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_d_KBoohoJIa77TeOljSmE","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":"Fetches on-chain token facts, current price, wallet position, pool depth, and trade impact estimate before executing a trade on Base, Ethereum, or Solana.","exampleAgentPrompt":"Before I buy $500 worth of JUP on Solana using wallet 9xQe...abc, can you check the token at JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN — I want to see the current price, any warnings, pool depth, and how much price impact that trade size would have?","exampleUseCases":[{"title":"DeFi rug pull risk check","prompt":"Before I ape into this new token on Base at 0x1234...abcd, can you check if it has mint authority, freeze authority, or any other red flags? I'm planning to spend $1000."},{"title":"Liquidity depth before large swap","prompt":"I want to swap $5000 worth of this Ethereum token at 0xA0b8...EeC7 — can you check the pool depth and tell me what price impact I should expect?"},{"title":"Portfolio position review before rebalancing","prompt":"Check my current holding of the token at 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 on Base for my wallet 0xabc...123, and give me the current price and any warnings before I decide whether to sell."}],"resultDescription":"Returns a JSON object with the token's name, symbol, decimals, current USD price, total supply, mint and freeze authority status, pool depth in USD, a trade size analysis (flag, price impact percentage, share of pool), your wallet's current position if provided, a list of warnings, a warning count, recent news headlines with URLs, a note that data is factual not advisory, the explorer URL, and the price source details (DEX, pool, fee tier, quote token).","failureModes":["Invalid token contract address format returns validation error","Token not found on specified chain returns empty or error response","Wallet address provided but has no position returns null position","Very illiquid token may have no pool depth data","Unsupported chain value returns enum validation error","Network timeouts or RPC errors may cause partial data","Payment failure (x402) results in 402 response before data is returned"],"whenToPreferThis":"Use this endpoint when an agent needs a comprehensive pre-trade snapshot for a specific token — combining price, pool depth, trade impact, wallet position, on-chain safety signals (mint/freeze authority), and recent news in a single call. Prefer this over the Token Safety Check endpoint when you also need trade sizing analysis and pool depth, and over the Token Info endpoint when you need wallet-specific position data and impact estimation. Ideal for DeFi trading agents that need a go/no-go data bundle before executing a swap.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T12:35:10.083Z","isFirstParty":false,"canonicalSlug":"pre-trade-token-check-aebaed95"}