Tax Records

Get Unified Account Tax Records

GET

https://api.bitget.com

/api/v3/tax/records

Rate limit: 1/sec/UID

Data query range: 366 days

Access requirements: Please use the tax API Key to request. Creation Portal.

Get Unified Account Tax Records › Request Parameters

bizType

string · required

Product type SPOT Spot trading MARGIN Margin trading USDT-FUTURES USDT futures COIN-FUTURES Coin-M futures USDC-FUTURES USDC futures OTHER Other

startTime

string · required

Start timestamp A Unix timestamp in milliseconds e.g.,1597026383085

endTime

string · required

End timestamp A Unix timestamp in milliseconds e.g.,1597026383185 The time range between startTime and endTime must not exceed 7 days

marginType

string

Margin Type isolated isolated margin crossed cross margin This field is effective when category=MARGIN. If not specified, the default is crossed (cross margin).

coin

string

Coin name If not specified, tax records for all coins will be returned.

limit

string

Limit per page Default: 500. Maximum: 500

cursor

string

Cursor ID Used for pagination. Do not include it for the first query. When querying the second page and subsequent data, use the id returned from the previous query. The interface will then return the data for the next page.

Get Unified Account Tax Records › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object[]

id

string

Tax record id

coin

string

Coin name

type

string

Tax Type Refer to the Enumeration page for detailed types.

amount

string

Amount The unit is coin

fee

string

Fee The unit is coin

balance

string

Balance The unit is coin

ts

string

The timestamp that system generated the data A Unix millisecond timestamp.

GET/api/v3/tax/records

curl 'https://api.bitget.com/api/v3/tax/records?bizType=<string>&startTime=<string>&endTime=<string>'

Example Responses

{
  "code": "00000",
  "msg": "success",
  "requestTime": 1763688181556,
  "data": [
    {
      "id": "1375573238088888369",
      "coin": "USDT",
      "type": "ORDER_DEALT_FROZEN_OUT",
      "amount": "-1.9998656",
      "fee": "0",
      "balance": "42.41856383400698",
      "ts": "1763688137552"
    },
    {
      "id": "1375573238088888368",
      "coin": "BGB",
      "type": "ORDER_PLF_FEE_OUT",
      "amount": "-0.0004556178732628",
      "fee": "0",
      "balance": "2.1598531923916739",
      "ts": "1763688137552"
    },
    {
      "id": "1375573238088888367",
      "coin": "BGB",
      "type": "ORDER_DEALT_IN",
      "amount": "0.5696",
      "fee": "0",
      "balance": "2.1603088102649367",
      "ts": "1763688137552"
    }
  ]
}

json

application/json

Get Unified Account Tax Records

GET

https://api.bitget.com

/api/v3/tax/records

Rate limit: 1/sec/UID

Data query range: 366 days

Access requirements: Please use the tax API Key to request. Creation Portal.

Get Unified Account Tax Records › Request Parameters

bizType

string · required

Product type SPOT Spot trading MARGIN Margin trading USDT-FUTURES USDT futures COIN-FUTURES Coin-M futures USDC-FUTURES USDC futures OTHER Other

startTime

string · required

Start timestamp A Unix timestamp in milliseconds e.g.,1597026383085

endTime

string · required

End timestamp A Unix timestamp in milliseconds e.g.,1597026383185 The time range between startTime and endTime must not exceed 7 days

marginType

string

Margin Type isolated isolated margin crossed cross margin This field is effective when category=MARGIN. If not specified, the default is crossed (cross margin).

coin

string

Coin name If not specified, tax records for all coins will be returned.

limit

string

Limit per page Default: 500. Maximum: 500

cursor

string

Get Unified Account Tax Records › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object[]

id

string

Tax record id

coin

string

Coin name

type

string

Tax Type Refer to the Enumeration page for detailed types.

amount

string

Amount The unit is coin

fee

string

Fee The unit is coin

balance

string

Balance The unit is coin

ts

string

The timestamp that system generated the data A Unix millisecond timestamp.