{"uid":"cap_BNk8fPqZWxfLr8Nf-D12h","slug":"aiagentoracle-ai-8a336ae7","name":"AgentOracle Spot Price by Ticker","description":"AgentOracle: latest spot price for a single token by ticker symbol — minimal payload (`{ symbol, priceUsd, asOf }`) optimised for high-frequency polling agents. Case-insensitive symbol; returns 404 for unknown symbols.","url":"https://aiagentoracle.ai/api/v1/price/BTC","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":["symbol","priceUsd","asOf"],"properties":{"asOf":{"type":"string","format":"date-time"},"symbol":{"type":"string"},"priceUsd":{"type":["number","null"],"description":"Spot price in USD."}}}}}}},"responseSchema":null,"example":{"request":{"input":{"type":"http","method":"GET","pathParams":{"symbol":"BTC"}}},"response":{"asOf":"2026-05-29T04:43:14.198Z","symbol":"BTC","priceUsd":73303}},"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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_NinhaxaKnwpdIdo8b99ef","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 the latest spot price for a single cryptocurrency token by ticker symbol as a minimal JSON payload optimized for high-frequency polling.","exampleAgentPrompt":"What's the current spot price of BTC in USD right now? Just give me the price and when it was last updated.","exampleUseCases":null,"resultDescription":"A minimal JSON object containing three fields: the token symbol (e.g. 'BTC'), the current spot price in USD as a number (priceUsd), and an ISO 8601 timestamp (asOf) indicating when the price was recorded. Returns 404 if the symbol is unknown.","failureModes":["404 Not Found: symbol is not tracked by AgentOracle — verify the ticker is a supported on-chain token","Invalid path param: symbol segment missing from URL path","Stale data: asOf timestamp may lag real-time market by a short ingestion delay","Service unavailable: AgentOracle health endpoint may indicate ingestion issues"],"whenToPreferThis":"Choose this endpoint when you need the absolute minimal payload for a single token's spot price and are running high-frequency polling loops where bandwidth and latency matter. Ideal for trading bots and monitoring agents that only need the current USD price and a freshness timestamp, without needing full token metadata or historical data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:43:22.635Z","isFirstParty":false}