{"uid":"cap_0X8xuZVk_rhD_KWbWmVAa","slug":"risk-yo-xyz-node-risk-grade-lookup-3e3b1aac","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%3A0x1cfdc0154ae6b9f1887a8250f2582d55606e1a2008e65108fb83dd50a928593e","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:ethereum:0x1cfdc0154ae6b9f1887a8250f2582d55606e1a2008e65108fb83dd50a928593e"}}},"response":{"data":{"id":"pool:ethereum:0x1cfdc0154ae6b9f1887a8250f2582d55606e1a2008e65108fb83dd50a928593e","labels":["Pool"],"properties":{"id":"pool:ethereum:0x1cfdc0154ae6b9f1887a8250f2582d55606e1a2008e65108fb83dd50a928593e","lltv":0.86,"name":"Morpho PT-RLP-9APR2026/USDC","tvlUsd":"1036958.6324148006","network":"ethereum","poolType":"lending","protocol":"morpho-blue","_riskTier":"C","borrowUsd":"1036958.6324148006","supplyUsd":"1036958.6324148006","tranching":"direct","uniqueKey":"0x1cfdc0154ae6b9f1887a8250f2582d55606e1a2008e65108fb83dd50a928593e","oracleType":"single_feed","isLeveraged":false,"riskBreakdown":[{"answer":"No, less than 2x","question":"Is yield generated through excessive leverage (>2x)?"},{"answer":"No","question":"Is the pool undercollateralized?"},{"answer":"Buffer 5-20% (LLTV 80-95%)","question":"What is the LLTV buffer (1 - LLTV)?"},{"answer":"Direct asset exposure","question":"Is the position tranched?"},{"answer":"Oracle with single feed or hardcoded","question":"What oracle type does the market use?"}]}},"message":"SUCCESS","statusCode":200}},"exampleRequest":null,"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_VmJgvmjyL8-6ZUBgHSjPb","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 DeFi risk tier grade (A–F) for a specific liquidity pool or protocol node identified by its node ID","exampleAgentPrompt":"What's the risk grade for the Ethereum pool at 0x1cfdc0154ae6b9f1887a8250f2582d55606e1a2008e65108fb83dd50a928593e — I want to know its risk tier and any explanation of how it was graded.","exampleUseCases":[{"title":"Validate pool safety before investing","prompt":"I'm looking at a liquidity pool on Curve Finance and want to check if it's safe to put my money into. Can you pull up the risk grade and breakdown for this pool node? I need to understand what factors are making it risky or safe."},{"title":"Check DeFi protocol risk tier","prompt":"I found this interesting yield farming opportunity on a protocol, but I want to make sure it's not too risky. Can you look up the risk assessment for this protocol node and tell me what grade it got and why?"},{"title":"Audit portfolio exposure across pools","prompt":"I have several positions across different DeFi pools and want to understand my overall risk exposure. Can you check the risk tiers and grading explanations for each of these specific pool addresses so I know which ones are the riskiest?"}],"resultDescription":"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 (array of question/answer pairs explaining the risk grade).","failureModes":["Node ID not found — returns 404 or empty result","Invalid nodeId format causes 400 bad request","Payment not fulfilled via x402 protocol returns 402 Payment Required","Node exists but risk data not yet computed returns partial properties without _riskTier","Rate limiting or upstream graph database timeout returns 503"],"whenToPreferThis":"Use this endpoint when you have a specific pool or protocol node ID and need its risk grade and properties without neighbor context. It is faster and cheaper than dependency graph endpoints. Best when you already know the nodeId (e.g. from a prior search endpoint call) and just need the risk tier and breakdown for that single node.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:43:32.050Z","isFirstParty":false}