{"uid":"cap_ezEGQaw5ZZH-N7RSYkTDH","slug":"signals-edge-report-token-price-lookup-98de6928","name":"signals.edge.report Token Price Lookup","description":"Token price lookup: USD price, market cap, and volume by CoinGecko id or Base ERC20 contract address. Use for spot token price checks.","url":"https://signals.edge.report/v1/token","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","required":["id"],"properties":{"id":{"type":"string","description":"CoinGecko token id (e.g. ethereum) or Base ERC20 contract address"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"query":"ethereum","source":"coingecko","priceUsd":3000,"marketCapUsd":360000000000,"volume24hUsd":15000000000}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_cDRO1qrFW53J7TLxzGOUh","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns USD price, market cap, and 24h volume for a crypto token by CoinGecko ID or Base ERC20 contract address.","exampleAgentPrompt":"What's the current USD price, market cap, and 24h volume for Ethereum — you can use its CoinGecko ID 'ethereum'?","exampleUseCases":[{"title":"Spot price check for trading bot","prompt":"What's the current USD price and 24-hour trading volume for Uniswap? Use its CoinGecko ID 'uniswap'."},{"title":"Base ERC20 token valuation","prompt":"Can you pull the USD price and market cap for the Base token at contract address 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913?"},{"title":"Portfolio value snapshot","prompt":"I need the current USD prices and market caps for Bitcoin and Ethereum — use CoinGecko IDs 'bitcoin' and 'ethereum' — so I can calculate my portfolio value."}],"resultDescription":"Returns a JSON object containing the token's current USD price, market capitalization, and 24-hour trading volume, sourced from CoinGecko data. The response is keyed to the queried token identifier.","failureModes":["Invalid or unrecognized CoinGecko ID returns an error or empty result","Unsupported or non-Base ERC20 contract address fails to resolve","CoinGecko upstream outage causes stale or missing data","Rate limiting or payment failure returns a 402 Payment Required error","Malformed contract address format causes query rejection"],"whenToPreferThis":"Choose this endpoint when you need a quick, cheap ($0.001 USDC) spot price check for a single token by CoinGecko ID or Base ERC20 contract address, and you need USD price, market cap, and volume in one call. Prefer this over generic DeFi bundles when you only need price data and not funding rates, gas fees, or wallet balances.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:30:45.856Z","isFirstParty":false}