{"uid":"cap_m9oV9D4zFGJbsaqoxtHWo","slug":"risk-yo-xyz-defi-node-risk-grade-lookup-3fdc20e8","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%3Abase%3A0xee8f4ec5672f09119b96ab6fb59c27e1b7e44b61","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:0xee8f4ec5672f09119b96ab6fb59c27e1b7e44b61"}}},"response":{"data":{"id":"pool:base:0xee8f4ec5672f09119b96ab6fb59c27e1b7e44b61","labels":["Pool"],"properties":{"id":"pool:base:0xee8f4ec5672f09119b96ab6fb59c27e1b7e44b61","name":"Gauntlet USDC Prime","symbol":"gtUSDCp","tvlUsd":"368028813.53137404","address":"0xee8f4ec5672f09119b96ab6fb59c27e1b7e44b61","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":"368028813.53137404"}},"message":"SUCCESS","statusCode":200}},"exampleRequest":{"nodeId":"pool:base:0xee8f4ec5672f09119b96ab6fb59c27e1b7e44b61"},"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_ELmbCypD2nj6r6SBUTBxc","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 (A–F tier) for a single DeFi node (pool, asset, protocol, or chain) identified by its stable node ID","exampleAgentPrompt":"What's the risk grade for the Base chain pool at address 0xee8f4ec5672f09119b96ab6fb59c27e1b7e44b61 — give me the A-to-F risk tier and the breakdown explaining 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 (total value locked in USD), riskBreakdown (array of question/answer pairs explaining the grade), and lastUpdatedAt timestamp.","failureModes":["Invalid or malformed nodeId returns an error or empty result","Node not found in graph returns 404 or empty node response","Payment not processed (x402 protocol) blocks access and returns 402","Network timeout or service unavailability returns 5xx","Malformed pool address format causes lookup failure"],"whenToPreferThis":"Use this endpoint when you need a quick, lightweight risk assessment for a single known DeFi node (pool, asset, protocol) identified by its stable node ID — without needing full neighborhood/dependency graph data. Prefer this over the dependencies endpoint when you only need the node's own properties and risk tier, not its connected graph context. Best used after /search to obtain the stable nodeId.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:41:05.056Z","isFirstParty":false}