Skip to content

bullpen solana discover memescope

Last updated: July 13, 2026

List Memescope tokens by launch category

Usage

bullpen solana discover memescope [OPTIONS] [COMMAND]

Subcommands

Subcommand Description
watch Watch live Memescope token updates for a bounded number of events

Live Help

List Memescope tokens by launch category

Usage: bullpen solana discover memescope [OPTIONS] [COMMAND]

Commands:
  watch  Watch live Memescope token updates for a bounded number of events
  help   Print this message or the help of the given subcommand(s)

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

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

      --cursor <CURSOR>
          Cursor returned by a previous Memescope response

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

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

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

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

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

          [env: BULLPEN_NON_INTERACTIVE=]

      --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:
  # Show newly launched Memescope tokens
  bullpen solana discover memescope --category newly-launched

  # Show graduated tokens and export JSON
  bullpen solana discover memescope --category graduated --limit 25 --output json

Example Commands

bullpen solana discover memescope --category newly-launched
bullpen solana discover memescope --category graduated --limit 25 --output json
bullpen solana discover memescope --help

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.