获取统一账户税务记录

描述

数据查询范围： 366天

HTTP请求

• GET /api/v3/tax/records
• 限频规则: 1次/秒/UID
• 请通过税务API Key访问 创建入口

请求示例

curl "https://api.bitget.com/api/v3/tax/records?bizType=spot&startTime=1763402983000&endTime=1763662183573" \
   -H "ACCESS-KEY:*******" \
   -H "ACCESS-SIGN:*" \
   -H "ACCESS-PASSPHRASE:*" \
   -H "ACCESS-TIMESTAMP:1659076670000" \
   -H "locale:en-US" \
   -H "Content-Type: application/json" 

请求参数

参数名	参数类型	是否必须	描述
bizType	String	是	产品类型 SPOT 现货交易 MARGIN 杠杆交易 USDT-FUTURES USDT合约 COIN-FUTURES 币本位合约 USDC-FUTURES USDC合约 OTHER 其它
marginType	String	否	杠杆类型 isolated逐仓杠杆 crossed全仓杠杆 - 当category=MARGIN时，该字段生效 - 如不填，默认为crossed全仓杠杆
coin	String	否	币种名称 - 如不填，则返回全部币种税务记录
startTime	String	是	开始时间戳 Unix时间戳的毫秒数格式，如 1597026383085
endTime	String	是	结束时间戳 Unix时间戳的毫秒数格式，如 1597026383085 startTime和endTime间隔不超过7天
limit	String	否	每页条目数 - 如不填，默认值为500。最大值为500
cursor	String	否	游标ID - 用于翻页，首次查询不传 - 查询第二页及后续数据时，取上一次查询返回的id，接口会返回下一页的数据

返回示例

{
  "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"
    }
  ]
}

返回参数

返回字段	参数类型	字段说明
id	String	税务ID
coin	String	币种
type	String	税务类型 详细类型参考枚举页面获取
amount	String	数量 - 单位为coin
fee	String	手续费 - 单位为coin
balance	String	账户余额 - 单位为coin
ts	String	该记录产生时间 - Unix毫秒时间戳