Skip to content
onelayer.
All tools

Tool detail

search

Looks up onchain risk-graph nodes (pools, assets, protocols, chains) by address or name, with optional grade/TVL/label filters.

Categories: Crypto risk, Onchain data

Use when

  • look up the risk grade for a specific DeFi pool or protocol by name
  • find risk-graph nodes matching an asset address
  • filter onchain risk nodes by grade or TVL threshold

Not for

  • not a browse/discovery search — empty and wildcard queries are rejected
  • not a full graph export — capped at 10 nodes per call

Inputs

GET query params: q (string, required); grade, label, tvl (string, optional), limit (integer 1–10, default 10, optional)

Admitted input schema

{
  "type": "object",
  "properties": {
    "grade": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "description": "Optional grade comparator over A–F, e.g. \"A\", \"<=B\", \">=C\"."
    },
    "label": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "description": "Optional PascalCase label filter (e.g. \"Pool\", \"Asset\", \"Protocol\", \"Chain\")."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 10,
      "description": "Max nodes to return; hard-capped at 10 (default 10)."
    },
    "q": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "description": "Asset address or protocol/asset name. Targeted lookup only — empty and wildcard (`*`, `%`) queries are rejected."
    },
    "tvl": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "description": "Optional TVL comparator filter, e.g. \">1000000\" or \"<5e8\"."
    }
  },
  "required": [
    "q"
  ],
  "additionalProperties": false
}

Endpoint

Method
GET
URL
https://risk.yo.xyz/api/v1/agent/search

Payment

Protocol
x402
Listed price
0.001 USDC per call on Base
Payment method
exact
Network
eip155:8453
Asset
0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913

Listed terms are catalog metadata. The caller supplies inputs and calls the tool outside Onelayer. If payment is required, the caller uses a compatible wallet to pay.

Source

Record
GET https://risk.yo.xyz/api/v1/agent/search
Retrieved
2026-09-30T20:37:07.382Z
Catalog file SHA-256
6837ccddf886f0007cf3727ea9d27faaa5047b51b4f425345c554ce1c271a524
Catalog built
2026-09-30T22:31:58.034Z