Unnamed service

Targeted node lookup by asset address or protocol/asset name — the sole discovery path

Resource: risk.yo.xyz/api/v1/agent/search

Network: eip155:8453 · Asset: 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 · Pay to: 0x58f42C60DFe9b662B9E573C13358e5D773790699

Payment methods: — · Last validation: 2026-09-14 12:35:06.316+00

{
  "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
                }
              }
            }
          }
        }
      }
    }
  },
  "paymentRequirements": [
    {
      "raw": {
        "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
        "extra": {
          "name": "USD Coin",
          "version": "2"
        },
        "payTo": "0x58f42C60DFe9b662B9E573C13358e5D773790699",
        "amount": "1000",
        "scheme": "exact",
        "network": "eip155:8453",
        "maxTimeoutSeconds": 300
      },
      "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "payTo": "0x58f42C60DFe9b662B9E573C13358e5D773790699",
      "scheme": "exact",
      "network": "eip155:8453",
      "amountAtomic": "1000"
    }
  ]
}

Source catalog records are retained separately from live endpoint observations. Sonar score, uptime, and latency are advisory metrics. CDP indexing is not inferred from validation.