{"uid":"cap__BB5ksaGjETk02sQ5ivxK","slug":"agentoracle-token-snapshot-by-symbol-26e2710a","name":"AgentOracle Token Snapshot by Symbol","description":"AgentOracle: lookup a single on-chain crypto token by ticker symbol (case-insensitive, e.g. ETH, BTC, SOL). Returns the full price / volume / liquidity / market-cap snapshot, or 404 if the symbol is unknown.","url":"https://aiagentoracle.ai/api/v1/token/:symbol","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"},"pathParams":{"type":"object","required":["symbol"],"properties":{"symbol":{"type":"string","description":"Uppercase ticker symbol, e.g. ETH, BTC, SOL."}}},"queryParams":{"type":"object","properties":{}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["id","symbol","name","chain","lastUpdated"],"properties":{"id":{"type":"integer","description":"Internal numeric identifier."},"name":{"type":"string"},"chain":{"type":"string","description":"EVM chain slug (e.g. base, ethereum, arbitrum)."},"symbol":{"type":"string","description":"Uppercase ticker symbol, e.g. ETH."},"imageUrl":{"type":["string","null"],"format":"uri"},"priceUsd":{"type":["number","null"],"description":"Spot price in USD."},"marketCap":{"type":["number","null"],"description":"Fully-diluted market cap in USD."},"volume24h":{"type":["number","null"],"description":"Trailing 24h trading volume in USD."},"lastUpdated":{"type":"string","format":"date-time"},"liquidityUsd":{"type":["number","null"],"description":"On-chain pool liquidity in USD."},"confidenceScore":{"type":["number","null"],"description":"Source-quality score, 0..1."},"priceChange24hPercent":{"type":["number","null"],"description":"24h price change, percent (-100..+inf)."}}}}}}},"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_tbLFc-POotHTjAJkeZL5Y","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":"Looks up a single on-chain crypto token by ticker symbol and returns a full price, volume, liquidity, and market-cap snapshot.","exampleAgentPrompt":"What's the current price, 24h volume, market cap, and on-chain liquidity for SOL right now?","exampleUseCases":[{"title":"Real-time price check before trade","prompt":"Before I buy, what's the current USD price, 24h change, and on-chain liquidity for PEPE right now?"},{"title":"Portfolio valuation snapshot","prompt":"Can you pull the full token snapshot for ETH — price, market cap, and volume — so I can update my portfolio dashboard?"},{"title":"DeFi liquidity research","prompt":"I'm researching ARB for a liquidity pool — what's its current on-chain liquidity, 24h trading volume, and confidence score?"}],"resultDescription":"Returns a JSON object containing the token's internal ID, ticker symbol, name, EVM chain slug, spot price in USD, fully-diluted market cap, 24h trading volume, on-chain pool liquidity, 24h price change percent, a source-quality confidence score (0–1), token image URL, and a last-updated timestamp. Returns 404 if the symbol is not found.","failureModes":["404 Not Found if the ticker symbol is unknown or not indexed","Symbol disambiguation issues when multiple tokens share the same ticker across chains","Stale data if the token has not been recently updated (check lastUpdated field)","Null fields for price, volume, liquidity, or market cap if data is unavailable for that token","Case sensitivity issues (though the API is documented as case-insensitive)"],"whenToPreferThis":"Choose this endpoint when you need a comprehensive single-token snapshot including price, market cap, volume, liquidity, and chain metadata in one call. Prefer this over the minimal price endpoint when you need multiple data dimensions simultaneously. Use this instead of listing endpoints when you already know the specific ticker symbol. Best suited for token research, pre-trade checks, and portfolio enrichment workflows.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-16T00:42:40.640Z","isFirstParty":false}