{"uid":"cap_yzTWKg1ihcg3433_spacI","slug":"risk-graph-gx7v4-ondigitalocean-app-058d914c","name":"Risk Graph Schema Discovery Endpoint","description":"Graph schema definition — entry point for agents to discover available data","url":"https://risk-graph-gx7v4.ondigitalocean.app/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_dks2YDqBpuCCLVBdbidKw","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 definition including node labels, edge types, and queryable properties for the risk graph — the entry point for agents to understand available data structures.","exampleAgentPrompt":"Show me the full schema for the DeFi risk graph — what node types, edge types, and queryable properties are available, including how risk tiers are represented?","exampleUseCases":null,"resultDescription":"A complete visual and property schema for every node label and edge type in the risk graph. Includes which properties are queryable on each entity, visual rendering metadata, and how risk is exposed (as a letter tier via `_riskTier`). Enables agents to understand the full data model before issuing targeted queries.","failureModes":["Payment required (402) if x402 payment header is missing or invalid","Service unavailable if DigitalOcean app is down","Schema may be incomplete if the graph backend is not fully initialized","Stale schema if the graph model has been updated but cache not cleared"],"whenToPreferThis":"Use this endpoint first, before any other risk graph endpoint, when you need to understand what data is available, what node/edge types exist, or what properties are queryable. It is the mandatory discovery step for agents unfamiliar with the graph structure. Prefer this over the node lookup or pool list endpoints when you do not yet know what entities or properties to query.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T18:35:48.778Z","isFirstParty":false}