bullpen solana token traders

Last updated: July 13, 2026

Show recent token traders for a mint address

Usage

bullpen solana token traders [OPTIONS] <MINT>

Live Help

Show recent token traders for a mint address

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

Arguments:
  <MINT>
          SPL token mint address

Options:
      --limit <LIMIT>
          Maximum number of traders 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]

      --page <PAGE>
          Page number to fetch

          [default: 1]

      --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.

      --period <PERIOD>
          Trader aggregation period

          [default: month]
          [possible values: day, week, month, year]

      --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=]

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

EXAMPLES:
  # Show recent traders for a Solana token
  bullpen solana token traders EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v

  # Export monthly token traders as JSON
  bullpen solana token traders EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v --period month --page 2 --output json

Example Commands

bullpen solana token traders EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
bullpen solana token traders EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v --period month --page 2 --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-trader output
chain	string	no	Always solana
mint	string	no	SPL token mint address queried
source	string	no	Upstream source label, currently usergate_market_data.get_traders
period	string	no	Trader aggregation window: day, week, month, or year
page	integer	no	Offset page requested
pagination	object	no	Offset pagination metadata
traders	array	no	Trader rows with wallet, buy/sell volume, counts, balances, timestamps, and realized PnL fields

Example

Example JSON output

bullpen solana token traders EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v --period month --page 2 --output json

{
  "schema_version": 1,
  "chain": "solana",
  "mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
  "source": "usergate_market_data.get_traders",
  "period": "month",
  "page": 2,
  "pagination": {
    "next_cursor": null,
    "items_per_page": 100,
    "total_items": 2500,
    "total_pages": 25,
    "current_page": 2
  },
  "traders": [
    {
      "wallet_address": "7qRkWTrM4DLpmeSnB8xT8p8mpqLQ9JdYatYczS4u1G8e",
      "amount_bought_usd": "15000",
      "amount_sold_usd": "12500",
      "volume_usd": "27500",
      "buys": 12,
      "sells": 9,
      "token_amount_bought": "15000",
      "token_amount_sold": "12500",
      "token_balance": "2500",
      "first_transaction_timestamp": 1779320575,
      "last_transaction_timestamp": 1779920575,
      "realized_profit_percentage": "8.5",
      "realized_profit_usd": "2125",
      "single_token_acquisition_cost_usd": "1"
    }
  ]
}

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.