{"uid":"cap_ZjqIG8-VxrUkJ7YZ7n8Zs","slug":"risk-graph-gx7v4-ondigitalocean-app-e4d7f2cf","name":"Risk Graph DeFi Pool Risk Scores API","description":"All risk-scored pools, sortable + filterable — primary agent payload","url":"https://risk-graph-gx7v4.ondigitalocean.app/api/v1/agent/pools","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":{"q":{"type":"string","description":"Substring match on the node name/symbol."},"page":{"type":"integer","minimum":1},"limit":{"type":"integer","maximum":200,"minimum":1},"tiers":{"type":"string","description":"CSV of risk tiers to keep, e.g. `A,B,C`."},"chains":{"type":"string","description":"CSV of chain ids/names to keep."},"sortBy":{"type":"string","description":"Property to sort by. Defaults to `_riskScore` (for most labels) or `totalTvl` (for pools)."},"sortDir":{"enum":["asc","desc"],"type":"string","description":"Sort direction; defaults to `desc`."},"filterKey":{"type":"string","description":"Optional property filter — used with `filterValue`."},"protocols":{"type":"string","description":"CSV of protocol slugs to keep."},"filterValue":{"type":"string"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["items","total","page","hasMore"],"properties":{"page":{"type":"integer"},"items":{"type":"array","items":{"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.","additionalProperties":true}}}},"total":{"type":"integer","description":"Total matching rows before pagination."},"hasMore":{"type":"boolean"}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_efRDW4GzIhlNG_RRoyXEv","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns all DeFi liquidity pools with risk scores, filterable by chain, protocol, and risk tier, and sortable by risk score or TVL","exampleAgentPrompt":"Show me all DeFi liquidity pools on Ethereum and Arbitrum that are in risk tiers A and B, sorted by risk score descending — give me the first 50 results.","exampleUseCases":null,"resultDescription":"A paginated JSON object containing an array of pool nodes, each with a stable node ID, PascalCase labels (e.g. Pool, Asset, Protocol, Chain), and a property bag including risk score and TVL. Also includes total matching row count, current page, and hasMore flag for pagination.","failureModes":["Invalid or unknown chain name/ID returns empty results or 400 error","Unsupported sortBy field may return default ordering without warning","Page number beyond total results returns empty items array with hasMore=false","Invalid risk tier CSV (e.g. typo in tier name) silently filters to zero results","Payment not included or insufficient results in 402 Payment Required response"],"whenToPreferThis":"Use this endpoint when you need a broad, filterable, paginated view of DeFi pool risk scores across multiple chains and protocols. Prefer this over the recursive score breakdown endpoint when you want the primary summary payload rather than deep component-level score decomposition. Best suited for ranking, screening, or monitoring pools by risk tier and TVL.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:36:23.575Z","isFirstParty":false}