# Risk Graph Pool Score Explainer

> Risk Graph Pool Score Explainer is a paid API for AI agents from risk-graph-gx7v4.ondigitalocean.app, paid per call via x402, $0.1/call, status down (last checked 2026-09-14).

Returns a full recursive risk score breakdown for a specific DeFi pool, including component scores and upstream composite traversal

## Facts

- Endpoint: GET https://risk-graph-gx7v4.ondigitalocean.app/api/v1/agent/scores/pool%3Aarbitrum%3A0x5979d7b546e38e414f7e9822514be443a4800529/explain
- Price: $0.1/call
- Payment: x402
- Status: down
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/risk-graph-gx7v4-ondigitalocean-app-dea516a2
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Pbj_2C5wX2D9oxPfdnBow

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-dea516a2
```

Example prompt: Show me the full recursive risk score breakdown for the Arbitrum pool at address 0x5979d7b546e38e414f7e9822514be443a4800529 — I want to see every component score, upstream contributor, and any penalty basis points.

## When to prefer this

Use this endpoint when you need to understand WHY a pool received a particular risk score, not just what the score is. It is the right choice when debugging risk ratings, auditing DeFi pool safety, or presenting a detailed explainability report to users. Prefer the sibling pools listing endpoint if you just need scores for many pools without deep breakdown.

## Known failure modes

- Invalid or unknown nodeId returns 404 or empty result
- Malformed pool address format causes a 400 bad request
- Node not yet scored returns null score fields
- Network timeout or upstream graph service unavailable returns 5xx
- Payment not completed (x402) returns 402 Payment Required

## How this service works

Full recursive score breakdown — component scores, composite traversal

## Output

Returns the node's composite risk score, a breakdown array of scoring factors, an array of upstream component nodes (protocol, chain, allocated assets) each with their own scores and breakdowns, penalty basis points, tier classification, label, symbol, and the timestamp when scoring occurred.

## 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",
     "properties": {}
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "nodeId",
      "breakdown",
      "components"
     ],
     "properties": {
      "name": {
       "type": [
        "string",
        "null"
       ]
      },
      "tier": {
       "type": [
        "string",
        "null"
       ]
      },
      "label": {
       "type": [
        "string",
        "null"
       ]
      },
      "score": {
       "type": [
        "number",
        "null"
       ]
      },
      "nodeId": {
       "type": "string"
      },
      "symbol": {
       "type": [
        "string",
        "null"
       ]
      },
      "scoredAt": {
       "type": [
        "string",
        "null"
       ]
      },
      "breakdown": {
       "type": "array",
       "items": {
        "type": "object",
        "additionalProperties": true
       }
      },
      "components": {
       "type": "array",
       "items": {
        "type": "object",
        "additionalProperties": true
       },
       "description": "Each upstream node that fed into the composite score (protocol, chain, allocated assets) with its own score and breakdown."
      },
      "penaltyBps": {
       "type": [
        "integer",
        "null"
       ]
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/risk-graph-gx7v4-ondigitalocean-app-dea516a2/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)