# risk.yo.xyz Node Risk Grade Lookup

> risk.yo.xyz Node Risk Grade Lookup is a paid API for AI agents from risk.yo.xyz, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-14).

Fetches properties and risk grade (tier A–F) for a single DeFi protocol node (pool, asset, or protocol) by its stable node ID

## Facts

- Endpoint: GET https://risk.yo.xyz/api/v1/agent/node/pool%3Abase%3A0xbeefe94c8ad530842bfe7d8b397938ffc1cb83b2
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/risk-yo-xyz-node-risk-grade-lookup-c01d5e8f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_pNhXMAE_8zPrY-dwRomk6

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability risk-yo-xyz-node-risk-grade-lookup-c01d5e8f
```

Example prompt: What's the risk grade and TVL for the Base chain pool at address 0xbeefe94c8ad530842bfe7d8b397938ffc1cb83b2 — give me the full risk breakdown explaining the grade.

## When to prefer this

Use this endpoint when you have a stable node ID (e.g. pool:base:0x…) from a prior /search call and need a fast, single-node risk grade (A–F) plus property bag without fetching the full neighborhood graph. Prefer this over broader graph queries when you only need the risk tier and TVL for one specific pool, asset, or protocol node.

## Known failure modes

- Invalid or unknown nodeId returns a 404 or empty result
- Malformed nodeId format (e.g. missing chain prefix) causes a request error
- Payment failure or insufficient USDC balance returns a 402 error
- Node exists but risk data not yet computed may return partial properties
- Network timeout or upstream graph database unavailability returns 5xx

## How this service works

Single node — properties + risk grade only (no neighborhood)

## Output

Returns a JSON object with the node's stable ID, PascalCase labels (e.g. Pool, Asset, Protocol, Chain), and a properties bag including: _riskTier (letter grade A–F), tvlUsd (canonical USD size), and riskBreakdown (array of {question, answer} pairs explaining the risk grade without raw numbers).

## Example request

```json
{
 "input": {
  "type": "http",
  "method": "GET",
  "pathParams": {
   "nodeId": "pool:base:0xbeefe94c8ad530842bfe7d8b397938ffc1cb83b2"
  },
  "queryParams": {
   "nodeId": "pool:base:0xbeefe94c8ad530842bfe7d8b397938ffc1cb83b2"
  }
 }
}
```

## Request schema (JSON Schema)

```json
{
 "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"
    },
    "pathParams": {
     "type": "object",
     "required": [
      "nodeId"
     ],
     "properties": {
      "nodeId": {
       "type": "string"
      }
     }
    },
    "queryParams": {
     "type": "object",
     "required": [
      "nodeId"
     ],
     "properties": {
      "nodeId": {
       "type": "string",
       "description": "Stable node id from /search — e.g. \"pool:ethereum:0x…\"."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "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. Risk is exposed as `_riskTier` (A–F) only. May also carry `tvlUsd` (canonical $ size), `riskBreakdown` (on /node — an array of {question, answer} explaining the grade, no numbers), and `lastUpdatedAt` (on /dependencies — ISO-8601 freshness).",
       "additionalProperties": true
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/risk-yo-xyz-node-risk-grade-lookup-c01d5e8f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from risk.yo.xyz](https://www.zero.xyz/host/risk.yo.xyz/llms.txt)