税务记录

获取统一账户税务记录

GET

https://api.bitget.com

/api/v3/tax/records

限频规则: 1次/秒/UID

数据查询范围： 366天

访问要求：请通过税务API Key访问。创建入口。

获取统一账户税务记录 › Request Parameters

bizType

string · required

产品类型

SPOT 现货交易

MARGIN 杠杆交易

USDT-FUTURES USDT合约

COIN-FUTURES 币本位合约

USDC-FUTURES USDC合约

OTHER 其它

startTime

string · required

开始时间戳

Unix时间戳的毫秒数格式，如 1597026383085

endTime

string · required

结束时间戳

Unix时间戳的毫秒数格式，如 1597026383085

startTime和endTime间隔不超过7天

marginType

string

杠杆类型

isolated逐仓杠杆

crossed全仓杠杆

当category=MARGIN时，该字段生效

如不填，默认为crossed全仓杠杆

coin

string

币种名称

如不填，则返回全部币种税务记录

limit

string

每页条目数

如不填，默认值为500。最大值为500

cursor

string

游标ID

用于翻页，首次查询不传

查询第二页及后续数据时，取上一次查询返回的id，接口会返回下一页的数据

获取统一账户税务记录 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object[]

id

string

税务ID

coin

string

币种

type

string

税务类型

详细类型参考枚举页面获取

amount

string

数量

单位为coin

fee

string

手续费

单位为coin

balance

string

账户余额

单位为coin

ts

string

该记录产生时间

Unix毫秒时间戳

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

https://api.bitget.com

/api/v3/tax/records

限频规则: 1次/秒/UID

数据查询范围： 366天

访问要求：请通过税务API Key访问。创建入口。

获取统一账户税务记录 › Request Parameters

bizType

string · required

产品类型

SPOT 现货交易

MARGIN 杠杆交易

USDT-FUTURES USDT合约

COIN-FUTURES 币本位合约

USDC-FUTURES USDC合约

OTHER 其它

startTime

string · required

开始时间戳

Unix时间戳的毫秒数格式，如 1597026383085

endTime

string · required

结束时间戳

Unix时间戳的毫秒数格式，如 1597026383085

startTime和endTime间隔不超过7天

marginType

string

杠杆类型

isolated逐仓杠杆

crossed全仓杠杆

当category=MARGIN时，该字段生效

如不填，默认为crossed全仓杠杆

coin

string

币种名称

如不填，则返回全部币种税务记录

limit

string

每页条目数

如不填，默认值为500。最大值为500

cursor

string

游标ID

用于翻页，首次查询不传

查询第二页及后续数据时，取上一次查询返回的id，接口会返回下一页的数据

获取统一账户税务记录 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object[]

id

string

税务ID

coin

string

币种

type

string

税务类型

详细类型参考枚举页面获取

amount

string

数量

单位为coin

fee

string

手续费

单位为coin

balance

string

账户余额

单位为coin

ts

string

该记录产生时间

Unix毫秒时间戳