{"uid":"cap_ZUqVikkIWLigJ1EE0slGZ","slug":"agentoracle-asset-assessment-cfb1707f","name":"AgentOracle Asset Assessment","description":"AgentOracle: use before an autonomous transaction to assess an asset's 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/:symbol/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_MuG7OxGi0SeRU7uE9bniZ","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":"Evaluates an asset's market-data quality, freshness, liquidity, volatility, confidence score, and x402/Base spendability before an autonomous transaction.","exampleAgentPrompt":"Before you execute that payment, can you assess the market-data quality, freshness, and spendability of ETH on Base — specifically whether it's safe to spend directly via x402 or if I need to convert it first?","exampleUseCases":[{"title":"Pre-payment token safety check","prompt":"Before my agent sends a payment using WBTC on Base, assess its market-data quality, confidence score, and whether it can be spent directly via x402 or needs to be converted first."},{"title":"Stablecoin liquidity validation","prompt":"Check the data quality and liquidity for USDC right now — I want to know how fresh the market data is and what the confidence score looks like before using it for a settlement."},{"title":"Volatile asset risk assessment","prompt":"My agent is about to interact with DEGEN on Base — can you assess its 24-hour volatility, market cap, and whether there's enough liquidity to trust a direct spend, or if I should skip it?"}],"resultDescription":"Returns a structured assessment object including: quality rating (high/medium/low/insufficient-data), current USD price, 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 rating), spendability classification (direct-spend/convert-first/unsupported/insufficient-data), human-readable rationale strings, and a list of limitations.","failureModes":["Unknown or unsupported ticker symbol returns quality: insufficient-data with null price and confidence","Stale data source returns freshness.status: stale with elevated ageSeconds","Low liquidity assets return spendability: unsupported or convert-first","Market data gaps return marketSignals.completeness: sparse or partial","Invalid symbol format may return 4xx error","Payment failure (USDC balance insufficient) returns 402"],"whenToPreferThis":"Use this endpoint immediately before any autonomous transaction or payment involving a crypto asset, especially on Base via x402. Prefer it when you need a holistic pre-flight check combining data freshness, liquidity depth, volatility, confidence scoring, and spendability classification in a single call — rather than querying spot price, volume, and chain support separately.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:45:22.831Z","isFirstParty":false}