# DeFi Safety Oracle – Token Holder Card

> DeFi Safety Oracle – Token Holder Card is a paid API for AI agents from oracle.cyberwarex.com, paid per call via x402, $0.1/call, status unknown (last checked 2026-10-11).

Returns a plain-language card (~900 chars) revealing who holds a token's supply, who can pull the pool, and who controls token powers, plus a go/caution/no_go verdict and max safe position in USD

## Facts

- Endpoint: GET https://oracle.cyberwarex.com/v1/holders/card?utm_source=zero.xyz
- Price: $0.1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/defi-safety-oracle-token-holder-card-849b7751
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap__bbjBcw6fqpa7V_YfJQgL

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 defi-safety-oracle-token-holder-card-849b7751
```

Example prompt: Can you pull the holder safety card for this token — I need to know who controls the supply, whether anyone can rug the pool, and what the biggest sensible position would be? I already have a quote ID: abc123.

## When to prefer this

Choose this endpoint when you need a human-readable, narrative summary of token holder risk rather than raw on-chain data. It is ideal for agents that need to present a concise risk briefing to a user before a trade, combining holder concentration, pool control risk, and power holder analysis into a single card with an actionable verdict. Prefer this over the raw holder scan endpoint when the consumer is a human or a reasoning agent that needs a verdict, not a data analyst processing bulk structured data.

## Known failure modes

- Invalid or expired quote ID returns an error — quotes must be fetched first from /v1/holders/quote
- Token not indexed on supported chains (Base, Ethereum, BSC) returns no data
- Payment not completed or quote not confirmed results in 402 Payment Required
- Malformed query parameter (missing quote field) returns 400 Bad Request
- Token with no liquidity or very low activity may return incomplete holder data

## How this service works

The plain-language card for a token ($0.10): who holds the supply, who can pull the pool, who holds powers over the token, and the largest sensible position, in under 900 characters, as text plus a verdict (go, caution, no_go). Free quote first at /v1/holders/quote, then ?quote=<id>. Not financial advice.

## Output

A plain-language text card under 900 characters summarizing: top holder concentration, who can drain the liquidity pool, which addresses hold admin/owner powers over the token contract, and the largest sensible position size in USD. Also returns a machine-readable verdict string (go, caution, or no_go) and max_position_usd as a number.

## 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",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "quote"
     ],
     "properties": {
      "quote": {
       "type": "string"
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "text": {
       "type": "string"
      },
      "verdict": {
       "type": "string"
      },
      "max_position_usd": {
       "type": "number"
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/defi-safety-oracle-token-holder-card-849b7751/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from oracle.cyberwarex.com](https://www.zero.xyz/host/oracle.cyberwarex.com/llms.txt)