{"uid":"cap_qS-HsUJEU3yjFbCSsyOnF","slug":"agentoracle-asset-assessment-25bab11e","name":"AgentOracle Asset Assessment","description":"AgentOracle: assess a tracked asset before an autonomous transaction — market-data quality, freshness, liquidity, volatility, confidence, and whether it is directly spendable through x402 on Base or must be converted first. Informational and non-custodial.","url":"https://aiagentoracle.ai/api/v1/asset/ETH/assessment","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":"Tracked asset ticker symbol."}},"additionalProperties":false},"queryParams":{"type":"object","properties":{}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["symbol","name","chain","priceUsd","quality","confidenceScore","freshness","marketSignals","spendability","rationale","limitations"],"properties":{"name":{"type":"string"},"chain":{"type":"string"},"symbol":{"type":"string"},"quality":{"enum":["high","medium","low","insufficient-data"],"type":"string"},"priceUsd":{"type":["number","null"]},"freshness":{"type":"object","required":["asOf","ageSeconds","status"],"properties":{"asOf":{"type":"string","format":"date-time"},"status":{"enum":["fresh","stale"],"type":"string"},"ageSeconds":{"type":"integer","minimum":0}}},"rationale":{"type":"array","items":{"type":"string"}},"limitations":{"type":"array","items":{"type":"string"}},"spendability":{"enum":["direct-spend","convert-first","unsupported","insufficient-data"],"type":"string"},"marketSignals":{"type":"object","required":["liquidityUsd","volume24h","marketCap","volatility24hPercent","completeness"],"properties":{"marketCap":{"type":["number","null"]},"volume24h":{"type":["number","null"]},"completeness":{"enum":["complete","partial","sparse"],"type":"string"},"liquidityUsd":{"type":["number","null"]},"volatility24hPercent":{"type":["number","null"]}}},"confidenceScore":{"type":["number","null"]}}}}}}},"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_gL-0nQ9AVYSt3htj1Hwhe","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 a comprehensive pre-transaction assessment of a tracked asset including market-data quality, freshness, liquidity, volatility, confidence score, and x402/Base spendability status.","exampleAgentPrompt":"Before you execute that ETH payment on Base, run an AgentOracle assessment on ETH — I want to see the data quality, freshness, confidence score, liquidity, volatility, and whether it can be spent directly via x402 or needs converting first.","exampleUseCases":[{"title":"Pre-payment ETH safety check","prompt":"Before my agent sends that ETH payment on Base, can you check AgentOracle to see if the market data is fresh and high quality, and whether ETH is directly spendable via x402 or needs to be converted?"},{"title":"Volatile token transaction gatekeeping","prompt":"My agent is about to transact with SOL — can you pull an AgentOracle assessment for SOL and tell me the 24h volatility, liquidity, and confidence score so I can decide if it's safe to proceed?"},{"title":"Stablecoin spendability verification","prompt":"Check AgentOracle's assessment for USDC — specifically whether it's marked as direct-spend on Base and what the data completeness and freshness look like right now."}],"resultDescription":"A structured JSON object containing: asset symbol, name, chain, current USD price, quality rating (high/medium/low/insufficient-data), confidence score (0–1), freshness metadata (timestamp, age in seconds, fresh/stale status), market signals (liquidity USD, 24h volume, market cap, 24h volatility percent, completeness), spendability classification (direct-spend/convert-first/unsupported/insufficient-data), an array of rationale strings explaining the assessment, and a limitations array noting data gaps or caveats.","failureModes":["Unknown or untracked ticker symbol returns insufficient-data quality and null price fields","Stale data ingestion causes freshness status to return 'stale' with elevated age seconds","Sparse market signals result in 'partial' or 'sparse' completeness and reduced confidence score","Service unavailability or upstream data feed failure may return error or null market signals","Misspelled symbol in path returns no match — symbol is case-sensitive per path param"],"whenToPreferThis":"Use this endpoint when an autonomous agent needs a comprehensive go/no-go signal before executing a financial transaction — it combines data quality, freshness, liquidity, volatility, confidence, and Base/x402 spendability into a single structured response. Prefer it over a simple price lookup when transaction safety and data trust are paramount, especially for agents operating on Base with x402 payment flows.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:31:38.431Z","isFirstParty":false}