Portfolio refunds

Retrieve capital-efficiency refund events for a bettor on SX Bet.

GET /trades/portfolio/refunds

Get portfolio refunds

cURL

curl --request GET \
  --url https://api.sx.bet/trades/portfolio/refunds

200

{
  "status": "success",
  "data": {
    "results": [
      {
        "marketHash": "0x7d9e27978f12b65e36990df94dbfa85c9f63dacaab24225e38e2f04d1ec66e8e",
        "baseToken": "0x6629Ce1Cf35Cc1329ebB4F63202F3f197b3F050B",
        "totalRefundedBetTimeValue": 65.54772,
        "events": [
          {
            "marketHash": "0x7d9e27978f12b65e36990df94dbfa85c9f63dacaab24225e38e2f04d1ec66e8e",
            "baseToken": "0x6629Ce1Cf35Cc1329ebB4F63202F3f197b3F050B",
            "bettor": "0x8268feC8dCb0D284343054BDf2b649286c9aA0a1",
            "maker": true,
            "fillOrderHash": "0x40b8c59cce8323952da3fb42b4e22a097a4922ae402bc46f958c441fd0f0902a",
            "amount": "61.960285",
            "amountBetTimeValue": "61.960285",
            "createdAt": "2026-01-05T18:20:24.920Z"
          },
          {
            "marketHash": "0x7d9e27978f12b65e36990df94dbfa85c9f63dacaab24225e38e2f04d1ec66e8e",
            "baseToken": "0x6629Ce1Cf35Cc1329ebB4F63202F3f197b3F050B",
            "bettor": "0x8268feC8dCb0D284343054BDf2b649286c9aA0a1",
            "maker": true,
            "fillOrderHash": "0xa56e17872d28b3021dc050006fcf10b469291e11472ff468196732169bc8371e",
            "amount": "3.587435",
            "amountBetTimeValue": "3.587435",
            "createdAt": "2026-01-05T18:29:08.486Z"
          }
        ]
      }
    ],
    "count": 7324
  }
}

Rate limit: All GET /trades/* endpoints share a combined limit of 200 requests/min. See Rate Limits.

It supports reconciling cases where settledNetReturn may differ from netReturn when marketHasRefunds is true (see Capital Efficiency Upgrades). Refunds reflect decreases in worst-case exposure (MXL) from offsetting positions and are only generated for market groups without prior cash outs; conversely, cash outs cannot occur after capital-efficient refunds.

See Capital Efficiency Upgrade for a high-level overview of the Capital Efficiency Upgrade.

Query Parameters

bettor · string · required

Bettor address (checksummed).

marketHash · string

Filter by market hash.

baseToken · string

Filter by base token.

fillOrderHash · string

Filter by the associated trade fill hash.

maker · boolean

If true, only refunds where bettor was a maker; otherwise taker refunds.

sortAsc · boolean · required

Sort ascending when true, descending when false.

page · integer · required

Page number for pagination (min 0).

perPage · integer · required

Page size (max 500).

Response

200 - application/json

status · string

success or failure if the request succeeded or not

data · object

Show child attributes