{"uid":"cap_F7l254fhSe42oaLCzTDsh","slug":"risk-yo-xyz-4c8d1498","name":"risk.yo.xyz Graph Schema Discovery","description":"Graph schema definition — entry point for agents to discover available data","url":"https://risk.yo.xyz/api/v1/agent/schema","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"},"queryParams":{"type":"object","properties":{}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","description":"Visual + property schema for every node label and edge type — drives the renderer and tells agents which properties are queryable. Risk is exposed as the letter tier `_riskTier` only.","additionalProperties":true}}}}},"responseSchema":null,"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{}}},"response":{"data":{"edgeTypes":{"BORROWS":{"color":"#F87171","label":"Borrow","width":2,"lineStyle":"dashed","defaultVisible":true},"LIVES_ON":{"color":"#4B5563","label":"Lives On","width":1,"subtle":true,"lineStyle":"solid","defaultVisible":false},"ALLOCATES":{"color":"#06B6D4","label":"Allocates","width":2,"edgeLabel":{"key":"allocationPct","format":"percent"},"lineStyle":"solid","detailFields":[{"key":"allocationPct","label":"Allocation %","format":"percent","required":true},{"key":"allocationUsd","label":"Allocation $","format":"usd"},{"key":"supplyAssetsUsd","label":"Supply Assets","format":"usd"}],"defaultVisible":true},"BACKED_BY":{"color":"#22D3EE","label":"Backed By","width":1.5,"edgeLabel":{"key":"percentage","format":"percent"},"lineStyle":"solid","detailFields":[{"key":"percentage","label":"Reserve %","format":"percent","required":true}],"defaultVisible":true},"ISSUED_BY":{"color":"#4B5563","label":"Issued By","width":1,"subtle":true,"lineStyle":"solid","defaultVisible":false},"TOKENIZES":{"color":"#3B82F6","label":"Tokenizes","width":1.5,"lineStyle":"dotted","defaultVisible":true},"BRIDGED_VIA":{"color":"#EAB308","label":"Bridged Via","width":1.5,"lineStyle":"dashed","defaultVisible":true},"OPERATED_BY":{"color":"#8B5CF6","label":"Operated By","width":1.5,"subtle":false,"lineStyle":"solid","defaultVisible":true},"USES_LENDING_VENUE":{"color":"#4B5563","label":"Lending","width":1,"subtle":true,"lineStyle":"solid","defaultVisible":false},"USES_TRADING_VENUE":{"color":"#4B5563","label":"Trading","width":1,"subtle":true,"lineStyle":"solid","defaultVisible":false},"ACCEPTS_DEPOSITS_IN":{"color":"#10B981","label":"Deposit","width":2,"lineStyle":"solid","defaultVisible":true},"DEPENDS_ON_PROTOCOL":{"color":"#A78BFA","label":"Depends On","width":1.5,"lineStyle":"dashed","defaultVisible":true},"IS_COLLATERALIZED_BY":{"color":"#EF4444","label":"Collateral","width":2.5,"lineStyle":"solid","defaultVisible":true}},"nodeTypes":{"Pool":{"color":"#3B82F6","shape":"round-rectangle","width":42,"height":31,"variants":{"poolType:lp":{"color":"#F59E0B"},"poolType:pt":{"color":"#14B8A6"},"protocol:aave":{"color":"#8B5CF6"},"protocol:pendle":{"color":"#1CD1A1"},"poolType:pendle_lp":{"color":"#10B981"},"protocol:morpho-blue":{"color":"#06B6D4"},"protocol:morpho-vaults-v1":{"color":"#22D3EE"},"protocol:morpho-vaults-v2":{"color":"#67E8F9"}},"riskFields":[{"key":"_riskTier","label":"Risk Grade","format":"tier"}],"detailFields":[{"key":"name","label":"Name","format":"string"},{"key":"protocol","label":"Protocol","format":"string"},{"key":"poolType","label":"Pool Type","format":"string"},{"key":"network","label":"Network","format":"string"},{"key":"symbol","label":"Symbol","format":"string"},{"key":"lltv","label":"LTV","format":"morpho-ltv"},{"key":"baseLtv","label":"LTV","format":"aave-ltv"},{"key":"liquidationThreshold","label":"Liq. Threshold","format":"aave-ltv"},{"key":"oracleType","label":"Oracle","format":"string"},{"key":"isLeveraged","label":"Leveraged","format":"boolean"},{"key":"tranching","label":"Tranching","format":"string"},{"key":"totalAssetsUsd","label":"Total Assets","format":"usd"},{"key":"supplyUsd","label":"Supply","format":"usd"},{"key":"borrowUsd","label":"Borrow","format":"usd"},{"key":"tvlUsd","label":"TVL","format":"usd"},{"key":"totalTvl","label":"TVL (Pendle)","format":"usd"},{"key":"impliedApy","label":"Implied APY","format":"percent"},{"key":"underlyingApy","label":"Underlying APY","format":"percent"},{"key":"aggregatedApy","label":"Aggregated APY","format":"percent"},{"key":"isFrozen","label":"Frozen","format":"boolean"},{"key":"borrowingEnabled","label":"Borrowing","format":"boolean"},{"key":"address","label":"Address","format":"address"}]},"Asset":{"color":"#10B981","shape":"ellipse","width":35,"height":35,"riskFields":[{"key":"_riskTier","label":"Risk Grade","format":"tier"}],"detailFields":[{"key":"symbol","label":"Symbol","format":"string"},{"key":"name","label":"Name","format":"string"},{"key":"coingeckoId","label":"CoinGecko ID","format":"string"},{"key":"network","label":"Network","format":"string"},{"key":"address","label":"Address","format":"address"},{"key":"marketCapUsd","label":"Market Cap","format":"usd"},{"key":"dexLiquidityUsd","label":"DEX Liquidity","format":"usd"},{"key":"pegTarget","label":"Peg Target","format":"string"}]},"Chain":{"color":"#6B7280","shape":"hexagon","width":45,"height":45,"riskFields":[{"key":"_riskTier","label":"Risk Grade","format":"tier"}],"detailFields":[{"key":"name","label":"Name","format":"string"},{"key":"network","label":"Network","format":"string"},{"key":"isL2","label":"L2","format":"boolean"},{"key":"tvlUsd","label":"TVL","format":"usd"},{"key":"fees90DayAvgMonthlyUsd","label":"Monthly Fees (90d avg)","format":"usd"}]},"Protocol":{"color":"#F59E0B","shape":"diamond","width":50,"height":50,"riskFields":[{"key":"_riskTier","label":"Risk Grade","format":"tier"}],"detailFields":[{"key":"name","label":"Name","format":"string"},{"key":"protocol","label":"Protocol","format":"string"},{"key":"tvlUsd","label":"TVL","format":"usd"},{"key":"protocolRank","label":"TVL Rank","format":"number"}]}},"riskTiers":[{"tier":"A","color":"#10B981"},{"tier":"B","color":"#34D399"},{"tier":"C","color":"#FBBF24"},{"tier":"D","color":"#F97316"},{"tier":"F","color":"#EF4444"}],"edgeConstraints":{"Pool":{"Pool":["ALLOCATES","ACCEPTS_DEPOSITS_IN","IS_COLLATERALIZED_BY","BORROWS"],"Asset":["ACCEPTS_DEPOSITS_IN","IS_COLLATERALIZED_BY","BORROWS"],"Chain":["LIVES_ON"],"Protocol":["OPERATED_BY"]},"Asset":{"Pool":["TOKENIZES"],"Asset":["BACKED_BY"],"Chain":["LIVES_ON"],"Protocol":["ISSUED_BY","BRIDGED_VIA"]},"Chain":{},"Protocol":{"Protocol":["DEPENDS_ON_PROTOCOL"]}}},"message":"SUCCESS","statusCode":200}},"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_rTgBwlkg51LOamtaPcD6R","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the full graph schema — node labels, edge types, and queryable properties — for the DeFi risk knowledge graph, including how risk tiers are exposed","exampleAgentPrompt":"Before I start querying DeFi pool risk data, can you pull the full graph schema from risk.yo.xyz so I can see all the available node types, edge types, and which properties are queryable — including how the risk tier field is structured?","exampleUseCases":null,"resultDescription":"Returns a visual and property schema for every node label and edge type in the risk knowledge graph. Includes which properties are queryable on each node type, how the renderer displays them, and the risk tier representation (letter-grade `_riskTier` field). This is the entry point for agents to understand what data is discoverable before making targeted node or neighborhood queries.","failureModes":["402 Payment Required if USDC micropayment header is missing or insufficient","Network timeout if the graph schema service is unavailable","Malformed response if the underlying graph database is unreachable","Empty or partial schema if node types have not been indexed yet"],"whenToPreferThis":"Use this endpoint first, before any other risk.yo.xyz query, to understand the graph structure — what node labels exist, what edge types connect them, and which properties can be filtered or queried. It is the canonical schema discovery step for agents building DeFi risk queries dynamically. Prefer this when you have no prior knowledge of the data model, or when you need to validate that a property like `_riskTier` exists before constructing a lookup.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:31:56.315Z","isFirstParty":false}