# Onvexia Top Holders (Whale Tracker)

> Onvexia Top Holders (Whale Tracker) is a paid API for AI agents from onvexia.com, paid per call via x402, $0.002/call, status unknown (last checked 2026-09-19).

Returns the top token holders (whales) for a given blockchain asset, drawn from Onvexia's multi-chain labelled address database.

## Facts

- Endpoint: GET https://onvexia.com/v1/whales/top-holders
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-19
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/onvexia-top-holders-whale-tracker-150bb9bb
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_tTOmP3WAVv0Yfz-IEV59g

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 onvexia-top-holders-whale-tracker-150bb9bb
```

Example prompt: Who are the top holders of Chainlink on Ethereum right now? Pull the whale list from Onvexia so I can see which addresses hold the largest concentrations.

## When to prefer this

Choose this endpoint when you need a ranked, labelled list of the largest token holders for a specific on-chain asset, especially when address labelling (e.g. identifying known exchanges or funds) and cross-chain coverage matter. Prefer this over generic blockchain explorers when you need structured, enriched whale data via a simple REST call with per-query micropayment pricing.

## Known failure modes

- Unknown or unsupported asset/chain returns an empty data array
- Malformed properties parameter returns a schema validation error
- Payment not received (x402) causes a 402 Payment Required response
- Rate limiting or quota exceeded returns a 429 error
- Internal data pipeline delay may return stale or partial holder data

## How this service works

Thousands of assets across ten chains, half a million analysed documents, labelled addresses and supply-age history reaching back to 2008 — fused into one reading per asset. REST, SQL, GraphQL and MCP.

## Output

A JSON object with a `data` array containing ranked wallet addresses and their holdings for the requested asset, plus a `meta` object with documentation links and the endpoint path. Addresses may include Onvexia's proprietary labels (e.g. exchange names, known funds) derived from their labelled address database.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": [],
  "meta": {
   "docs": "https://onvexia.com/openapi.json",
   "endpoint": "/v1/whales/top-holders"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/onvexia-top-holders-whale-tracker-150bb9bb/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from onvexia.com](https://www.zero.xyz/host/onvexia.com/llms.txt)