# risk.yo.xyz Graph Schema Discovery

> risk.yo.xyz Graph Schema Discovery is a paid API for AI agents from risk.yo.xyz, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-13).

Returns the full graph schema — node labels, edge types, and queryable properties — for the DeFi risk knowledge graph, including how risk tiers are exposed

## Facts

- Endpoint: GET https://risk.yo.xyz/api/v1/agent/schema
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/risk-yo-xyz-4c8d1498
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_F7l254fhSe42oaLCzTDsh

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-4c8d1498
```

Example prompt: Before I start querying DeFi pool risk data, can you pull the full graph schema from risk.yo.xyz so I can see all the available node types, edge types, and which properties are queryable — including how the risk tier field is structured?

## When to prefer this

Use this endpoint first, before any other risk.yo.xyz query, to understand the graph structure — what node labels exist, what edge types connect them, and which properties can be filtered or queried. It is the canonical schema discovery step for agents building DeFi risk queries dynamically. Prefer this when you have no prior knowledge of the data model, or when you need to validate that a property like `_riskTier` exists before constructing a lookup.

## Known failure modes

- 402 Payment Required if USDC micropayment header is missing or insufficient
- Network timeout if the graph schema service is unavailable
- Malformed response if the underlying graph database is unreachable
- Empty or partial schema if node types have not been indexed yet

## How this service works

Graph schema definition — entry point for agents to discover available data

## Output

Returns a visual and property schema for every node label and edge type in the risk knowledge graph. Includes which properties are queryable on each node type, how the renderer displays them, and the risk tier representation (letter-grade `_riskTier` field). This is the entry point for agents to understand what data is discoverable before making targeted node or neighborhood queries.

## Example request

```json
{
 "input": {
  "type": "http",
  "method": "GET",
  "queryParams": {}
 }
}
```

## 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"
    },
    "queryParams": {
     "type": "object",
     "properties": {}
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "description": "Visual + property schema for every node label and edge type — drives the renderer and tells agents which properties are queryable. Risk is exposed as the letter tier `_riskTier` only.",
     "additionalProperties": true
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/risk-yo-xyz-4c8d1498/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)