# Risk Graph Schema Discovery Endpoint

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

Returns the full graph schema definition including node labels, edge types, and queryable properties for the risk graph — the entry point for agents to understand available data structures.

## Facts

- Endpoint: GET https://risk-graph-gx7v4.ondigitalocean.app/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-graph-gx7v4-ondigitalocean-app-058d914c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_yzTWKg1ihcg3433_spacI

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-graph-gx7v4-ondigitalocean-app-058d914c
```

Example prompt: Show me the full schema for the DeFi risk graph — what node types, edge types, and queryable properties are available, including how risk tiers are represented?

## When to prefer this

Use this endpoint first, before any other risk graph endpoint, when you need to understand what data is available, what node/edge types exist, or what properties are queryable. It is the mandatory discovery step for agents unfamiliar with the graph structure. Prefer this over the node lookup or pool list endpoints when you do not yet know what entities or properties to query.

## Known failure modes

- Payment required (402) if x402 payment header is missing or invalid
- Service unavailable if DigitalOcean app is down
- Schema may be incomplete if the graph backend is not fully initialized
- Stale schema if the graph model has been updated but cache not cleared

## How this service works

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

## Output

A complete visual and property schema for every node label and edge type in the risk graph. Includes which properties are queryable on each entity, visual rendering metadata, and how risk is exposed (as a letter tier via `_riskTier`). Enables agents to understand the full data model before issuing targeted 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-graph-gx7v4-ondigitalocean-app-058d914c/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from risk-graph-gx7v4.ondigitalocean.app](https://www.zero.xyz/host/risk-graph-gx7v4.ondigitalocean.app/llms.txt)