Fetching Trades - SX Bet Documentation

Every trade made on SX Bet is publicly available through the SX Bet API. You can query trades for a specific user, event, market, time period, and more.

Endpoint	Best for
`GET /trades`	Individual filled orders — split by order, so one taker bet filling five maker orders returns five records
`GET /trades/consolidated`	Aggregated history — that same bet appears as one record with weighted average odds
`GET /trades/orders`	When you have specific order hashes and want to see all fills against them

tradeStatus reflects the on-chain confirmation state of a trade: "PENDING" while awaiting confirmation, then "SUCCESS" or "FAILED" once confirmation completes.

GET /trades

Use this when you need granular fill data — individual order matches, settlement status, or trade history for a specific market or user. Filter by bettor, market hash, time range, settlement status, and more. See the full parameter reference →.

If bettor is not provided, results are limited to trades placed within the last 12 months — pass bettor to query further back. marketHashes accepts at most 100 hashes per request; anything more is rejected with a 400 error.

curl "https://api.sx.bet/trades?bettor=0xYourAddress&marketHashes=0x1a46...&settled=false"

Sample response + field notes

{
  "status": "success",
  "data": {
    "trades": [
      {
        "fillHash": "0xabc123...",
        "orderHash": "0xdef456...",
        "marketHash": "0x1a46...",
        "bettor": "0xYourAddress",
        "stake": "1035620",
        "normalizedStake": "1",
        "odds": "50875000000000000000",
        "maker": true,
        "bettingOutcomeOne": true,
        "betTime": 1774491706,
        "betTimeValue": 1.03562,
        "settleValue": 0,
        "settled": false,
        "tradeStatus": "SUCCESS",
        "valid": true,
        "betType": 0,
        "netReturn": "2.035617",
        "fillOrderHash": "0x789abc...",
        "fillOrderHashAttempts": ["0x789abc..."],
        "lastMineAttemptTime": "2026-03-26T02:21:48.098Z",
        "targetNonce": 27614,
        "contractsVersion": "6.0",
        "chainVersion": "SXR",
        "sportXeventId": "L16068923",
        "marketHasRefunds": false,
        "baseToken": "0x6629Ce1Cf35Cc1329ebB4F63202F3f197b3F050B",
        "createdAt": "2026-03-26T02:21:47.041Z",
        "updatedAt": "2026-03-26T02:21:48.224Z",
        "_id": "69c4983a23f5052c3b0a6dc2"
      }
    ],
    "nextKey": "66ae05484c2e5e971bcb7f29",
    "pageSize": 100
  }
}

odds is the bettor’s implied probability as a fixed-point integer — divide by 10^20 to get a decimal. 50875000000000000000 = 50.875% (1.97 in decimal odds format).stake and normalizedStake reflect the bettor’s stake — stake is in raw token units, normalizedStake is in whole token units. See Unit Conversions for token decimal details.

Results are paginated using a cursor — each response includes a nextKey field inside data. Pass it as paginationKey in your next request. Default page size is 100, max 300. When nextKey is absent, you’ve reached the last page.

GET /trades/consolidated

Use this when you want one record per bet regardless of how many maker orders it filled — for portfolio views, PnL tracking, or reviewing a user’s betting history. Fills that crossed multiple maker orders are rolled up with weighted average odds. See the full parameter reference →.

page, perPage, sortBy, sortAsc, and settled are all required parameters for this endpoint.

If bettor is not provided, results are limited to trades placed within the last 12 months — pass bettor to query further back.

curl "https://api.sx.bet/trades/consolidated?bettor=0xYourAddress&settled=false&page=0&perPage=100&sortBy=gameTime&sortAsc=false"

Sample response + field notes

{
  "status": "success",
  "data": {
    "trades": [
      {
        "fillHash": "0xabc123...",
        "marketHash": "0x1a46...",
        "bettor": "0xYourAddress",
        "totalStake": "5000000000",
        "weightedAverageOdds": "54200000000000000000",
        "bettingOutcomeLabel": "Los Angeles Lakers",
        "gameLabel": "Los Angeles Lakers vs Boston Celtics",
        "leagueLabel": "NBA",
        "gameTime": "2025-11-15T02:00:00.000Z",
        "bettingOutcome": 1,
        "maker": false,
        "settled": false,
        "tradeStatus": "SUCCESS",
        "sportXeventId": "L16068923",
        "baseToken": "0x6629Ce1Cf35Cc1329ebB4F63202F3f197b3F050B"
      }
    ],
    "count": 142
  }
}

count is the total number of matching trades — use it to calculate total pages: Math.ceil(count / perPage). Pagination starts at page 0.

GET /trades/orders

Use this when you have specific order hashes and want to see exactly how and when they were filled. See the full parameter reference →.

curl "https://api.sx.bet/trades/orders?orderHashes=0xdef456...,0x789abc..."

Sample response + field notes

{
  "status": "success",
  "data": {
    "trades": [
      {
        "fillHash": "0xabc123...",
        "orderHash": "0xdef456...",
        "marketHash": "0x1a46...",
        "bettor": "0xYourAddress",
        "stake": "1035620",
        "normalizedStake": "1",
        "odds": "50875000000000000000",
        "maker": true,
        "bettingOutcomeOne": true,
        "betTime": "2026-03-26T02:21:46.964Z",
        "betTimeValue": 1.03562,
        "settleValue": 0,
        "settled": false,
        "tradeStatus": "SUCCESS",
        "valid": true,
        "betType": 0,
        "affiliate": "0x0000000000000000000000000000000000000000",
        "netReturn": "2.035617",
        "fillOrderHash": "0x789abc...",
        "fillOrderHashAttempts": ["0x789abc..."],
        "contractsVersion": "6.0",
        "chainVersion": "SXR",
        "sportXeventId": "L16068923",
        "providerEventId": "17438473",
        "marketHasRefunds": false,
        "baseToken": "0x6629Ce1Cf35Cc1329ebB4F63202F3f197b3F050B",
        "id": "69c4983a23f5052c3b0a6dc2"
      }
    ]
  }
}

Each order hash returns two trade records — one for the maker and one for the taker. odds is from each bettor’s perspective as a fixed-point integer — divide by 10^20 to get a decimal.

Real-time trades

Rather than polling, subscribe to WebSocket channels to receive trades as they happen:

recent_trades:global — Global feed of every trade on the exchange, one message per order fill.
recent_trades_consolidated:global — Same feed, but one message per taker bet regardless of how many maker orders it filled.

For setup and full payload references, see Real-time Data →.

​GET /trades

​GET /trades/consolidated

​GET /trades/orders

​Real-time trades

GET /trades

GET /trades/consolidated

GET /trades/orders

Real-time trades