{"uid":"cap_UzBy8-DC_QKXNRNCjEHFs","slug":"risk-yo-xyz-defi-node-risk-grade-lookup-d816866a","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%3Aarbitrum%3A0x41ca7586cc1311807b4605fbb748a3b8862b42b5","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","pathParams":{"nodeId":"pool:ethereum:0x1f9840a85d5af5bf1d1762f925bdaddc4201f984"},"queryParams":{"nodeId":"pool:ethereum:0x1f9840a85d5af5bf1d1762f925bdaddc4201f984"}}},"response":{"data":{"id":"pool:arbitrum:0x41ca7586cc1311807b4605fbb748a3b8862b42b5","labels":["Pool"],"properties":{"id":"pool:arbitrum:0x41ca7586cc1311807b4605fbb748a3b8862b42b5","name":"syrupUSDC","symbol":"syrupUSDC","address":"0x41ca7586cc1311807b4605fbb748a3b8862b42b5","network":"arbitrum","poolType":"default","protocol":"maple","_riskTier":"B","marketCapUsd":1385627063,"riskBreakdown":[{"answer":"No, less than 2x","question":"Is the position leveraged (>2x)?"},{"answer":"No","question":"Is the position undercollateralized?"},{"answer":"Direct asset exposure","question":"Is the position tranched?"},{"answer":"Oracle with single feed or hardcoded","question":"What oracle does the pool use?"}]}},"message":"SUCCESS","statusCode":200}},"exampleRequest":{"nodeId":"pool:ethereum:0x1f9840a85d5af5bf1d1762f925bdaddc4201f984"},"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_z50cUYDn48rDnrv5oOt7H","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":"Fetches properties and risk grade (tier A–F) for a single DeFi node (pool, asset, protocol, or chain) by its node ID","exampleAgentPrompt":"What's the risk grade for the Arbitrum pool at address 0x41ca7586cc1311807b4605fbb748a3b8862b42b5? I want to see its risk tier, TVL, and a breakdown of what factors drove the grade.","exampleUseCases":null,"resultDescription":"Returns a node object with a stable node ID, PascalCase labels (e.g. Pool, Asset, Protocol, Chain), and a property bag including `_riskTier` (letter grade A–F), `tvlUsd` (total value locked in USD), and `riskBreakdown` (an array of {question, answer} pairs explaining the grade without raw numbers).","failureModes":["Node ID not found: returns 404 or empty result if the pool address does not exist in the risk graph","Invalid nodeId format: malformed pool address or path parameter returns 400 or error","Payment failure: x402 payment not completed, returns 402 Payment Required","Node data stale or unavailable: properties returned but lastUpdatedAt may indicate outdated assessment","Network/service downtime: 500 error or timeout if the risk.yo.xyz service is unavailable"],"whenToPreferThis":"Use this endpoint when you need a fast, single-node risk grade and properties for a known DeFi pool (by its stable nodeId) without needing neighborhood or dependency context. It is cheaper and simpler than the dependencies endpoint. Choose it when you already know the nodeId (discovered via the search endpoint) and just need the A–F risk tier, TVL, and risk explanation for that specific node.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:38:08.647Z","isFirstParty":false}