{"uid":"cap_1VVVUDR8YXD4LfpCJTvAd","slug":"agentoracle-spot-price-by-ticker-3ac1d84c","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/: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":["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":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_osk7qHl08qT08lhw11dCI","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 in USD for a single cryptocurrency token identified by its ticker symbol, with a minimal payload optimized for high-frequency polling.","exampleAgentPrompt":"What's the current spot price of ETH in USD right now?","exampleUseCases":[{"title":"Real-time trading bot price feed","prompt":"Keep checking the current price of BTC every few seconds and alert me when it drops below $60,000."},{"title":"Portfolio value snapshot","prompt":"What are the current USD prices for ETH, SOL, and MATIC so I can calculate the total value of my portfolio?"},{"title":"DeFi arbitrage price check","prompt":"Quick — what's the latest spot price for PEPE right now? I need it before deciding whether to execute this swap."}],"resultDescription":"A minimal JSON object containing three fields: the normalized ticker symbol (e.g. 'ETH'), the current spot price in USD as a number (or null if unavailable), and an ISO 8601 timestamp indicating when the price was recorded (asOf). Returns HTTP 404 for unrecognized token symbols.","failureModes":["Unknown or unsupported token symbol returns HTTP 404","Payment not included or insufficient returns HTTP 402","Network or upstream data source outage may cause delayed or stale prices","Malformed symbol strings may return 404 rather than a validation error","priceUsd may be null if the price feed is temporarily unavailable for that token"],"whenToPreferThis":"Prefer this endpoint when you need a single token's latest spot price with minimal overhead and low latency — ideal for high-frequency polling agents, trading bots, or any scenario where a compact payload matters. If you need price history, multiple tokens at once, or additional metadata like market cap, use sibling endpoints instead.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:34:03.131Z","isFirstParty":false}