Skip to main content

Installation

npm install -g @bison-markets/cli

Configuration

The CLI requires environment variables for authentication:
export BISON_PRIVATE_KEY="0x..."   # Your dev account signer private key
export BISON_ACCOUNT_ID="..."      # Your Bison dev account ID
export BISON_NETWORK="testnet"     # Default network (testnet or mainnet)

Network Selection

All commands accept -n, --network <network> to override the default:
bison info -n mainnet
Use -y, --yes to skip confirmation prompts.

Commands

bison info

View your dev account configuration.
$ bison info

Dev Account Info (testnet)

ID:      abc123
Name:    My App
Email:   [email protected]

Fee Configuration:
  Gross Fee:  1.00%
  Base Fee:   $0.05
  Bison Cut:  20.00%

Payout:
  Chain:   base-sepolia
  Address: 0x...

bison fees

View accumulated fee balances.
$ bison fees

Dev Account Fees (testnet)

Account: abc123 (My App)
Chain:   base-sepolia
Signer:  0x...

Balances:
  Pending:   $12.50
  Locked:    $0.00
  Unclaimed: $87.30

bison claim

Claim accumulated fees on-chain. Submits a withdrawal transaction to the Bison vault.
$ bison claim

Claiming $87.30 on base-sepolia
Vault: 0x...
Payout: 0x... (signer default)

Send to signer address (0x1234...5678)? [y/N] y
Submitting transaction...
Transaction: 0x...
Waiting for confirmation...

Claimed $87.30 successfully!
OptionDescription
--payout <address>Send funds to a different address than your signer

bison claim-auth

Get a signed fee claim authorization without submitting a transaction. Useful if you want to opt for manual vault interactions.
$ bison claim-auth

Fee Claim Authorization

Amount:  $87.30
Chain:   base-sepolia
Expires: 2024-01-15T12:00:00.000Z

Authorization:
  UUID:      550e8400-e29b-41d4-a716-446655440000
  Signer:    0x...
  Signature: 0x...

bison history

View past fee claim withdrawals.
$ bison history

Fee Claim History (testnet)

Account: abc123

Date            Amount        Chain     Payout Address
──────────────────────────────────────────────────────
Dec 15, 2025    $125.50       base      0x1234...5678
Dec 10, 2025    $89.25        base      0x1234...5678
OptionDescription
--limit <number>Number of claims to show (default: 10)