Skip to main content
GET
/
user
/
history
curl "https://api.bison.markets/user/history?userId=0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266"

{
  "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"
  }
}

​
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).
​
userId
string
required
User’s Ethereum wallet address (e.g., 0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266)
​
type
string
Filter by transaction type: fill, settlement, deposit, or withdraw
​
marketId
string
Filter by market ID. Only applies to fill and settlement records.
​
startTime
number
Start timestamp in milliseconds. Only returns records after this time.
​
endTime
number
End timestamp in milliseconds. Only returns records before this time.
​
limit
number
default:"50"
Maximum number of records per page. Min: 1, Max: 200.
​
cursor
string
Pagination cursor from a previous response’s pagination.nextCursor field.

​
Response

​
records
array
required
Array of transaction records, sorted by timestamp (newest first).Each record has a type field that determines its shape:
​
pagination
object
required
curl "https://api.bison.markets/user/history?userId=0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266"

{
  "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"
  }
}