Bitget APIBitget API
统一账户经典账户
旧文档
  • 概览
  • API 文档
  • WebSocket
  • Agent Hub
  • SDK
  • 更新日志
Copied to clipboard
接口文档
经典账户
    税务
      合约财务记录get杠杆财务记录get现货财务记录getP2P财务记录get
经典账户 · 税务 API
经典账户 · 税务 API

税务

经典账户 — 税务


合约财务记录

GET
https://api.bitget.com
/api/v2/tax/future-record

限速规则 1次/1s (UID)

合约财务记录

合约财务记录 › Request Parameters

startTime
​string · required

开始时间 (时间戳毫秒)

endTime
​string · required

结束时间 (时间戳毫秒) 与 startTime 最大范围30天

productType
​string

产品类型, 默认USDT-FUTURES

USDT-FUTURES U本位合约

COIN-FUTURES 币本位合约

USDC-FUTURES USDC合约

marginCoin
​string

默认全部保证金币种

limit
​string

默认500 最大500

idLessThan
​string

最后一条记录的ID

合约财务记录 › Response Parameters

200

Successful response

code
​string
msg
​string
requestTime
​integer
​object[]
id
​string

财务记录ID

symbol
​string

交易对

marginCoin
​string

保证金币种

futureTaxType
​string

合约财务类型

TRANSFER_IN 资金转入

TRANSFER_OUT 资金转出

ORDER_DEALT_FROZEN_OUT 卖出

ORDER_DEALT_IN 买入

ORDER_PLF_FEE_OUT 手续费抵扣

EXCHANGE_SOURCE_TOKEN_USER_OUT 兑出

EXCHANGE_TARGET_TOKEN_USER_IN 兑入

OPEN_LONG 开多

OPEN_SHORT 开空

BUY_DEAL 买多

SELL_DEAL 卖空

CLOSE_LONG 平多

CLOSE_SHORT 平空

FORCE_CLOSE_LONG 强制减多

FORCE_CLOSE_SHORT 强制减空

BURST_CLOSE_LONG 爆仓平多

BURST_CLOSE_SHORT 爆仓平空

OFFSET_REDUCE_CLOSE_LONG 扎差减多

OFFSET_REDUCE_CLOSE_SHORT 扎差减空

FORCE_BUY_SSM 强制买入

FORCE_SELL_SSM 强制卖出

BURST_BUY_SSM 爆仓买入

BURST_SELL_SSM 爆仓卖出

RISK_LIQ_USER_IN 清算还款

INTEREST_SETTLEMENT_OUT 扣息

CONTRACT_MAIN_SETTLE_FEE_USER_IN 资金费用收取

CONTRACT_MAIN_SETTLE_FEE_USER_OUT 资金费用扣除

RISK_LIQ_USER_OUT 负债清算转出

amount
​string

数量

fee
​string

手续费

ts
​string

该记录产生时间,毫秒时间戳

GET/api/v2/tax/future-record
curl 'https://api.bitget.com/api/v2/tax/future-record?startTime=<string>&endTime=<string>'
Example Responses
{ "code": "00000", "msg": "success", "requestTime": 1687257612262, "data": [ { "id": "1", "symbol": "TRXUSDT", "marginCoin": "USDT", "futureTaxType": "close_long", "amount": "0.10545", "fee": "-0.02134863", "ts": "1679909309766" } ] }
json
application/json

杠杆财务记录

GET
https://api.bitget.com
/api/v2/tax/margin-record

限速规则 1次/1s (UID)

杠杆财务记录

杠杆财务记录 › Request Parameters

startTime
​string · required

开始时间(时间戳毫秒)

endTime
​string · required

结束时间 (时间戳毫秒) 与 startTime 最大范围30天

marginType
​string

杠杆类型

isolated:逐仓

crossed:全仓(默认)

coin
​string

默认全部币种

limit
​string

默认500 最大500

idLessThan
​string

最后一条记录的ID

杠杆财务记录 › Response Parameters

200

Successful response

code
​string
msg
​string
requestTime
​integer
​object[]
id
​string

记录id

coin
​string

币种

symbol
​string

交易对

marginTaxType
​string

transfer_in 账户转入

transfer_out账户转出

borrow借款

repay 还款

liquidation_fee爆仓清算费

compensate风险基金穿仓补偿

deal_in 杠杆 成交入帐 买入

deal_out杠杆 成交扣除 卖出

interest_repay归还利息

confiscated穿仓扣除

exchange_in兑换收入

exchange_out兑换支出

amount
​string

数量

fee
​string

手续费

total
​string

账户总额

ts
​string

记录产生时间, Unix毫秒时间戳

GET/api/v2/tax/margin-record
curl 'https://api.bitget.com/api/v2/tax/margin-record?startTime=<string>&endTime=<string>'
Example Responses
{ "code": "00000", "msg": "success", "requestTime": 1687259242290, "data": [ { "id": "1", "coin": "USDT", "marginTaxType": "transfer_in", "amount": "13333", "fee": "0", "total": "13333", "symbol": "BTCUSDT", "ts": "1686129284474" } ] }
json
application/json

现货财务记录

GET
https://api.bitget.com
/api/v2/tax/spot-record

限速规则 1次/1s (UID)

现货财务记录

现货财务记录 › Request Parameters

startTime
​string · required

开始时间,Unix毫秒时间戳

endTime
​string · required

结束时间,Unix毫秒时间戳

startTime与endTime的间隔最大为30天

coin
​string

币种默认全部

limit
​string

默认500 最大500

idLessThan
​string

最后一条记录的ID

现货财务记录 › Response Parameters

200

Successful response

code
​string
msg
​string
requestTime
​integer
​object[]
id
​string

记录ID

coin
​string

币种

spotTaxType
​string

现货财务类型

Deposit

Withdrawal

User fees

Fiat withdrawal success - Deduct

Sell

Buy

Transaction fee deduct

Strategic purchase-user accounts

Subscribe to trader-user accounts

System charges fees

Strategic refund-User account

Subscription fee refund-user account

Strategic Income-Traders' accounts

Crypto Voucher Distribution

Copy Trade expense

Judicial recall

Copy Trade profit

Refund Copy Trade commission

Buy Crypto

Deduction of judicial recall

Buy with card

Airdrop Reward-B

Decrease due to ETF settlement

Increase due to ETF settlement

System lock-up

User lock-up

Trading fee rebate

Manage background lock positions

Automatic deposit

Automatic withdrawal

Deposit from strategy account

Withdraw to strategy account

Lotto rewards

User contract trial fund

User contract simulation fund

Delegate

Undelegate

un_delegate_user_out

delegate_user_account_in

delegate_user_account_out

settle_user_account_receive_in

delegate_user_account_payable_out

Rebate rewards

Consumption

Gains

Unlock locked order

Deduction

Return

Release

Repayment

Forced liquidation return

The locked order is returned to the system

Failed

Withdrawal frozen

Mirror fund

Supplement fund

Reduce fund

Settlement out

Withdrawal unfreeze

Ordinary Withdrawal

Fast withdrawal fee

Airdrop Reward-A

Subscribe

Interest

Penalty

Redemption

Activity fund(USDT-Ⓜ)

Activity fund

Activity fund(Coin-Ⓜ)

Increase exchange rate

Reduce exchange rate

Transfer in

Activity issuance

Transfer out

Super account

Exchange spending

Exchange income

Sent

Received

MegaSwap Transfer in

MegaSwap Transfer out

Channel referral rewards

System account

Sell Crypto

Fiat deposit

amount
​string

数量

fee
​string

手续费

balance
​string

账户总额

ts
​string

该记录产生时间 时间戳

bizOrderId
​string

业务订单编号

GET/api/v2/tax/spot-record
curl 'https://api.bitget.com/api/v2/tax/spot-record?startTime=<string>&endTime=<string>'
Example Responses
{ "code": "00000", "msg": "success", "requestTime": 1687257612262, "data": [ { "id": "1", "coin": "AIBB", "spotTaxType": "Interest", "amount": "6018333.33333333", "fee": "0", "balance": "468575833.33333306", "bizOrderId": "1333333333333333333", "ts": "1686128884851" } ] }
json
application/json

P2P财务记录

GET
https://api.bitget.com
/api/v2/tax/p2p-record

限速规则 1次/1s (UID)

p2p财务记录

P2P财务记录 › Request Parameters

startTime
​string · required

开始时间 (时间戳毫秒)

endTime
​string · required

结束时间 (时间戳毫秒) 与 startTime 最大范围30天

coin
​string

币种默认全部币种

limit
​string

默认500 最大500

idLessThan
​string

最后一条记录的ID

P2P财务记录 › Response Parameters

200

Successful response

code
​string
msg
​string
requestTime
​integer
​object[]
id
​string

记录id lastEndId

coin
​string

币种

p2pTaxType
​string

p2p税务类型

transfer_in 账户转入

transfer_out 账户转出

sell卖出

buy买入

balance
​string

数量

ts
​string

记录产生时间, Unix毫秒时间戳

GET/api/v2/tax/p2p-record
curl 'https://api.bitget.com/api/v2/tax/p2p-record?startTime=<string>&endTime=<string>'
Example Responses
{ "code": "00000", "msg": "success", "requestTime": 1687260620793, "data": [ { "id": "152526631", "coin": "USDT", "p2pTaxType": "transfer-in", "balance": "1", "ts": "1755846320684" } ] }
json
application/json