# DeFi Safety Oracle - Token Holder Distribution Scan

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

Scans the top 300 real holders of a token on Base, Ethereum, Robinhood Chain, or Solana to detect farming, fake holders, wallet clusters, and airdrop padding, returning an organic/mixed/farmed verdict

## Facts

- Endpoint: GET https://oracle.cyberwarex.com/v1/holders/scan?utm_source=zero.xyz
- Price: $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-distribution-scan-6763ecd8
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_pr6QnWgrCnbqSiN-l1LNX

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-distribution-scan-6763ecd8
```

Example prompt: Can you scan the holder distribution for this Base token at 0x1234...abcd and tell me whether the holders look organic, mixed, or farmed — I need the full breakdown of wallet ages, funding clusters, and fresh wallets before I consider investing.

## When to prefer this

Use this endpoint when you need deep holder-level intelligence about a specific token — especially to detect farming, bot activity, coordinated wallet clusters, or inflated airdrop counts. Prefer this over simple honeypot checks or contract scans when the question is about who holds the token, not just whether the contract is safe. Best for due diligence before investments, launchpad listings, or post-airdrop audits. Supports Base, Ethereum, Robinhood Chain, and Solana.

## Known failure modes

- Missing or invalid quote_id returns 400 or error response
- Quote ID expired before scan was initiated
- Token address not found on specified chain
- Network/chain not supported
- Job poll returns pending status if called too early — use retry_after_seconds
- Insufficient payment or failed x402 payment flow blocks scan start
- Token has fewer than 300 holders — scan covers available holders only

## How this service works

Who really holds this token? Scans the top 300 real holders (dust excluded) on Base, Ethereum, Robinhood Chain or Solana: wallet age, who funded each wallet, balance, activity, clusters funded by one source, fresh wallets, padded airdrop holder counts. Verdict organic/mixed/farmed. Get a free quote at /v1/holders/quote first; pay $0.075 per scanned wallet ($1 minimum) with ?quote=<id>; poll the job URL.

## Output

Returns a job_id and polling URL (result_url) immediately. When polled after completion, delivers a full holder report including: wallet-level data (age, funding source, balance, activity), detected clusters of wallets funded by the same source, fresh wallet counts, padded airdrop holder flags, and an overall verdict of organic, mixed, or farmed for the token.

## 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",
       "description": "quote_id from GET /v1/holders/quote?chain=&token="
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "job_id": {
       "type": "string"
      },
      "status": {
       "type": "string"
      },
      "price_usd": {
       "type": "number"
      },
      "result_url": {
       "type": "string"
      },
      "report_page": {
       "type": "string"
      },
      "retry_after_seconds": {
       "type": "integer"
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/defi-safety-oracle-token-holder-distribution-scan-6763ecd8/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)