# 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-15).

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

## Facts

- Endpoint: GET https://risk.yo.xyz/api/v1/agent/node/pool%3Aethereum%3A0x5dc53a23adc9f2bed98de6f59f7f309a7c71ff2b
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/risk-yo-xyz-node-risk-grade-lookup-7569d39c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Y18MmW3xQDpG-UuXOglTe

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-7569d39c
```

Example prompt: What's the risk grade and breakdown for the Ethereum pool at address 0x5dc53a23adc9f2bed98de6f59f7f309a7c71ff2b — give me the tier (A–F) and any properties like TVL?

## When to prefer this

Use this endpoint when you have a specific node ID (e.g. pool:ethereum:0x...) and need only the node's own properties and risk grade without neighborhood or dependency context. It is cheaper and faster than dependency or neighborhood endpoints. Prefer it for quick risk tier checks on a known address.

## Known failure modes

- Node not found — nodeId does not exist in the graph (404)
- Invalid nodeId format — malformed path parameter
- Payment required — x402 micropayment of $0.05 USDC not provided or rejected
- Rate limiting — too many requests
- Node exists but has no risk grade yet — properties may be sparse

## How this service works

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

## Output

Returns a node object with a stable ID, PascalCase labels (e.g. Pool, Asset, Protocol, Chain), and a properties bag containing: `_riskTier` (letter grade A–F), `riskBreakdown` (array of {question, answer} pairs explaining the grade), `tvlUsd` (total value locked in USD), and `lastUpdatedAt` (ISO-8601 timestamp).

## Example request

```json
{
 "input": {
  "type": "http",
  "method": "GET",
  "queryParams": {
   "nodeId": "pool:ethereum:0x5dc53a23adc9f2bed98de6f59f7f309a7c71ff2b"
  }
 }
}
```

## 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-7569d39c/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)