{"uid":"cap_iNgvhr5otlL43aeesPW4u","slug":"x402-tools-token-price-symbol-coingecko-id-62e00641","name":"x402 tools – Token Price (Symbol/CoinGecko ID)","description":"Use to price a crypto portfolio or watchlist in one call. Market data for up to 50 symbols or 250 CoinGecko ids: price, 1h/24h/7d/30d change, 24h high/low, volume, market cap, rank, FDV, supply, and distance from all-time high/low; optional 7-day sparkline. One flat price per call; not charged if nothing is found.","url":"https://x402-tools-production-2755.up.railway.app/tools/token-price?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","properties":{"id":{"type":"string","description":"One CoinGecko id; returns a single object instead of a list"},"vs":{"type":"string","description":"Quote currency, default usd"},"ids":{"type":"string","description":"Comma-separated CoinGecko ids, up to 250, e.g. bitcoin,ethereum"},"symbol":{"type":"string","description":"One ticker; returns a single object instead of a list"},"symbols":{"type":"string","description":"Comma-separated tickers, up to 50, e.g. BTC,ETH,SOL. Each resolves to the largest coin with that ticker"},"sparkline":{"enum":["true","false"],"type":"string","description":"Include 7 days of hourly prices per token"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"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_Gc1y131Y60OrnspXiGQlQ","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":"Fetches real-time market data (price, changes, volume, market cap, supply, ATH/ATL distance, optional sparkline) for up to 50 ticker symbols or 250 CoinGecko IDs in a single call.","exampleAgentPrompt":"Can you pull the current prices, 24h and 7d changes, market caps, and volume for BTC, ETH, SOL, and AVAX — and also include the 7-day sparkline so I can see the trend?","exampleUseCases":[{"title":"Crypto portfolio snapshot","prompt":"Give me a full market data snapshot for my portfolio — BTC, ETH, SOL, MATIC, and AVAX — including current price in USD, 24h and 7d change, market cap, and how far each is from its all-time high."},{"title":"Watchlist alert check","prompt":"Check the 1h and 24h price changes for these tickers: LINK, DOT, ATOM, NEAR, and FTM — I want to know if any of them moved more than 5% so I can decide whether to act."},{"title":"Research report for top altcoins","prompt":"Pull detailed stats for ethereum, solana, and avalanche-2 using their CoinGecko IDs — I need price, FDV, circulating supply, 30-day change, and the 7-day sparkline for a research report."}],"resultDescription":"Returns a list of market data objects, one per requested token, each containing: current price in the requested quote currency, percentage changes over 1h/24h/7d/30d, 24h high and low, 24h trading volume, market capitalization, market cap rank, fully diluted valuation, circulating and total supply, distance from all-time high and all-time low, and optionally a 7-day array of hourly prices (sparkline). If a single symbol or id is queried, returns a single object instead of a list. Nothing is returned (and the call is not charged) if no matching tokens are found.","failureModes":["Symbol not found or ambiguous ticker resolves to wrong coin — no result returned, no charge","CoinGecko ID misspelled or invalid — token silently omitted from response","Exceeding 50 symbols or 250 CoinGecko IDs — request may be truncated or rejected","Upstream CoinGecko rate limit or outage — may return stale or empty data","Quote currency not supported — defaults to USD or returns error"],"whenToPreferThis":"Prefer this endpoint when you need to price a portfolio or watchlist of well-known tokens by ticker symbol or CoinGecko ID, especially when you want rich metadata (ATH/ATL distance, FDV, supply, multi-period changes) in a single call. It is the right choice for batch pricing of up to 50 symbols or 250 CoinGecko IDs. If you need to price long-tail or newly listed tokens by contract address that may not have a CoinGecko listing, use the contract-address pricing sibling endpoint instead.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T18:37:07.699Z","isFirstParty":false,"canonicalSlug":"x402-tools-token-price-symbol-coingecko-id-62e00641"}