`bullpen polymarket sweep-stranded`¶

Last updated: May 29, 2026

Move a stranded ERC-20 token out of your Safe wallet via a gasless relayer transaction.

Usage¶

bullpen polymarket sweep-stranded [OPTIONS] --token <TOKEN> --amount <AMOUNT>

Live Help¶

Move a stranded ERC-20 token out of your Safe wallet via a gasless relayer transaction.

Use this when the wrong token (or right token on wrong chain) was sent to your Bullpen Safe or Deposit Wallet. The token is transferred to the destination address via a gasless relayer transaction — no POL/MATIC required. This sweeps ERC-20s only; `MATIC`/`POL` means wrapped POL/MATIC (WMATIC), not native POL.

By default only your own addresses are accepted as recipients (source signer EOA, source wallet, active wallet EOA, or active Polymarket wallet). Use `--unsafe-recipient` to send to an arbitrary address.

This is a one-way, non-reversible operation. Review the pre-flight summary carefully before confirming.

Usage: bullpen polymarket sweep-stranded [OPTIONS] --token <TOKEN> --amount <AMOUNT>

Options:
      --output <OUTPUT>
          Output format for command results

          [possible values: table, json]

      --token <TOKEN>
          ERC-20 token to sweep: ticker (USDC, USDC.e, pUSD, WMATIC/MATIC/POL, USDe) or 0x address. MATIC/POL means wrapped ERC-20, not native POL

      --env <ENV>
          Target environment to connect to (overrides config.toml)

          [env: BULLPEN_ENV=]
          [possible values: staging, production]

      --from <FROM>
          Source wallet address (0x-prefixed Safe or Deposit Wallet). Must be owned by one of your Turnkey EOAs. Defaults to your active wallet when omitted

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

      --to <TO>
          Destination address (0x-prefixed). Defaults to your server-selected Polymarket wallet (the wallet trading commands route to). Pass an explicit address to sweep to a different own-wallet. Use --unsafe-recipient to sweep to a third-party address

      --amount <AMOUNT>
          Amount to sweep in token units (e.g. "10.50" for 10.50 USDC)

      --unsafe-recipient
          Allow sending to an arbitrary address (not just your own wallet addresses)

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

      --wallet-kind <KIND>
          Override the source wallet kind for the sweep. When set, forces the source to the Safe (`safe`) or Deposit Wallet (`dw`, alias `deposit` / `deposit-wallet`) owned by the resolved owner EOA, instead of auto-detecting from the --from address or the active wallet. Fails fast if the specified wallet kind has no balance

          [possible values: safe, dw]

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

          [env: BULLPEN_NON_INTERACTIVE=]

  -y, --yes
          Skip confirmation prompt

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

EXAMPLES:
  bullpen polymarket sweep-stranded --help
      Show options for this command without signing, submitting, or changing state.

Example Commands¶

bullpen polymarket sweep-stranded [OPTIONS] --token <TOKEN> --amount <AMOUNT>
bullpen polymarket sweep-stranded --help
bullpen polymarket sweep-stranded --output json

JSON Output¶

Contract: JSON Output Contract.

This command supports --output json, but this generated reference page intentionally does not include a synthetic success schema or example.

Use the live command in your target environment to inspect command-specific success fields. Error output follows the shared JSON output contract linked above.

Error Envelope¶

When a Polymarket CLOB or gasless-relayer rejection coincides with a degraded Polymarket status page, the error envelope may include a polymarket_status object:

{
  "polymarket_status": {
    "page_status": "HASISSUES",
    "status_url": "https://status.polymarket.com",
    "affected_components": [
      {"name": "CLOB API", "status": "PARTIALOUTAGE"}
    ],
    "advisory": "Polymarket is experiencing issues; this rejection is most likely a Polymarket-side outage."
  }
}

The field is omitted on local validation/auth/balance errors and when the status-page fetch times out or reports healthy relevant components.

Schema version: 1 when a command emits schema_version; otherwise treat the current command shape as contract version 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.

bullpen polymarket sweep-stranded¶