3.2 Wallet Transfer Records API

GET /api/v1/exchange/report/transfer-wallet-transactions

Query transfer wallet transaction records (bet deductions, payouts, refunds, deposits, withdrawals, etc.) by time range with pagination. Data comes from the historical store and may lag by a few seconds; the most recent 6 months are retained. Requests must include the HMAC authentication headers.

TIP

This API is rate-limited to 100 requests / minute (per api_key); exceeding it returns code:10060.

Request Parameters (Query String)

Field	Required	Type	Description
start_time	TRUE	string	Start time (≥), RFC3339 UTC, e.g. 2026-05-19T00:00:00Z
end_time	TRUE	string	End time (≤), RFC3339 UTC, must be later than start_time; the span cannot exceed 90 days
source_id	FALSE	string	Source ID (ticket / reference number)
order_id	FALSE	string	Search for records containing this exchange order ID
player_id	FALSE	string	Internal player ID (UUID)
player_name	FALSE	string	Player name
transaction_type	FALSE	string	Transaction type (see enum below)
page / page_size	FALSE	integer	Pagination; page starts at 1, default 1; page_size defaults to 10, max 200, values ≤0 or >200 fall back to 10

The agent dimension is locked automatically by the system based on api_key; it cannot and need not be specified via parameters.

Response data

data contains items[] (transaction records) and pagination fields (total / page / page_size / total_pages).

{
  "code": 0,
  "message": "success",
  "data": {
    "items": [
      {
        "player_id": "45d3d8eb-1a95-4e47-9315-bc507ea06d65",
        "player_external_id": "player1",
        "player_name": "player1_name",
        "agent_id": "bea4274e-4333-423c-a8e8-4c203d256d2c",
        "agent_name": "agent_demo",
        "transaction_type": "EXCHANGE_TRANSACTION_TYPE_BET_DEDUCT",
        "currency": "CNY",
        "amount": "-100",
        "balance_after": "900",
        "created_at": "2026-05-20T10:00:00Z"
      }
    ],
    "total": 1,
    "page": 1,
    "page_size": 10,
    "total_pages": 1
  }
}

items[] fields

Field	Type	Description
player_id	string	Internal player ID (UUID)
player_external_id	string	Player ID
player_name	string	Player name
agent_id	string	Internal agent ID (UUID)
agent_name	string	Agent name
transaction_type	string	Transaction type (enum, see below)
currency	string	Currency
amount	string	Amount change (may be negative, e.g. bet deduction)
balance_after	string	Balance after this change
created_at	string	Transaction time (RFC3339 UTC)

Enums

Transaction type transaction_type (prefix EXCHANGE_TRANSACTION_TYPE_)

Value	Description
BET_DEDUCT	Bet deduction
SETTLEMENT_PAYOUT	Settlement payout
RE_SETTLEMENT_PAYOUT	Re-settlement payout
ROLLBACK_CLAWBACK	Settlement rollback clawback
PLAYER_CANCEL_REFUND	Player cancellation refund
HEDGE_REFUND	Hedge refund
BET_CANCEL_VOID_REFUND	Bet void refund
MARKET_SUSPEND_REFUND	Market suspension refund
MTS_REJECT_REFUND	MTS rejection refund
DEPOSIT	Deposit
WITHDRAW	Withdrawal