# Solenrich Whale Watch

> Solenrich Whale Watch is a paid API for AI agents from api.solenrich.com, paid per call via x402, $0.008/call, status unknown (last checked 2026-09-14).

Identifies top token holders on Solana with accumulation/distribution tracking, balance context, and supply percentage metrics.

## Facts

- Endpoint: POST https://api.solenrich.com/entrypoints/whale-watch/invoke
- Price: $0.008/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/solenrich-whale-watch-5c7bf789
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_bY0ULnixAcNZULgf6j-9J

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 solenrich-whale-watch-5c7bf789 -d '<json body>'
```

Example prompt: Show me the top whale holders for the Solana token with mint address EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v — use a $25,000 minimum whale threshold, look back over the last 48 hours, and give me the results in JSON format.

## When to prefer this

Use this endpoint when you need on-chain whale holder data for a specific Solana token, including accumulation/distribution signals and supply concentration metrics. Prefer this over generic blockchain explorers when you need structured, agent-ready output with USD context and behavioral signals rather than raw on-chain data.

## Known failure modes

- Invalid or malformed mint address returns a validation error
- Mint address not found on-chain returns empty or not-found response
- lookback_hours exceeding 168 returns a schema validation error
- threshold_usd below 100 returns a validation error
- Network or RPC unavailability causes timeout or 5xx error

## How this service works

Top holders with accumulation/distribution tracking, balance context, supply percentage.

## Output

Returns a ranked list of top token holders meeting the USD threshold, each annotated with accumulation or distribution status, current balance, USD value held, and percentage of total token supply controlled, covering the specified lookback window.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "mint": {
   "type": "string",
   "maxLength": 44,
   "minLength": 32,
   "description": "Solana token mint address"
  },
  "format": {
   "enum": [
    "json",
    "llm",
    "both"
   ],
   "type": "string",
   "default": "json"
  },
  "threshold_usd": {
   "type": "number",
   "default": 10000,
   "minimum": 100,
   "description": "Minimum USD value to qualify as whale"
  },
  "lookback_hours": {
   "type": "number",
   "default": 24,
   "maximum": 168,
   "minimum": 1,
   "description": "Hours of history to analyze"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "output": {
   "briefing": "string (llm format) or object (json format)"
  },
  "run_id": "uuid",
  "status": "succeeded"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/solenrich-whale-watch-5c7bf789/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.solenrich.com](https://www.zero.xyz/host/api.solenrich.com/llms.txt)