{"uid":"cap_Y18MmW3xQDpG-UuXOglTe","slug":"risk-yo-xyz-node-risk-grade-lookup-7569d39c","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%3Aethereum%3A0x5dc53a23adc9f2bed98de6f59f7f309a7c71ff2b","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:ethereum:0x5dc53a23adc9f2bed98de6f59f7f309a7c71ff2b"}}},"response":{"data":{"id":"pool:ethereum:0x5dc53a23adc9f2bed98de6f59f7f309a7c71ff2b","labels":["Pool"],"properties":{"id":"pool:ethereum:0x5dc53a23adc9f2bed98de6f59f7f309a7c71ff2b","name":"Wintermute USDC Prime","symbol":"armUSDCp","tvlUsd":"19997151.57714853","address":"0x5dc53a23adc9f2bed98de6f59f7f309a7c71ff2b","network":"ethereum","poolType":"vault","protocol":"morpho-vaults-v2","_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":"19997151.57714853"}},"message":"SUCCESS","statusCode":200}},"exampleRequest":{"nodeId":"pool:ethereum:0x5dc53a23adc9f2bed98de6f59f7f309a7c71ff2b"},"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_m3e8XCpjADxnhFzNthoUx","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 (tier A–F) for a single DeFi pool, asset, protocol, or chain node by its node ID","exampleAgentPrompt":"What's the risk grade and breakdown for the Ethereum pool at address 0x5dc53a23adc9f2bed98de6f59f7f309a7c71ff2b — give me the tier (A–F) and any properties like TVL?","exampleUseCases":null,"resultDescription":"Returns a node object with a stable ID, PascalCase labels (e.g. Pool, Asset, Protocol, Chain), and a properties bag containing: `_riskTier` (letter grade A–F), `riskBreakdown` (array of {question, answer} pairs explaining the grade), `tvlUsd` (total value locked in USD), and `lastUpdatedAt` (ISO-8601 timestamp).","failureModes":["Node not found — nodeId does not exist in the graph (404)","Invalid nodeId format — malformed path parameter","Payment required — x402 micropayment of $0.05 USDC not provided or rejected","Rate limiting — too many requests","Node exists but has no risk grade yet — properties may be sparse"],"whenToPreferThis":"Use this endpoint when you have a specific node ID (e.g. pool:ethereum:0x...) and need only the node's own properties and risk grade without neighborhood or dependency context. It is cheaper and faster than dependency or neighborhood endpoints. Prefer it for quick risk tier checks on a known address.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:31:19.532Z","isFirstParty":false}