{"uid":"cap_OuE3J5I6q16qVQMrFqB0_","slug":"risk-yo-xyz-node-risk-grade-lookup-ce5d3056","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/pool%3Abase%3A0x7bfa7c4f149e7415b73bdedfe609237e29cbf34a","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:0x7bfa7c4f149e7415b73bdedfe609237e29cbf34a"}}},"response":{"data":{"id":"pool:base:0x7bfa7c4f149e7415b73bdedfe609237e29cbf34a","labels":["Pool"],"properties":{"id":"pool:base:0x7bfa7c4f149e7415b73bdedfe609237e29cbf34a","name":"Spark USDC Vault","symbol":"sparkUSDC","tvlUsd":"9110742.05433975","address":"0x7bfa7c4f149e7415b73bdedfe609237e29cbf34a","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":"9110742.05433975"}},"message":"SUCCESS","statusCode":200}},"exampleRequest":{"nodeId":"pool:base:0x7bfa7c4f149e7415b73bdedfe609237e29cbf34a"},"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_-30joRxmRIfc4VY4-V859","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) for a single DeFi node (pool, asset, protocol, or chain) by its stable node ID","exampleAgentPrompt":"What's the risk grade and TVL for the Base pool at address 0x7bfa7c4f149e7415b73bdedfe609237e29cbf34a — give me the risk tier and any breakdown of why it got that grade.","exampleUseCases":null,"resultDescription":"Returns a JSON object with the node's stable ID, PascalCase labels (e.g. Pool, Asset, Protocol, Chain), and a properties bag including _riskTier (letter grade A–F), tvlUsd (canonical USD size), and riskBreakdown (array of question/answer pairs explaining the grade).","failureModes":["Invalid or malformed nodeId returns 404 or empty result","Unrecognized node type or address not indexed returns no data","Network or payment failure (x402) if USDC balance insufficient","Node data may be stale if lastUpdatedAt is old","Path encoding issues with special characters in nodeId"],"whenToPreferThis":"Use this endpoint when you have a specific stable node ID (e.g. pool:base:0x…) and need its risk grade, TVL, and risk explanation without neighborhood/graph traversal data. It is the right choice for point lookups of known DeFi nodes on any supported chain where a risk tier and breakdown are the primary outputs needed.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:51:08.861Z","isFirstParty":false}