# Clinkagent Whale Trades

> Clinkagent Whale Trades is a paid API for AI agents from clinkagent.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-29).

Returns the latest whale (large) trades on any token, plus top net buyer/seller wallets and liquidity pool data, for a configurable time window and minimum USD threshold.

## Facts

- Endpoint: GET https://clinkagent.com/token/whales?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/clinkagent-whale-trades-c55987dd
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ucuJ1Zb8LaZYFKg1gcTab

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 clinkagent-whale-trades-c55987dd
```

Example prompt: Show me whale trades over $10,000 on the Base token at 0x4200000000000000000000000000000000000006 from the last 6 hours — up to 50 trades — and tell me if whales are net buying or selling.

## When to prefer this

Choose this endpoint when you need on-chain whale trade intelligence for a specific token — particularly to assess large-wallet sentiment (net buying vs selling), identify influential wallets, or surface DEX pool liquidity, across Base, Ethereum, BSC, Arbitrum, Polygon, Optimism, Avalanche, or Solana. Prefer it over generic price APIs when you care about who is trading, not just what the price is.

## Known failure modes

- 404 returned when no trades match the criteria (no whales traded above the min_usd threshold in the window)
- Invalid or malformed token address returns an error
- Unsupported chain value causes a validation error
- min_usd out of range (below 100 or above 1,000,000) causes rejection
- limit out of range (below 1 or above 100) causes rejection
- Payment failure (x402) if USDC is not provided or insufficient

## How this service works

Whale trades on any token - the latest big buys and sells (time, side, USD, amount, price, wallet, tx, pool, dex), newest first, plus top 10 net buyer and top 10 net seller wallets, whale buy/sell/net USD totals and a net_buying/net_selling/mixed lean. Top 3 pools by liquidity. Base, Ethereum, BSC, Arbitrum, Polygon, Optimism, Avalanche, Solana. ?address=&chain=base&min_usd=5000&window=1h|6h|24h&limit=1-100. No trades = 404 free. Sample: /token/whales/example.

## Output

A JSON response containing: a list of recent whale trades (newest first) each with timestamp, buy/sell side, USD value, token amount, price, wallet address, transaction hash, pool, and DEX; top 10 net buyer wallets and top 10 net seller wallets; aggregated whale buy, sell, and net USD totals; an overall market lean (net_buying, net_selling, or mixed); and the top 3 pools ranked by liquidity. Returns 404 if no trades meet the criteria.

## 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"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "address"
     ],
     "properties": {
      "chain": {
       "enum": [
        "base",
        "ethereum",
        "bsc",
        "arbitrum",
        "polygon",
        "optimism",
        "avalanche",
        "solana"
       ],
       "type": "string",
       "description": "default base"
      },
      "limit": {
       "type": "string",
       "description": "trades returned, 1-100, default 25"
      },
      "window": {
       "enum": [
        "1h",
        "6h",
        "24h"
       ],
       "type": "string",
       "description": "default 24h"
      },
      "address": {
       "type": "string",
       "description": "Token contract (0x + 40 hex on EVM chains) or Solana mint. Also accepted as contract, token, tokenAddress or ca."
      },
      "min_usd": {
       "type": "string",
       "description": "smallest trade to count in USD, 100-1000000, default 5000"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

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