Bitget APIBitget API
UTAClassic
Legacy Doc
  • Overview
  • API Documentation
  • WebSocket
  • Agent Hub
  • SDK
  • Changelog
Copied to clipboard
Tax
    Tax Records
      Get Unified Account Tax Recordsget
Tax
Tax

Tax Records

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