{"uid":"cap_pNhXMAE_8zPrY-dwRomk6","slug":"risk-yo-xyz-node-risk-grade-lookup-c01d5e8f","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%3Abase%3A0xbeefe94c8ad530842bfe7d8b397938ffc1cb83b2","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:base:0xbeefe94c8ad530842bfe7d8b397938ffc1cb83b2"},"queryParams":{"nodeId":"pool:base:0xbeefe94c8ad530842bfe7d8b397938ffc1cb83b2"}}},"response":{"data":{"id":"pool:base:0xbeefe94c8ad530842bfe7d8b397938ffc1cb83b2","labels":["Pool"],"properties":{"id":"pool:base:0xbeefe94c8ad530842bfe7d8b397938ffc1cb83b2","name":"Steakhouse Prime USDC","symbol":"steakUSDC","tvlUsd":"468546715.61932695","address":"0xbeefe94c8ad530842bfe7d8b397938ffc1cb83b2","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":"468546715.61932695"}},"message":"SUCCESS","statusCode":200}},"exampleRequest":{"nodeId":"pool:base:0xbeefe94c8ad530842bfe7d8b397938ffc1cb83b2"},"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_12Pvjs9Oe2eo-McqHv-tC","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 protocol node (pool, asset, or protocol) by its stable node ID","exampleAgentPrompt":"What's the risk grade and TVL for the Base chain pool at address 0xbeefe94c8ad530842bfe7d8b397938ffc1cb83b2 — give me the full risk breakdown explaining the grade.","exampleUseCases":[{"title":"Check pool safety before investing","prompt":"I'm thinking about putting money into the liquidity pool at 0xa374094527e1673a86de625aa59517c5de346d32 on Base — can you pull the risk grade and breakdown so I know if it's safe?"},{"title":"Compare risk tiers for protocol audit","prompt":"I've got the node ID for the Aave protocol on Ethereum — fetch me the risk tier, TVL, and full risk breakdown so I can include it in my DeFi safety report."},{"title":"Verify asset risk before treasury deployment","prompt":"Before our DAO moves funds into this asset, can you look up its risk grade and explain what's driving the score? The node ID is asset:arbitrum:0x82af49447d8a07e3bd95bd0d56f35241523fbab1."}],"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 (canonical USD size), and riskBreakdown (array of {question, answer} pairs explaining the risk grade without raw numbers).","failureModes":["Invalid or unknown nodeId returns a 404 or empty result","Malformed nodeId format (e.g. missing chain prefix) causes a request error","Payment failure or insufficient USDC balance returns a 402 error","Node exists but risk data not yet computed may return partial properties","Network timeout or upstream graph database unavailability returns 5xx"],"whenToPreferThis":"Use this endpoint when you have a stable node ID (e.g. pool:base:0x…) from a prior /search call and need a fast, single-node risk grade (A–F) plus property bag without fetching the full neighborhood graph. Prefer this over broader graph queries when you only need the risk tier and TVL for one specific pool, asset, or protocol node.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:53:11.931Z","isFirstParty":false}