Get Account Ledgers - Futures

Description

This interface can query the ledger records of the futures business line.

Tips

If there are open positions, the status of the first page returned will be Pending, indicating the realized profit and loss in the current 8-hour settlement period. Please specify the minimum offset number of the current page into the offset field to move to the next page.

Tips

Supplementary instructions for startAt and endAt: startAt must be less than endAt; and the interval cannot exceed 1 day; only one field is allowed, and if only one field is passed, another field will be automatically added or subtracted by the system 1 day to complete

Request

Query Params

currency

string

optional

Currency of transaction history, XBT or USDT

Example:

XBT

type

string

optional

Type RealizedPNL-Realized profit and loss, Deposit-Deposit, Withdrawal-withdraw, Transferin-Transfer in, TransferOut-Transfer out

Example:

Transferin

offset

integer <int64>

optional

Start offset. Generally, only the attributes of the last returned result of the previous request are used, and the first page is returned by default

Example:

254062248624417

forward

boolean

optional

This parameter functions to judge whether the lookup is forward or not. True means “yes” and False means “no”. This parameter is set as true by default.

Default:

true

Example:

false

maxCount

integer <int64>

optional

Displayed size per page. The default size is 50

Default:

Example:

startAt

integer <int64>

optional

Start time (milliseconds)

Example:

1728663338000

endAt

integer <int64>

optional

End time (milliseconds)

Example:

1728692138000

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200OK

application/json

Body

code

string

required

data

object

required

dataList

array [object {9}]

required

hasMore

boolean

required

Is it the last page? If it is false, it means it is the last page, and if it is true, it means you need to move to the next page.

Example

{
  "code": "200000",
  "data": {
    "dataList": [
      {
        "time": 1728665747000,
        "type": "TransferIn",
        "amount": 0.01,
        "fee": 0,
        "accountEquity": 14.02924938,
        "status": "Completed",
        "remark": "Transferred from High-Frequency Trading Account",
        "offset": 51360793,
        "currency": "USDT"
      },
      {
        "time": 1728648000000,
        "type": "RealisedPNL",
        "amount": 0.00630042,
        "fee": 0,
        "accountEquity": 20,
        "status": "Completed",
        "remark": "XBTUSDTM",
        "offset": 51352430,
        "currency": "USDT"
      }
    ],
    "hasMore": false
  }
}