{"uid":"cap_B0n2mO_1iKW2NKaN3EX5M","slug":"risk-yo-xyz-f1e7ca16","name":"risk.yo.xyz DeFi Node Search","description":"Targeted node lookup by asset address or protocol/asset name — the sole discovery path","url":"https://risk.yo.xyz/api/v1/agent/search","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","required":["q"],"properties":{"q":{"type":"string","description":"Asset address or protocol/asset name. Targeted lookup only — empty and wildcard (`*`, `%`) queries are rejected."},"tvl":{"type":"string","description":"Optional TVL comparator filter, e.g. \">1000000\" or \"<5e8\"."},"grade":{"type":"string","description":"Optional grade comparator over A–F, e.g. \"A\", \"<=B\", \">=C\"."},"label":{"type":"string","description":"Optional PascalCase label filter (e.g. \"Pool\", \"Asset\", \"Protocol\", \"Chain\")."},"limit":{"type":"integer","maximum":10,"minimum":1,"description":"Max nodes to return; hard-capped at 10 (default 10)."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["nodes"],"properties":{"nodes":{"type":"array","items":{"type":"object","required":["id","labels","properties"],"properties":{"id":{"type":"string","description":"Stable node id — pass to `/node` and `/dependencies`."},"labels":{"type":"array","items":{"type":"string"},"description":"PascalCase Neo4j labels (e.g. \"Pool\", \"Asset\")."},"properties":{"type":"object","properties":{"name":{"type":"string"},"tvlUsd":{"type":"number","description":"Value-locked $ TVL, coalesced across real pool types. Absent for LST/token nodes (see marketCapUsd) and pools with no USD figure."},"address":{"type":"string","description":"On-chain contract address, when the node has one."},"network":{"type":"string","description":"Chain the node lives on."},"uniqueKey":{"type":"string","description":"Morpho market hash (also embedded in `id`), when applicable."},"marketCapUsd":{"type":"number","description":"Token market cap ($), for asset / promoted-LST nodes. Distinct from tvlUsd — market cap is not value-locked."}},"description":"Teaser fields only. Full properties + `_riskTier` (A–F) are on `/node`.","additionalProperties":false}}}}}}}}}},"responseSchema":null,"example":null,"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_TpO-GLDkpmmSCc97K5KeB","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":"Searches for DeFi protocol/asset/pool nodes by address or name, returning risk grades and graph metadata","exampleAgentPrompt":"Search the DeFi risk graph for the Uniswap protocol — give me its risk tier, labels, and node properties, and filter to nodes with TVL above 1 million and a grade of A or B.","exampleUseCases":null,"resultDescription":"Returns an array of up to 10 matching graph nodes, each containing a stable node ID, PascalCase labels (e.g. Pool, Asset, Protocol, Chain), and a property bag including the risk tier (_riskTier, A–F scale) and other per-label metadata. Empty queries and wildcards are rejected.","failureModes":["Empty or wildcard query (*, %) returns an error — targeted lookup only required","Query matches no nodes — empty nodes array returned","Grade comparator syntax invalid — malformed filter rejected","TVL comparator syntax invalid — request rejected","Limit exceeds 10 — capped or rejected","Asset address not found in graph — empty result","Payment not included or insufficient — 402 payment required response"],"whenToPreferThis":"Use this endpoint as the entry point when you need to discover DeFi protocol, asset, pool, or chain nodes by name or on-chain address before traversing the risk graph. It is the only discovery path — use it before calling node-detail or dependency endpoints that require a nodeId. Prefer it when you need to filter by risk grade (A–F), TVL range, or node label type to narrow results upfront.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:52:52.819Z","isFirstParty":false}