bullpen solana token risk

Last updated: July 13, 2026

Show Jupiter Shield and available risk signals for a mint

Usage

bullpen solana token risk [OPTIONS] <MINT>

Live Help

Show Jupiter Shield and available risk signals for a mint

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

Arguments:
  <MINT>
          SPL token mint address

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

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

      --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 token risk signals before a live Onchain Solana trade
  bullpen solana token risk So11111111111111111111111111111111111111112

  # Export token risk signals as JSON
  bullpen solana token risk So11111111111111111111111111111111111111112 --output json

Example Commands

bullpen solana token risk So11111111111111111111111111111111111111112
bullpen solana token risk So11111111111111111111111111111111111111112 --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
mint	string	no	Requested SPL token mint address
source	string	no	Data sources used, including Jupiter Shield and Bullpen Early Holder analysis when available
shield_warnings	array	no	Jupiter Shield warnings, empty when no warnings are returned
total_holders	integer	yes	Aggregate holder count from token overview when available
holder_stats	object	yes	Holder concentration metrics when the upstream token overview includes them
early_holder_analysis	object	yes	Bullpen Early Holder analysis metrics, bundled-current-holding percentage, and sniper cohort summary when Bullpen account services return them
unavailable	array	no	Explicit unavailable fields and the missing upstream source for each field

Example

Example JSON output

bullpen solana token risk So11111111111111111111111111111111111111112 --output json

{
  "mint": "So11111111111111111111111111111111111111112",
  "source": "usergate_market_data.get_token_overview+jupiter_shield+usergate_verify.early_holder_analysis",
  "shield_warnings": [],
  "total_holders": 42000,
  "holder_stats": null,
  "early_holder_analysis": {
    "risk_metrics": {
      "same_block_buys": 7,
      "avg_percentage_per_bundler": "1.25",
      "bundled_supply_percentage_bought": "2.38",
      "same_block_transfers_sol": "4.2"
    },
    "bundled_supply_distribution": {
      "bundled_supply_percentage": "12.0",
      "non_bundled_supply_percentage": "88.0",
      "bundled_current_holding_percentage": "9.5"
    },
    "sniper_analysis": {
      "sniper_total_percentage": "4.4",
      "sniper_holdings_percentage": "1.2",
      "sniper_addresses": ["sniper1"],
      "sniper_count": 1
    },
    "last_checked": "2026-07-13T12:00:00Z"
  },
  "unavailable": [
    {
      "field": "holder_stats",
      "missing_source": "Bullpen token overview does not expose mint-level holder_stats for arbitrary mint reads"
    }
  ]
}

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.