{"uid":"cap_H1uKY85XJbhq1jEmO_bky","slug":"risk-yo-xyz-defi-node-risk-grade-lookup-1a998699","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%3A0x050ce30b927da55177a4914ec73480238bad56f0","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:0x050ce30b927da55177a4914ec73480238bad56f0"}}},"response":{"data":{"id":"pool:base:0x050ce30b927da55177a4914ec73480238bad56f0","labels":["Pool"],"properties":{"id":"pool:base:0x050ce30b927da55177a4914ec73480238bad56f0","name":"Gauntlet USDC Prime","symbol":"gtusdcp","tvlUsd":"79656490.12429242","address":"0x050ce30b927da55177a4914ec73480238bad56f0","network":"base","poolType":"vault","protocol":"morpho-vaults-v2","_riskTier":"C","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":"79656490.12429242"}},"message":"SUCCESS","statusCode":200}},"exampleRequest":{"nodeId":"pool:base:0x050ce30b927da55177a4914ec73480238bad56f0"},"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_TdpBGvV8m2-NJp-OCWkHZ","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 node (pool, asset, or protocol) identified by its stable node ID","exampleAgentPrompt":"What's the risk grade and breakdown for the Base pool at address 0x050ce30b927da55177a4914ec73480238bad56f0 — is it a safe place to provide liquidity?","exampleUseCases":null,"resultDescription":"Returns a JSON object containing 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), and riskBreakdown (an array of question/answer pairs explaining the risk grade)","failureModes":["Invalid or unknown nodeId returns a 404 or empty result","Malformed node ID format (missing chain prefix like pool:base:) causes a 400 error","Node exists but risk data is stale or unavailable — lastUpdatedAt may indicate freshness issues","Payment failure via x402 protocol results in 402 response before data is returned","Network timeout for slow on-chain data resolution"],"whenToPreferThis":"Use this endpoint when you have a specific stable node ID (e.g. pool:base:0x...) and need a fast single-node risk grade and property lookup without neighborhood or dependency graph data. Prefer this over the search endpoint when the node ID is already known, and over dependency endpoints when you only need the node's own risk tier and breakdown, not its relationships.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:53:40.990Z","isFirstParty":false}