{"uid":"cap__SS_qb8THSe6MfCvG21JX","slug":"risk-yo-xyz-node-risk-grade-lookup-34f241e3","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%3A0xfae103dc9cf190ed75350761e95403b7b8afa6c0","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:0xfae103dc9cf190ed75350761e95403b7b8afa6c0"}}},"response":{"data":{"id":"pool:ethereum:0xfae103dc9cf190ed75350761e95403b7b8afa6c0","labels":["Pool"],"properties":{"id":"pool:ethereum:0xfae103dc9cf190ed75350761e95403b7b8afa6c0","name":"Restaked Swell ETH","symbol":"rswETH","address":"0xfae103dc9cf190ed75350761e95403b7b8afa6c0","network":"ethereum","poolType":"default","protocol":"swell-network","_riskTier":"A","marketCapUsd":32937269,"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:0xfae103dc9cf190ed75350761e95403b7b8afa6c0"},"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_1A6IWiVKk1zIOUat6OeHp","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 stable node ID","exampleAgentPrompt":"What's the risk grade and breakdown for the Ethereum pool at address 0xfae103dc9cf190ed75350761e95403b7b8afa6c0? I want to know its risk tier (A–F) and what factors contributed to it.","exampleUseCases":null,"resultDescription":"Returns a node object with a stable ID, PascalCase labels (e.g. Pool, Asset, Protocol, Chain), and a properties bag including _riskTier (A–F letter grade), riskBreakdown (array of {question, answer} pairs explaining the grade), and tvlUsd (total value locked in USD).","failureModes":["Invalid or unknown nodeId returns 404 or empty result","Malformed nodeId format causes 400 bad request","Payment not included or invalid x402 payment header causes 402 Payment Required","Node exists in graph but has no risk grade computed yet — properties returned but _riskTier may be absent","Ethereum address formatted incorrectly (missing prefix, wrong checksum) causes lookup failure"],"whenToPreferThis":"Use this endpoint when you have a stable nodeId (e.g. pool:ethereum:0x...) and need the risk grade and explanation for a single DeFi node without neighborhood/graph context. Prefer this over the search endpoint when the node ID is already known; use the search endpoint first if you only have a name or asset address.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:41:51.452Z","isFirstParty":false}