{"uid":"cap_eYmK3ihimBY4l3FLQMOmG","slug":"risk-yo-xyz-defi-node-risk-grade-lookup-6fb33fd5","name":"risk.yo.xyz DeFi Node Risk Grade Lookup","description":"Single node — properties + risk grade only (no neighborhood)","url":"https://risk.yo.xyz/api/v1/agent/node/pool%3Abase%3A0xc1256ae5ff1cf2719d4937adb3bbccab2e00a2ca","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":"pool:base:0xc1256ae5ff1cf2719d4937adb3bbccab2e00a2ca"}}},"response":{"data":{"id":"pool:base:0xc1256ae5ff1cf2719d4937adb3bbccab2e00a2ca","labels":["Pool"],"properties":{"id":"pool:base:0xc1256ae5ff1cf2719d4937adb3bbccab2e00a2ca","name":"Moonwell Flagship USDC","symbol":"mwUSDC","tvlUsd":"10045481.536247082","address":"0xc1256ae5ff1cf2719d4937adb3bbccab2e00a2ca","network":"base","poolType":"vault","protocol":"morpho-vaults-v1","_riskTier":"B","tranching":"direct","oracleType":"none","isLeveraged":false,"riskBreakdown":[{"answer":"No, less than 2x","question":"Is the vault leveraged (>2x)?"},{"answer":"No","question":"Does the vault hold undercollateralized positions?"},{"answer":"Direct asset exposure","question":"Is the vault tranched?"},{"answer":"No oracle dependency (ERC4626 NAV)","question":"What oracle does the vault use for valuations?"},{"answer":"Off-chain discretionary","question":"What type of curator manages allocations?"}],"totalAssetsUsd":"10045481.536247082"}},"message":"SUCCESS","statusCode":200}},"exampleRequest":{"nodeId":"pool:base:0xc1256ae5ff1cf2719d4937adb3bbccab2e00a2ca"},"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_wmWVM0NSBtksHFYoIzSFp","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 risk grade (A–F tier) for a single DeFi node (pool, asset, protocol, or chain) identified by its stable node ID","exampleAgentPrompt":"What's the risk grade and breakdown for the Base chain pool at address 0xc1256ae5ff1cf2719d4937adb3bbccab2e00a2ca — I want to know if it's safe to deposit into and why it got that grade.","exampleUseCases":null,"resultDescription":"Returns a node object with a stable ID, PascalCase labels (e.g. Pool, Asset, Protocol, Chain), and a property bag including _riskTier (letter grade A–F), riskBreakdown (array of {question, answer} pairs explaining the grade), and tvlUsd (total value locked in USD).","failureModes":["Invalid or malformed nodeId returns an error or empty result","Node not found in the graph returns 404 or empty response","Payment not provided or invalid x402 payment header returns 402 Payment Required","Rate limit exceeded returns 429","Network or server error returns 500"],"whenToPreferThis":"Use this endpoint when you need a quick risk grade and property lookup for a single known DeFi node (pool, asset, protocol, or chain) and already have the stable nodeId. It is faster and cheaper than a full graph traversal. Prefer it over the search endpoint when you already have the nodeId, and over neighborhood/dependencies endpoints when you only need the node's own properties and risk tier without its connected graph context.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:41:37.953Z","isFirstParty":false}