bullpen solana token whales

Last updated: July 13, 2026

Show recent whale transactions for a mint address

Usage

bullpen solana token whales [OPTIONS] <MINT>

Live Help

Show recent whale transactions for a mint address

Usage: bullpen solana token whales [OPTIONS] <MINT>

Arguments:
  <MINT>
          SPL token mint address

Options:
      --limit <LIMIT>
          Maximum number of whale transactions to display

          [default: 100]

      --output <OUTPUT>
          Output format for command results

          [possible values: table, json]

      --env <ENV>
          Target environment to connect to (overrides config.toml)

          [env: BULLPEN_ENV=]
          [possible values: staging, production]

      --skip <SKIP>
          Offset into the whale transaction result set

          [default: 0]

      --config <CONFIG>
          Path to a custom config.toml file (overrides $BULLPEN_CONFIG and the default location).

          Explicit --config and BULLPEN_CONFIG paths fail closed: if the file is missing, the CLI exits validation instead of silently loading defaults. Credentials still resolve via BULLPEN_HOME, so set BULLPEN_HOME too when isolating a session.

      --transaction-type <TRANSACTION_TYPE>
          Restrict whale transactions to buy or sell events

          [possible values: buy, sell]

      --min-trade-amount <MIN_TRADE_AMOUNT>
          Minimum whale trade amount in USD

      --max-trade-amount <MAX_TRADE_AMOUNT>
          Maximum whale trade amount in USD

      --min-token-market-cap <MIN_TOKEN_MARKET_CAP>
          Minimum token market cap in USD

      --max-token-market-cap <MAX_TOKEN_MARKET_CAP>
          Maximum token market cap in USD

      --read-only
          Enable read-only mode: blocks all mutating commands

      --non-interactive
          Suppress interactive prompts; does NOT imply --yes for money-moving commands

          [env: BULLPEN_NON_INTERACTIVE=]

      --sort <SORT>
          Sort whale transactions like the web app

          [default: newest]
          [possible values: newest, biggest]

  -h, --help
          Print help (see a summary with '-h')

EXAMPLES:
  # Show recent whale transactions for a Solana token
  bullpen solana token whales EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v

  # Export token whale transactions as JSON
  bullpen solana token whales EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v --limit 25 --skip 100 --output json

  # Match the web app's biggest whale buys filter
  bullpen solana token whales EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v --transaction-type buy --min-trade-amount 1000 --max-token-market-cap 5000000 --sort biggest --output json

Example Commands

bullpen solana token whales EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
bullpen solana token whales EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v --limit 25 --skip 100 --output json
bullpen solana token whales EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v --transaction-type buy --min-trade-amount 1000 --max-token-market-cap 5000000 --sort biggest --output json
bullpen solana token whales So11111111111111111111111111111111111111112 --limit 10 --output json

JSON Output

Contract: JSON Output Contract.

Successful output is a single JSON document. The shape below is representative for this command family; commands may add fields without breaking the shared contract.

Schema version: 1 when a command emits schema_version; otherwise treat the current command shape as contract version 1.

Top-level Keys

key	type	nullable	notes
schema_version	integer	no	Stable schema version for token-whale output
chain	string	no	Always solana
mint	string	no	SPL token mint address queried
source	string	no	Upstream source label, currently usergate_http.transactions.whale.recent
pagination	object	no	Offset pagination metadata from the whale transaction endpoint
transactions	array	no	Whale transaction rows with signature, wallet, token amount, trade amount, market cap, type, and whale contract address when returned

Example

Example JSON output

bullpen solana token whales So11111111111111111111111111111111111111112 --limit 10 --output json

{
  "schema_version": 1,
  "chain": "solana",
  "mint": "So11111111111111111111111111111111111111112",
  "source": "usergate_http.transactions.whale.recent",
  "pagination": {
    "total": 42,
    "limit": 10,
    "skip": 0,
    "raw": {
      "total": 42,
      "limit": 10,
      "skip": 0
    }
  },
  "transactions": [
    {
      "signature": "5n7yWhaleTransactionSignature",
      "wallet_address": "7qRkWTrM4DLpmeSnB8xT8p8mpqLQ9JdYatYczS4u1G8e",
      "timestamp": 1779920575,
      "token_symbol": "SOL",
      "token_amount": "125.5",
      "trade_amount": "25000",
      "token_market_cap": "120000000000",
      "transaction_type": "buy",
      "whale_contract_address": null
    }
  ]
}

Stability

Patch releases may add nullable or optional fields. Minor releases may add required fields or increment schema_version. Major releases may remove or rename fields.

Analytics Availability

Use --limit from 1 through 500. Whale transactions depend on Bullpen's Solana analytics jobs for the specific mint and filter set. If a supported request returns SOLANA_MARKET_DATA_UNAVAILABLE, use bullpen solana token <MINT> or bullpen solana token transactions <MINT> --output json for basic token state, then retry whale analytics later.