Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.sx.bet/llms.txt

Use this file to discover all available pages before exploring further.

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.
EndpointBest for
GET /tradesIndividual filled orders — split by order, so one taker bet filling five maker orders returns five records
GET /trades/consolidatedAggregated history — that same bet appears as one record with weighted average odds
GET /trades/ordersWhen 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 →. 
curl "https://api.sx.bet/trades?bettor=0xYourAddress&marketHashes=0x1a46...&settled=false"

{
  "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,
    "count": 142
  }
}
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.
curl "https://api.sx.bet/trades/consolidated?bettor=0xYourAddress&settled=false&page=0&perPage=100&sortBy=gameTime&sortAsc=false"

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

{
  "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 →.
Last modified on May 4, 2026