Bitget APIBitget API
统一账户经典账户
旧文档
  • 概览
  • API 文档
  • WebSocket
  • Agent Hub
  • SDK
  • 更新日志
Copied to clipboard
账户
    资产与余额
      获取账户资产get获取资金账户资产get获取财务记录get获取资金账户财务流水get获取交易手续费get获取最大可转出get获取最大可提币数量get设置抵押品模式post获取抵押品模式get获取自定义抵押品支持币种get
    账户设置
      获取账户信息get获取账户设置get预设置调整杠杆get调整杠杆post调整持仓模式post设置BGB抵扣post获取BGB抵扣状态get账户切换post获取切换状态get调整保证金post获取Delta模式信息get账户模式切换post
    杠杆与借贷管理
      获取可还币种get获取支付币种get还款post获取兑换记录get
    交易风控与仓位设置
      获取OI限仓get获取业务线所有交易对手续费get获取准入用户杠杆交易对get获取准入用户杠杆梯度档位get获取准入用户借币数据get获取准入用户币种折扣率梯度get
    子账户
      新建子账户post冻结/解冻子账户post查询子账户列表get查询子账户统一账户资产get新建子账户API Keypost修改子账户API Keypost删除子账户API Keypost查询子账户API Key列表get创建 Agent 子账户post
    充值提币划转
      设置充值账户post获取充值地址get获取子账户充值地址get获取充值记录get获取子账户充值记录get提币post撤销提币post获取提币记录get查询提币地址簿get获取可划转币种get划转post子母划转post获取子母划转记录get子账户主动划转至母账户post
    小额资产兑换
      获取小额兑换历史记录get获取小额兑换可兑换币种get执行小额兑换post
    机构限频
      获取限频配额get设置限频配额post
账户
账户

小额资产兑换

小额资产兑换


获取小额兑换历史记录

GET
https://api.bitget.com
/api/v3/convert/small-assets-history

查询统一账户下的历史小额兑换订单,支持时间范围筛选与游标分页。支持查询近90天数据,单次查询时间范围最大30天。

  • 限频规则: 10次/秒/UID
  • 需要统一账户管理只读权限

获取小额兑换历史记录 › Request Parameters

orderId
​string

兑换订单ID

startTime
​string

开始时间 Unix毫秒时间戳 支持查询近90天数据,单次查询时间范围最大30天

endTime
​string

结束时间 Unix毫秒时间戳 支持查询近90天数据,单次查询时间范围最大30天

limit
​string

每页条目数 默认值20,最大100

cursor
​string

游标ID 用于翻页。首次查询不传,查询第二页及后面的数据时,取上一次查询返回的最小orderId,结果会返回小于该值的数据;可以缩短查询响应时间

获取小额兑换历史记录 › Response Parameters

200

Successful response

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

列表

status
​string

兑换状态

  • success 成功
createdTime
​string

兑换时间

GET/api/v3/convert/small-assets-history
curl https://api.bitget.com/api/v3/convert/small-assets-history
Example Responses
{ "code": "00000", "msg": "success", "requestTime": 1740000000000, "data": { "list": [ { "orderId": "1234567890123456789", "fromCoin": "DOGE", "fromAmount": "12.5", "fromCoinPrice": "0.064", "toCoin": "BGB", "toAmount": "0.8", "toCoinPrice": "0.8", "feeDetail": { "fee": "0.0008", "feeCoin": "BGB" }, "status": "success", "createdTime": "1740000000000" } ], "cursor": "1234567890123456789" } }
json
application/json

获取小额兑换可兑换币种

GET
https://api.bitget.com
/api/v3/convert/small-assets

查询统一账户下当前账户内持有的小额资产列表。小额资产定义为折合 USDT 价值低于5U的持仓。目标币种支持 BGB。

  • 限频规则: 10次/秒/UID
  • 需要统一账户管理只读权限

获取小额兑换可兑换币种 › Response Parameters

200

Successful response

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

币种名称

available
​string

币种账户可用

estimatedCoin
​string

预期兑换币种

  • BGB
estimatedAmount
​string

预期兑换数量

​object

手续费明细

cTime
​string

当前时间

GET/api/v3/convert/small-assets
curl https://api.bitget.com/api/v3/convert/small-assets
Example Responses
{ "code": "00000", "msg": "success", "requestTime": 1740000000000, "data": [ { "coin": "DOGE", "available": "12.5", "estimatedCoin": "BGB", "estimatedAmount": "0.8", "feeDetail": { "feeRate": "0.001", "fee": "0.0008" }, "cTime": "1740000000000" } ] }
json
application/json

执行小额兑换

POST
https://api.bitget.com
/api/v3/convert/small-assets-trade

将统一账户内指定的一种或多种小额资产一键兑换为目标币种。

  • 限频规则: 10次/秒/UID
  • 需要统一账户交易权限

执行小额兑换 › Request Parameters

fromCoinList
​string[] · required

兑换币种

执行小额兑换 › Response Parameters

200

Successful response

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

兑换币种

toCoin
​string

目标币种

orderId
​string

兑换订单Id

POST/api/v3/convert/small-assets-trade
curl https://api.bitget.com/api/v3/convert/small-assets-trade \ --request POST \ --header 'Content-Type: application/json' \ --data '{ "fromCoinList": [ "string" ] }'
Example Request Body
{ "fromCoinList": [ "string" ] }
json
Example Responses
{ "code": "00000", "msg": "success", "requestTime": 1740000000000, "data": { "fromCoin": [ "DOGE", "XRP" ], "toCoin": "BGB", "orderId": "1234567890123456789" } }
json
application/json

充值提币划转机构限频