CLI - Bison API

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:   dev@example.com

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!

Option	Description
`--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

Option	Description
`--limit <number>`	Number of claims to show (default: 10)

​Installation

​Configuration

​Network Selection

​Commands

​bison info

​bison fees

​bison claim

​bison claim-auth

​bison history