`bullpen solana history`¶

Last updated: July 13, 2026

Show recent Solana swaps and transfers for your Bullpen Solana account

Usage¶

bullpen solana history [OPTIONS]

Live Help¶

Show recent Solana swaps and transfers for your Bullpen Solana account

Usage: bullpen solana history [OPTIONS]

Options:
      --limit <LIMIT>
          Maximum number of activity entries to display

          [default: 20]

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

      --type <HISTORY_TYPE>
          Filter activity by event type

          [default: all]
          [possible values: all, trades, transfers]

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

      --since <SINCE>
          Include activity on or after this UTC date (YYYY-MM-DD)

      --refresh
          Refresh the upstream portfolio cache before fetching activity

      --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 Solana activity
  bullpen solana history --limit 10

  # Export recent Solana trades as JSON
  bullpen solana history --type trades --limit 10 --output json

  # Show recent Solana transfers since a date
  bullpen solana history --type transfers --since 2026-06-01

Example Commands¶

bullpen solana history --limit 10
bullpen solana history --type trades --limit 10 --output json
bullpen solana history --type transfers --since 2026-06-01

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
`address`	string	no	Bullpen Solana wallet address whose activity was queried
`limit`	integer	no	Maximum activity entries requested
`since_timestamp`	integer	yes	Lower-bound Unix timestamp when `--since` is provided
`since_utc`	string	yes	UTC rendering of `since_timestamp` when present
`event_type`	string	no	Requested activity filter: `all`, `trades`, or `transfers`
`classification_source`	string	no	Source used to classify history rows; currently `usergate_paginated_pnl.tx_type`
`truncated`	boolean	no	Whether the internal page cap truncated available history
`entries`	array	no	Grouped swap/transfer activity entries
`entries[].signature`	string	no	Solana transaction signature
`entries[].changes`	array	no	Token amount changes associated with the activity entry

Example¶

Example JSON output

bullpen solana history --type trades --limit 10 --output json

{
  "address": "7qRkWTrM4DLpmeSnB8xT8p8mpqLQ9JdYatYczS4u1G8e",
  "limit": 10,
  "since_timestamp": null,
  "since_utc": null,
  "event_type": "trades",
  "classification_source": "usergate_paginated_pnl.tx_type",
  "truncated": false,
  "entries": [
    {
      "signature": "5n7yExampleSolanaSignature",
      "timestamp": 1779920575,
      "timestamp_utc": "2026-07-13 13:42:55Z",
      "tx_order": 0,
      "tx_type": "swap",
      "action": "swap",
      "value_usd": "25",
      "net_value_usd": null,
      "sent": {
        "mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
        "symbol": "USDC",
        "amount": "-25",
        "value_usd": "25"
      },
      "received": {
        "mint": "So11111111111111111111111111111111111111112",
        "symbol": "SOL",
        "amount": "0.12",
        "value_usd": "25"
      },
      "fee": null,
      "changes": []
    }
  ]
}

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.

bullpen solana history¶