{"uid":"cap_btnPp8c-PsojzEPYvJbR6","slug":"risk-yo-xyz-node-risk-grade-lookup-71349a65","name":"risk.yo.xyz Node Risk Grade Lookup","description":"Single node — properties + risk grade only (no neighborhood)","url":"https://risk.yo.xyz/api/v1/agent/node/asset%3Aethereum%3A0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48","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":["nodeId"],"properties":{"nodeId":{"type":"string"}}},"queryParams":{"type":"object","required":["nodeId"],"properties":{"nodeId":{"type":"string","description":"Stable node id from /search — e.g. \"pool:ethereum:0x…\"."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["id","labels","properties"],"properties":{"id":{"type":"string","description":"Stable node identifier — `nodeId` everywhere else in the API."},"labels":{"type":"array","items":{"type":"string"},"description":"PascalCase Neo4j labels (e.g. \"Pool\", \"Asset\", \"Protocol\", \"Chain\")."},"properties":{"type":"object","description":"Per-label property bag — see /agent/schema for the canonical keys. Risk is exposed as `_riskTier` (A–F) only. May also carry `tvlUsd` (canonical $ size), `riskBreakdown` (on /node — an array of {question, answer} explaining the grade, no numbers), and `lastUpdatedAt` (on /dependencies — ISO-8601 freshness).","additionalProperties":true}}}}}}},"responseSchema":null,"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"nodeId":"asset:ethereum:0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"}}},"response":{"data":{"id":"asset:ethereum:0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48","labels":["Asset"],"properties":{"id":"asset:ethereum:0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48","name":"USDC","symbol":"USDC","address":"0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48","network":"ethereum","_riskTier":"A","pegTarget":"USD","coingeckoId":"usd-coin","marketCapUsd":74851563392,"riskBreakdown":[{"answer":"Fully collateralized — verifiable on-chain or via independent attestations","question":"Is the asset fully collateralized with verifiable backing?"},{"answer":"Above $1B","question":"What is the asset market cap?"},{"answer":"Strong counterparty (Circle, Tether, Coinbase)","question":"What counterparty risk does the asset carry? (worst across reserves)"},{"answer":"Not pegged or RW-MAD < 15 bps","question":"How stable is the asset peg over the last 12 months?"},{"answer":"Above $5M","question":"What is the on-chain DEX liquidity (Birdeye)?"},{"answer":"No third-party mint authority (issuer controls minting, e.g. USDC via CCTP)","question":"For assets with third-party cross-chain mint authority: how strong is the worst per-deployment verification configuration?"}],"dexLiquidityUsd":"2238901782.0877976"}},"message":"SUCCESS","statusCode":200}},"exampleRequest":{"nodeId":"asset:ethereum:0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"},"tags":["x402"],"displayCostAmount":"0.05","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.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_yNCSLkjnzIlC6TqLMX1w4","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns properties and a risk grade (tier A–F with breakdown) for a single DeFi node identified by its stable node ID","exampleAgentPrompt":"What's the risk grade for USDC (Ethereum contract 0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48) — give me the risk tier and a breakdown of why it got that rating.","exampleUseCases":null,"resultDescription":"Returns a JSON object containing the node's stable ID, an array of PascalCase labels (e.g. Asset, Protocol, Chain), and a properties bag including _riskTier (letter grade A–F), riskBreakdown (array of {question, answer} pairs explaining the grade), and tvlUsd (canonical USD size of the asset).","failureModes":["Invalid or malformed nodeId returns 404 or empty result","Node not found in the risk graph if address is not indexed","Payment not settled (x402 payment required) results in 402 response","Network timeout for slow on-chain data resolution","Stale data if lastUpdatedAt is old and underlying protocol has changed"],"whenToPreferThis":"Use this endpoint when you already have a stable nodeId (e.g. from /search) and need only the properties and risk grade for a single node without neighborhood or dependency graph data. Prefer this over the /dependencies endpoint when you do not need connected nodes, for lower cost and faster response.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:42:24.133Z","isFirstParty":false}