List balance flows

Lists changes to your USDT balance in a period, for reconciliation.

POST/api/open/order/getFlows

Full URL = your API base URL + this path. The base URL is shown in the merchant console under Developers → API & callbacks.

Request parameters

Parameter	Type	Required	Description
merchantNo	string	Yes	Merchant number
begin	string	Yes	Start (inclusive), yyyy-MM-dd HH:mm:ss, UTC+8
end	string	Yes	End (exclusive), at most 24 hours after begin
flowType	int	No	Only this flow type (see below)
orderNo	string	No	Only flows of this platform order number

{ "merchantNo": "your merchant number", "begin": "2026-10-13 00:00:00", "end": "2026-10-14 00:00:00" }

All flows in the period are returned at once (no paging), newest first. Use shorter periods when there's a lot of data.

Response

Field	Type	Description
totalCount	int	Number of items
items[].id	long	Flow ID
items[].flowType	int	Flow type
items[].flowTypeText	string	Flow type description
items[].quantity	number	Change; positive is an increase, negative a decrease
items[].currency	string	Currency, USDT
items[].postOn	string	Time
items[].balance	number	Available balance after the change
items[].freeze	number	Frozen amount after the change
items[].fees	number	Fee
items[].orderNo	string	Related platform order number
items[].remark	string	Remark
items[].isForceRelease	bool	Whether it was a forced release
items[].operatorId	int	Operator (only for platform back-office actions)

Common flow types

flowType	Description
0	Fee
1	Pay-in
2	Payout
3	Deposit
5	Withdrawal (crypto)
15	Freeze
16	Unfreeze
17	Withdrawal fee
22	Payout refused
23	Payout cancelled
28	Payout fee
10 / 12	Back-office credit / deduction
36 / 37	Reversal deduction / refund

For other types, see flowTypeText.

Common errors

40000: period missing, end not after begin, or longer than 24 hours (see message).