{"uid":"cap_Cq09Ql0Rn2jXijxZpOJVq","slug":"risk-yo-xyz-node-risk-grade-lookup-320fea83","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/protocol%3Aswell-network","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":"protocol:swell-network"},"queryParams":{"nodeId":"protocol:swell-network"}}},"response":{"data":{"id":"protocol:swell-network","labels":["Protocol"],"properties":{"id":"protocol:swell-network","name":"Swell Network","tvlUsd":"114308299.79080981","protocol":"swell-network","_riskTier":"A","protocolRank":300,"riskBreakdown":[{"answer":"2+ audits","question":"How many security audits of the deployed contract?"},{"answer":"Known team","question":"Is the team anonymous?"},{"answer":"Less than 2 hacks","question":"How many hacks/exploits has the protocol suffered?"},{"answer":"More than 6 months","question":"How long has the protocol been live?"},{"answer":"Top 20% (~rank <= 1347)","question":"Is the protocol in the top 20% by TVL?"},{"answer":"Multisig or governance","question":"What controls contract upgrades?"},{"answer":"Less than 4 signers (or MPC)","question":"How many multisig signers? (`na` if upgradeability=immutable)"},{"answer":"No timelock or undocumented","question":"Is there a timelock on upgrades? (`na` if upgradeability=immutable)"},{"answer":"Active DAO, no critical unaddressed issues","question":"What is the governance status?"},{"answer":"Non-reflexive","question":"Does the protocol rely on its own token for collateral/yield?"},{"answer":"Staking / restaking","question":"What category of yield-generating work does the protocol perform?"}]}},"message":"SUCCESS","statusCode":200}},"exampleRequest":{"nodeId":"protocol:swell-network"},"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_mkix56ev8UZuqsHWppmU0","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 or asset node by its stable node ID","exampleAgentPrompt":"What's the risk grade and key properties for the Swell Network protocol on risk.yo.xyz — give me the tier rating and any breakdown of why it got that score.","exampleUseCases":[{"title":"Check single protocol safety before deposit","prompt":"Can you look up the risk grade for Lido on risk.yo.xyz? I want to know if it's safe to deposit my ETH there and what factors went into that rating."},{"title":"Verify asset risk tier quickly","prompt":"Pull the risk assessment for USDC from risk.yo.xyz — I need to know its risk tier and TVL before I add it to my portfolio."},{"title":"Evaluate pool risk before investing","prompt":"What's the risk breakdown for the Uniswap V3 USDC/ETH pool? Get me the grade and properties from risk.yo.xyz so I can see how risky it actually is."}],"resultDescription":"Returns a node object with a stable ID, PascalCase labels (e.g. Protocol, Pool, Asset, Chain), and a property bag including `_riskTier` (letter grade A–F), optional `tvlUsd`, and `riskBreakdown` (array of question/answer pairs explaining the grade).","failureModes":["Invalid or unknown nodeId returns 404 not found","Malformed nodeId format causes 400 bad request","Payment not included or insufficient USDC causes 402 Payment Required","Service temporarily unavailable returns 503","Node exists but risk data not yet computed returns partial response without _riskTier"],"whenToPreferThis":"Use this endpoint when you need the risk grade and properties for a single, known DeFi node (protocol, pool, or asset) identified by its stable node ID. Best when you already have the nodeId from a prior search call and want a lightweight lookup without neighborhood/dependency graph data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:54:04.609Z","isFirstParty":false}