{"uid":"cap_dHsvRN1g8-gHgp8XGOGSQ","slug":"risk-yo-xyz-defi-node-risk-grade-lookup-78d37325","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%3A0x5979d7b546e38e414f7e9822514be443a4800529","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:0x1f9840a85d5af5bf1d1762f925bdaddc4201f984"}}},"response":{"data":{"id":"pool:arbitrum:0x5979d7b546e38e414f7e9822514be443a4800529","labels":["Pool"],"properties":{"id":"pool:arbitrum:0x5979d7b546e38e414f7e9822514be443a4800529","name":"Wrapped stETH","symbol":"wstETH","address":"0x5979d7b546e38e414f7e9822514be443a4800529","network":"arbitrum","poolType":"default","protocol":"lido","_riskTier":"A","marketCapUsd":9464584330,"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":"No oracle dependency","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_mXNUO2dEXS4Sk7vIGkIof","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 such as a liquidity pool, asset, or protocol on a specified chain","exampleAgentPrompt":"What's the risk grade and key properties for the Arbitrum pool at address 0x5979d7b546e38e414f7e9822514be443a4800529 — I need the A–F risk tier and any explanation of what drives that grade.","exampleUseCases":null,"resultDescription":"Returns a JSON object with the node's stable identifier, PascalCase labels (e.g. Pool, Asset, Protocol, Chain), and a property bag including _riskTier (A–F letter grade), tvlUsd (total value locked in USD), and riskBreakdown (an array of question/answer pairs explaining the grade in plain language).","failureModes":["Invalid or malformed nodeId returns a 404 or error response","Network or payment failure (x402 payment not processed) blocks the response","Node not found in the graph database returns empty or null result","Unsupported chain prefix in nodeId causes lookup failure","Stale data if lastUpdatedAt is far in the past"],"whenToPreferThis":"Use this endpoint when you need a quick, single-node risk assessment for a specific DeFi pool, asset, or protocol node and already know the nodeId. It returns the risk tier (A–F) and a human-readable breakdown without pulling in neighborhood graph data, making it faster and cheaper than a full dependency query. Prefer this over the dependencies endpoint when you only need the node's own risk grade, not its upstream exposures.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:33:59.830Z","isFirstParty":false}