bullpen polymarket clob geoblock

Last updated: July 13, 2026

Check geo-restriction status for your IP address

Usage

bullpen polymarket clob geoblock [OPTIONS]

Live Help

Check geo-restriction status for your IP address

Usage: bullpen polymarket clob geoblock [OPTIONS]

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:
  # Check geo-restriction status for your IP address
  bullpen polymarket clob geoblock

  # Export geo-restriction status as JSON
  bullpen polymarket clob geoblock --output json

Example Commands

bullpen polymarket clob geoblock
bullpen polymarket clob geoblock --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
blocked	boolean	no	Whether direct CLOB access is geo-restricted for the caller IP
ip	string	yes	Caller IP address as seen by CLOB when returned
country	string	yes	Country code reported by CLOB when returned
region	string	yes	Region code reported by CLOB when returned
proxy_routes_prediction_trades	boolean	no	Reminder that normal Bullpen prediction trades route through the Bullpen proxy
note	string	no	Human-readable context for direct-CLOB geoblock checks

Example

bullpen polymarket clob geoblock --output json

{
  "blocked": false,
  "ip": "203.0.113.10",
  "country": "US",
  "region": "NY",
  "proxy_routes_prediction_trades": true,
  "note": "Direct CLOB read commands report geoblocking for the caller IP; normal Bullpen prediction trades route through the Bullpen proxy."
}

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.