# risk.yo.xyz DeFi Node Risk Grade Lookup

> risk.yo.xyz DeFi 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 node (pool, asset, or protocol) identified by its stable node ID

## Facts

- Endpoint: GET https://risk.yo.xyz/api/v1/agent/node/pool%3Abase%3A0x050ce30b927da55177a4914ec73480238bad56f0
- 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-defi-node-risk-grade-lookup-1a998699
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_H1uKY85XJbhq1jEmO_bky

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-defi-node-risk-grade-lookup-1a998699
```

Example prompt: What's the risk grade and breakdown for the Base pool at address 0x050ce30b927da55177a4914ec73480238bad56f0 — is it a safe place to provide liquidity?

## When to prefer this

Use this endpoint when you have a specific stable node ID (e.g. pool:base:0x...) and need a fast single-node risk grade and property lookup without neighborhood or dependency graph data. Prefer this over the search endpoint when the node ID is already known, and over dependency endpoints when you only need the node's own risk tier and breakdown, not its relationships.

## Known failure modes

- Invalid or unknown nodeId returns a 404 or empty result
- Malformed node ID format (missing chain prefix like pool:base:) causes a 400 error
- Node exists but risk data is stale or unavailable — lastUpdatedAt may indicate freshness issues
- Payment failure via x402 protocol results in 402 response before data is returned
- Network timeout for slow on-chain data resolution

## How this service works

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

## Output

Returns a JSON object containing the node's stable ID, PascalCase labels (e.g. Pool, Asset, Protocol, Chain), and a properties bag including _riskTier (letter grade A–F), tvlUsd (total value locked in USD), and riskBreakdown (an array of question/answer pairs explaining the risk grade)

## Example request

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

## 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-defi-node-risk-grade-lookup-1a998699/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)