`bullpen solana discover memescope watch`¶

Last updated: July 13, 2026

Watch live Memescope token updates for a bounded number of events

Usage¶

bullpen solana discover memescope watch [OPTIONS]

Live Help¶

Watch live Memescope token updates for a bounded number of events

Usage: bullpen solana discover memescope watch [OPTIONS]

Options:
      --category <CATEGORY>
          Memescope category to fetch

          [default: newly-launched]
          [possible values: graduated, graduating, newly-launched]

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

      --limit <LIMIT>
          Maximum number of tokens to display per event

          [default: 50]

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

      --max-events <MAX_EVENTS>
          Maximum number of update events to collect before exiting

          [default: 5]

      --duration <DURATION>
          Optional maximum watch duration, such as 30s, 5m, or 1h

      --include-scams
          Include tokens flagged as scams by the upstream market-data service

      --protocol <ALLOWED_PROTOCOL>
          Restrict results to one or more launch protocols

      --min-market-cap <MIN_MARKET_CAP>
          Minimum market cap in USD

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

      --max-market-cap <MAX_MARKET_CAP>
          Maximum market cap in USD

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

          [env: BULLPEN_NON_INTERACTIVE=]

      --min-volume <MIN_VOLUME>
          Minimum 24h volume in USD

      --max-volume <MAX_VOLUME>
          Maximum 24h volume in USD

      --min-price <MIN_PRICE>
          Minimum token price in USD

      --max-price <MAX_PRICE>
          Maximum token price in USD

      --min-holders <MIN_HOLDERS>
          Minimum holder count

      --max-holders <MAX_HOLDERS>
          Maximum holder count

      --min-transactions <MIN_TRANSACTIONS>
          Minimum transaction count

      --max-transactions <MAX_TRANSACTIONS>
          Maximum transaction count

      --min-buys <MIN_BUYS>
          Minimum buy count

      --max-buys <MAX_BUYS>
          Maximum buy count

      --min-sells <MIN_SELLS>
          Minimum sell count

      --max-sells <MAX_SELLS>
          Maximum sell count

      --min-bonding-percent <MIN_BONDING_PERCENT>
          Minimum bonding progress percent

      --max-bonding-percent <MAX_BONDING_PERCENT>
          Maximum bonding progress percent

      --max-age <MAX_AGE>
          Include tokens no older than this duration, such as 30m, 6h, or 1d

      --last-transaction-within <LAST_TRANSACTION_WITHIN>
          Include tokens whose last transaction is no older than this duration

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

EXAMPLES:
  # Watch the next five newly launched Memescope updates
  bullpen solana discover memescope watch --max-events 5

  # Watch graduated tokens for up to 30 seconds and export JSON
  bullpen solana discover memescope watch --category graduated --duration 30s --output json

Example Commands¶

bullpen solana discover memescope watch --max-events 5
bullpen solana discover memescope watch --category graduated --duration 30s --output json
bullpen solana discover memescope watch --category newly-launched --max-events 2 --duration 30s --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	Output schema version, currently `1`
`chain`	string	no	Always `solana`
`source`	string	no	`usergate_market_data.subscribe_meme_scope_updates`
`category`	string	yes	Watched Memescope category when one was requested
`filters`	object	no	Normalized high-signal filters sent to the subscription request
`limit`	integer	no	Maximum tokens requested per category update
`max_events`	integer	no	Maximum stream events collected before the command exits
`duration_secs`	integer	no	Maximum watch duration before the command exits
`events`	array	no	Collected stream events; each event groups token rows by Memescope category

Example¶

Example JSON output

bullpen solana discover memescope watch --category newly-launched --max-events 2 --duration 30s --output json

{
  "schema_version": 1,
  "chain": "solana",
  "source": "usergate_market_data.subscribe_meme_scope_updates",
  "category": "newly_launched",
  "filters": {
    "allowed_protocols": [
      "Pump.fun"
    ],
    "include_scams": false
  },
  "limit": 25,
  "max_events": 2,
  "duration_secs": 30,
  "events": [
    {
      "sequence": 1,
      "categories": [
        {
          "category": "newly_launched",
          "tokens": [
            {
              "mint": "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263",
              "name": "Bonk",
              "symbol": "BONK",
              "current_price_usd": "0.00002",
              "market_cap_usd": "1200000000",
              "volume_usd": "85000000",
              "liquidity_usd": "12000000",
              "total_holders": 920000,
              "nsfw": false,
              "social_links": {}
            }
          ]
        }
      ]
    }
  ]
}

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.

Solana Memescope Notes¶

Memescope rows come from Bullpen's market-data service.
Category values are newly-launched, graduating, and graduated.
Read commands are snapshots. watch streams category updates and prints one event per line in JSON mode.
Treat filters as scoped to the returned service page or stream window; increase --limit or --duration when auditing broader coverage.

bullpen solana discover memescope watch¶