Get User History

curl "https://api.bison.markets/user/history?userId=0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266"

curl "https://api.bison.markets/user/history?userId=0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266&type=fill"

curl "https://api.bison.markets/user/history?userId=0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266&marketId=KXFEDDECISION-26JAN-T425"

curl "https://api.bison.markets/user/history?userId=0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266&limit=10&cursor=eyJ0IjoxNzM0..."

{
  "records": [
    {
      "type": "fill",
      "id": "550e8400-e29b-41d4-a716-446655440001",
      "orderId": "abc123",
      "tradeId": "trade-xyz",
      "marketId": "KXFEDDECISION-26JAN-T425",
      "side": "yes",
      "action": "buy",
      "ccontracts": "1000",
      "priceUusdc": "650000",
      "totalUusdc": "6500000",
      "feeUusdc": "6500",
      "timestamp": 1734567890123
    },
    {
      "type": "settlement",
      "id": "550e8400-e29b-41d4-a716-446655440002",
      "marketId": "KXFEDDECISION-26JAN-T400",
      "side": "yes",
      "ccontracts": "500",
      "payoutUusdc": "5000000",
      "result": "yes",
      "timestamp": 1734567800000
    },
    {
      "type": "deposit",
      "id": "550e8400-e29b-41d4-a716-446655440003",
      "chain": "base",
      "txHash": "0xabc123...",
      "amountUusdc": "100000000",
      "timestamp": 1734567700000
    }
  ],
  "pagination": {
    "hasMore": true,
    "nextCursor": "eyJ0IjoxNzM0NTY3NzAwMDAwLCJpZCI6IjU1MGU4NDAwLWUyOWItNDFkNC1hNzE2LTQ0NjY1NTQ0MDAwMyIsInR5cGUiOiJkZXBvc2l0In0"
  }
}

{
  "error": "Valid Ethereum address is required"
}

GET

user

history

curl "https://api.bison.markets/user/history?userId=0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266"

curl "https://api.bison.markets/user/history?userId=0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266&type=fill"

curl "https://api.bison.markets/user/history?userId=0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266&marketId=KXFEDDECISION-26JAN-T425"

curl "https://api.bison.markets/user/history?userId=0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266&limit=10&cursor=eyJ0IjoxNzM0..."

{
  "records": [
    {
      "type": "fill",
      "id": "550e8400-e29b-41d4-a716-446655440001",
      "orderId": "abc123",
      "tradeId": "trade-xyz",
      "marketId": "KXFEDDECISION-26JAN-T425",
      "side": "yes",
      "action": "buy",
      "ccontracts": "1000",
      "priceUusdc": "650000",
      "totalUusdc": "6500000",
      "feeUusdc": "6500",
      "timestamp": 1734567890123
    },
    {
      "type": "settlement",
      "id": "550e8400-e29b-41d4-a716-446655440002",
      "marketId": "KXFEDDECISION-26JAN-T400",
      "side": "yes",
      "ccontracts": "500",
      "payoutUusdc": "5000000",
      "result": "yes",
      "timestamp": 1734567800000
    },
    {
      "type": "deposit",
      "id": "550e8400-e29b-41d4-a716-446655440003",
      "chain": "base",
      "txHash": "0xabc123...",
      "amountUusdc": "100000000",
      "timestamp": 1734567700000
    }
  ],
  "pagination": {
    "hasMore": true,
    "nextCursor": "eyJ0IjoxNzM0NTY3NzAwMDAwLCJpZCI6IjU1MGU4NDAwLWUyOWItNDFkNC1hNzE2LTQ0NjY1NTQ0MDAwMyIsInR5cGUiOiJkZXBvc2l0In0"
  }
}

{
  "error": "Valid Ethereum address is required"
}

Overview

Returns a chronologically sorted list of all financial transactions for a user, including:

Fills - Order executions (buys and sells)
Settlements - Market settlement payouts
Deposits - USDC deposits from on-chain
Withdrawals - USDC withdrawals to on-chain

Results are sorted by timestamp (newest first) and support filtering and pagination.

To avoid ambiguity, we denote the smallest possible multiple of USDC (0.000001 USDC) as one uusdc, which stands for µUSDC (micro-USDC), and denote the smallest possible multiple of a contract (0.01 contract) as one ccontract (centicontract).User-facing USDC balances are specified as fixed-point strings (e.g. "1.2625" for USDC). Contract quantities in the API and SDK are specified as integer ccontracts strings (e.g. "1050" for 10.50 contracts at precision 2).

string

required

User’s Ethereum wallet address (e.g., 0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266)

string

Filter by transaction type: fill, settlement, deposit, or withdraw

string

Filter by market ID. Only applies to fill and settlement records.

number

Start timestamp in milliseconds. Only returns records after this time.

number

End timestamp in milliseconds. Only returns records before this time.

number

default:"50"

Maximum number of records per page. Min: 1, Max: 200.

string

Pagination cursor from a previous response’s pagination.nextCursor field.

Response

array

required

Array of transaction records, sorted by timestamp (newest first).Each record has a type field that determines its shape:

Show Fill Record (type: 'fill')

string

"fill"

string

Unique fill ID

string

Associated order ID

string

Kalshi trade ID

string

Market ticker

string

"yes" or "no"

string

"buy" or "sell"

string

Number of cContracts filled (integer string)

string

Price per contract in µUSDC (integer string)

string

Total value in µUSDC (integer string)

string

Fee charged in µUSDC (integer string)

number

Unix timestamp in milliseconds

Show Settlement Record (type: 'settlement')

string

"settlement"

string

Unique settlement ID

string

Market ticker

string

"yes" or "no" - the side held

string

Number of cContracts settled (integer string)

string

Payout amount in µUSDC (integer string, 0 if lost)

string

"yes" or "no" - the market result

number

Unix timestamp in milliseconds

Show Deposit Record (type: 'deposit')

string

"deposit"

string

Unique deposit ID

string

Chain name (e.g., "base", "bsc")

string

On-chain transaction hash

string

Deposit amount in µUSDC (integer string)

number

Unix timestamp in milliseconds

Show Withdraw Record (type: 'withdraw')

string

"withdraw"

string

Unique withdrawal ID

string

Chain name (e.g., "base", "bsc")

string

Withdrawal amount in µUSDC (integer string)

string

"pending", "fill-locked", "unclaimed", or "claimed"

number

Unix timestamp in milliseconds

object

required

Show child attributes

boolean

Whether more records are available

string

Cursor for fetching the next page (only present if hasMore is true)

curl "https://api.bison.markets/user/history?userId=0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266"

curl "https://api.bison.markets/user/history?userId=0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266&type=fill"

curl "https://api.bison.markets/user/history?userId=0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266&marketId=KXFEDDECISION-26JAN-T425"

curl "https://api.bison.markets/user/history?userId=0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266&limit=10&cursor=eyJ0IjoxNzM0..."

{
  "records": [
    {
      "type": "fill",
      "id": "550e8400-e29b-41d4-a716-446655440001",
      "orderId": "abc123",
      "tradeId": "trade-xyz",
      "marketId": "KXFEDDECISION-26JAN-T425",
      "side": "yes",
      "action": "buy",
      "ccontracts": "1000",
      "priceUusdc": "650000",
      "totalUusdc": "6500000",
      "feeUusdc": "6500",
      "timestamp": 1734567890123
    },
    {
      "type": "settlement",
      "id": "550e8400-e29b-41d4-a716-446655440002",
      "marketId": "KXFEDDECISION-26JAN-T400",
      "side": "yes",
      "ccontracts": "500",
      "payoutUusdc": "5000000",
      "result": "yes",
      "timestamp": 1734567800000
    },
    {
      "type": "deposit",
      "id": "550e8400-e29b-41d4-a716-446655440003",
      "chain": "base",
      "txHash": "0xabc123...",
      "amountUusdc": "100000000",
      "timestamp": 1734567700000
    }
  ],
  "pagination": {
    "hasMore": true,
    "nextCursor": "eyJ0IjoxNzM0NTY3NzAwMDAwLCJpZCI6IjU1MGU4NDAwLWUyOWItNDFkNC1hNzE2LTQ0NjY1NTQ0MDAwMyIsInR5cGUiOiJkZXBvc2l0In0"
  }
}

{
  "error": "Valid Ethereum address is required"
}

System

Tokenization

Account

Kalshi Market Data

Kalshi Trading

Events

Developer

Overview

Response

​Overview

​Response

Overview

Response