Bitget APIBitget API
统一账户经典账户
旧文档
  • 概览
  • API 文档
  • WebSocket
  • Agent Hub
  • SDK
  • 更新日志
Copied to clipboard
质押借贷
    质押借贷
      查询支持质押币种get查询预估利息及可借数量get借币post查询当前借币get查询借币历史get还款post查询还款历史get调整质押率post查询质押率历史get查询强平记录get查询资产负债get
质押借贷
质押借贷

质押借贷

质押借贷


查询支持质押币种

GET
https://api.bitget.com
/api/v3/loan/coins

限频规则: 10次/秒/UID

查询支持质押币种

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

查询支持质押币种 › Request Parameters

coin
​string

币种名称

查询支持质押币种 › Response Parameters

200

Successful response

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

可借币种列表

>coin
​string

可借币种

>hourRateFlexible
​string

活期利率每小时百分比

>rateFlexible
​string

活期利率年化百分比

>hourRate7D
​string

7天固定利率每小时百分比

>rate7D
​string

7天固定利率年化百分比

>hourRate30D
​string

30天固定利率每小时百分比

>rate30D
​string

30天固定利率年化百分比

>minBorrowLimit
​string

最小可借限额 单位为USDT

>maxBorrowLimit
​string

最大可借限额 单位为USDT

>minBorrowAmount
​string

最小可借数量

>maxBorrowAmount
​string

最大可借数量

pledgeInfos
​string[]

可抵押币种列表

>initRate
​string

初始质押率百分比

>supRate
​string

补保质押率百分比

>forceRate
​string

强平质押率百分比

>minPledgeAmount
​string

最小质押限额 单位为USDT

>maxPledgeAmount
​string

最大质押限额 单位为USDT

GET/api/v3/loan/coins
curl https://api.bitget.com/api/v3/loan/coins
Example Responses
{ "code": "00000", "msg": "success", "requestTime": 1770092353766, "data": { "loanInfos": [ { "coin": "USDT", "hourRateFlexible": "0.00000349", "rateFlexible": "0.0305", "hourRate7D": "0.00000366", "rate7D": "0.032024937", "hourRate30D": "0.00000383", "rate30D": "0.033549934", "minBorrowAmount": "1", "maxBorrowAmount": "20000000", "minBorrowLimit": "1", "maxBorrowLimit": "20000000" } ], "pledgeInfos": [ { "coin": "BGB", "initRate": "0.65", "supRate": "0.75", "forceRate": "0.91", "minPledgeAmount": "0", "maxPledgeAmount": "400000" } ] } }
json
application/json

查询预估利息及可借数量

GET
https://api.bitget.com
/api/v3/loan/interest

限频规则: 10次/秒/UID

查询预估利息及可借数量

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

查询预估利息及可借数量 › Request Parameters

loanCoin
​string · required

需借币种 如BTC

pledgeCoin
​string · required

质押币种 如ETH

daily
​string · required

质押天数 SEVEN 7天 THIRTY30天 FLEXIBLE活期

pledgeAmount
​string · required

质押数量

查询预估利息及可借数量 › Response Parameters

200

Successful response

code
​string
msg
​string
requestTime
​integer
​object
hourInterest
​string

每小时预估利息数量

loanAmount
​string

可借数量

GET/api/v3/loan/interest
curl 'https://api.bitget.com/api/v3/loan/interest?loanCoin=<string>&pledgeCoin=<string>&daily=<string>&pledgeAmount=<string>'
Example Responses
{ "code": "00000", "msg": "success", "requestTime": 1770094037638, "data": { "hourInterest": "0.00000001", "loanAmount": "0.01935842" } }
json
application/json

借币

POST
https://api.bitget.com
/api/v3/loan/borrow

限频规则: 10次/秒/UID

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

借币 › Request Parameters

loanCoin
​string · required

需借币种 如BTC

pledgeCoin
​string · required

质押币种 如ETH

daily
​string · required

质押天数 SEVEN 7天 THIRTY30天 FLEXIBLE活期

pledgeAmount
​string

质押数量 与loanAmount二选一

loanAmount
​string

借币数量 与pledgeAmount二选一

借币 › Response Parameters

200

Successful response

code
​string
msg
​string
requestTime
​integer
​object
orderId
​string

订单ID

POST/api/v3/loan/borrow
curl https://api.bitget.com/api/v3/loan/borrow \ --request POST \ --header 'Content-Type: application/json' \ --data '{ "loanCoin": "BTC", "pledgeCoin": "ETH", "daily": "SEVEN", "pledgeAmount": "1" }'
Example Request Body
{ "loanCoin": "BTC", "pledgeCoin": "ETH", "daily": "SEVEN", "pledgeAmount": "1" }
json
application/json
Example Responses
{ "code": "00000", "msg": "success", "requestTime": 1745725444960, "data": { "orderId": "12345678" } }
json
application/json

查询当前借币

GET
https://api.bitget.com
/api/v3/loan/borrow-ongoing

限频规则: 10次/秒/UID

查询当前借币

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

查询当前借币 › Request Parameters

orderId
​string

订单ID

loanCoin
​string

负债币种

pledgeCoin
​string

质押币种

查询当前借币 › Response Parameters

200

Successful response

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

当前借币列表

orderId
​string

订单ID

loanCoin
​string

负债币种

loanAmount
​string

负债数量

interestAmount
​string

已产生利息数量

hourInterestRate
​string

小时利率百分比

pledgeCoin
​string

质押币种

pledgeAmount
​string

质押数量

pledgeRate
​string

质押率百分比

supRate
​string

补保质押率百分比

forceRate
​string

强平质押率百分比

borrowTime
​string

借币时间 Unix毫秒时间戳

expireTime
​string

到期时间 Unix毫秒时间戳

GET/api/v3/loan/borrow-ongoing
curl https://api.bitget.com/api/v3/loan/borrow-ongoing
Example Responses
{ "code": "00000", "msg": "success", "requestTime": 1770185712179, "data": [ { "orderId": "123456789010111", "loanCoin": "USDT", "loanAmount": "1.00032276", "interestAmount": "0.00000339", "hourInterestRate": "0.000338", "pledgeCoin": "BGB", "pledgeAmount": "0.42325892", "pledgeRate": "77.97", "supRate": "85", "forceRate": "91", "borrowTime": "1770185278083", "expireTime": "0" } ] }
json
application/json

查询借币历史

GET
https://api.bitget.com
/api/v3/loan/borrow-history

限频规则: 10次/秒/UID

查询借币历史

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

查询借币历史 › Request Parameters

startTime
​string · required

开始时间 仅支持查询近三个月数据

endTime
​string · required

结束时间

orderId
​string

订单ID

loanCoin
​string

负债币种

pledgeCoin
​string

质押币种

status
​string

状态 ROLLBACK: 失败 FORCE: 强平 REPAY: 已还款

pageNum
​string

页码 默认值1

pageSize
​string

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

查询借币历史 › Response Parameters

200

Successful response

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

借币历史列表

loanCoin
​string

已借币种

pledgeCoin
​string

质押币种

orderId
​string

订单ID

initPledgeAmount
​string

初始化质押数量

initLoanAmount
​string

初始化借币数量

hourRate
​string

每小时利率百分比

pledgeDays
​string

质押借贷天数

borrowTime
​string

借币时间

status
​string

状态 ROLLBACK: 失败 FORCE: 强平 REPAY: 已还款

daily
​string

借贷类型 FLEXIBLE 活期借贷

GET/api/v3/loan/borrow-history
curl 'https://api.bitget.com/api/v3/loan/borrow-history?startTime=<string>&endTime=<string>'
Example Responses
{ "code": "00000", "msg": "success", "requestTime": 1770185989134, "data": [ { "orderId": "12353453556666555111", "loanCoin": "USDT", "pledgeCoin": "BGB", "initPledgeAmount": "0.42325892", "initLoanAmount": "1.00032276", "hourRate": "0.000338", "daily": "FLEXIBLE", "borrowTime": "1770185278083", "status": "repay" } ] }
json
application/json

还款

POST
https://api.bitget.com
/api/v3/loan/repay

限频规则: 10次/秒/UID

还款

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

还款 › Request Parameters

orderId
​string · required

订单ID

repayAll
​string · required

是否全部还款 yes是 no否 如果选择全部还款,则忽略还款数量

amount
​string

还款数量 repayAll=no时,该字段必填

repayUnlock
​string

是否取回抵押品 yes取回 no不取回 如不填写,默认值为no 当repayAll=yes时,该参数不生效

还款 › Response Parameters

200

Successful response

code
​string
msg
​string
requestTime
​integer
​object
loanCoin
​string

借款币种

pledgeCoin
​string

质押币种

repayAmount
​string

还款数量

payInterest
​string

借币币种支付利息数量

repayLoanAmount
​string

借币币种归还本金数量

repayUnlockAmount
​string

赎回数量

POST/api/v3/loan/repay
curl https://api.bitget.com/api/v3/loan/repay \ --request POST \ --header 'Content-Type: application/json' \ --data '{ "orderId": "BTC", "repayAll": "yes" }'
Example Request Body
{ "orderId": "BTC", "repayAll": "yes" }
json
application/json
Example Responses
{ "code": "00000", "msg": "success", "requestTime": 1770191055753, "data": { "loanCoin": "USDT", "pledgeCoin": "BGB", "repayAmount": "1.00000713", "payInterest": "0.00000712", "repayLoanAmount": "1.00000001", "repayUnlockAmount": "0.50791233" } }
json
application/json

查询还款历史

GET
https://api.bitget.com
/api/v3/loan/repay-history

限频规则: 10次/秒/UID

查询还款历史

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

查询还款历史 › Request Parameters

startTime
​string · required

开始时间 仅支持查询近三个月数据

endTime
​string · required

结束时间

orderId
​string

订单ID

loanCoin
​string

负债币种

pledgeCoin
​string

质押币种

pageNum
​string

页码 默认值1

pageSize
​string

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

查询还款历史 › Response Parameters

200

Successful response

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

还款历史列表

orderId
​string

订单ID

loanCoin
​string

已借币种

pledgeCoin
​string

质押币种

repayAmount
​string

还款数量

payInterest
​string

借币币种支付利息数量

repayLoanAmount
​string

借币币种归还本金数量

repayUnlockAmount
​string

赎回数量

repayTime
​string

还款时间

GET/api/v3/loan/repay-history
curl 'https://api.bitget.com/api/v3/loan/repay-history?startTime=<string>&endTime=<string>'
Example Responses
{ "code": "00000", "msg": "success", "requestTime": 1770191679104, "data": [ { "orderId": "1402828485131935745", "loanCoin": "USDT", "pledgeCoin": "BGB", "repayAmount": "1.00000713", "payInterest": "0.00000712", "repayLoanAmount": "1.00000001", "repayUnlockAmount": "0.50791233", "repayTime": "1770191055789" } ] }
json
application/json

调整质押率

POST
https://api.bitget.com
/api/v3/loan/revise-pledge

限频规则: 10次/秒/UID

调整质押率

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

调整质押率 › Request Parameters

orderId
​string · required

订单ID

amount
​string · required

调整数量

pledgeCoin
​string · required

质押币种

reviseType
​string

调整类型 OUT: 提取质押品 IN 补充质押品

调整质押率 › Response Parameters

200

Successful response

code
​string
msg
​string
requestTime
​integer
​object
loanCoin
​string

已借币种

pledgeCoin
​string

质押币种

afterPledgeRate
​string

调整后质押利率百分比

POST/api/v3/loan/revise-pledge
curl https://api.bitget.com/api/v3/loan/revise-pledge \ --request POST \ --header 'Content-Type: application/json' \ --data '{ "orderId": "123456788661", "amount": "1", "pledgeCoin": "USDT", "reviseType": "IN" }'
Example Request Body
{ "orderId": "123456788661", "amount": "1", "pledgeCoin": "USDT", "reviseType": "IN" }
json
application/json
Example Responses
{ "code": "00000", "msg": "success", "requestTime": 1770258559506, "data": { "loanCoin": "USDT", "pledgeCoin": "BGB", "afterPledgeRate": "0.15171614" } }
json
application/json

查询质押率历史

GET
https://api.bitget.com
/api/v3/loan/pledge-rate-history

限频规则: 10次/秒/UID

查询质押率历史

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

查询质押率历史 › Request Parameters

startTime
​string · required

开始时间 仅支持查询近三个月数据

endTime
​string · required

结束时间

orderId
​string

订单ID

reviseSide
​string

调整方向 down: 转入调低 up: 转出调高

pledgeCoin
​string

质押币种

pageNum
​string

页码 默认值1

pageSize
​string

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

查询质押率历史 › Response Parameters

200

Successful response

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

质押率调整历史列表

loanCoin
​string

已借币种

pledgeCoin
​string

质押币种

orderId
​string

订单ID

reviseTime
​string

调整时间

reviseSide
​string

调整方向 down: 转入调低 up: 转出调高

reviseAmount
​string

调整数量

afterPledgeRate
​string

调整后质押利率百分比

beforePledgeRate
​string

调整前质押利率百分比

GET/api/v3/loan/pledge-rate-history
curl 'https://api.bitget.com/api/v3/loan/pledge-rate-history?startTime=<string>&endTime=<string>'
Example Responses
{ "code": "00000", "msg": "success", "requestTime": 1770266423848, "data": [ { "loanCoin": "USDT", "pledgeCoin": "BGB", "orderId": "1403131499696791555", "reviseTime": "1770258582049", "reviseSide": "up", "reviseAmount": "1.7", "afterPledgeRate": "64.97", "beforePledgeRate": "15.17" } ] }
json
application/json

查询强平记录

GET
https://api.bitget.com
/api/v3/loan/reduces

限频规则: 10次/秒/UID

查询强平记录

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

查询强平记录 › Request Parameters

startTime
​string · required

开始时间 仅支持查询近三个月数据

endTime
​string · required

结束时间

orderId
​string

订单ID

loanCoin
​string

借贷币种

pledgeCoin
​string

质押币种

status
​string

强平状态 COMPLETE 已强平 WAIT 强平中

pageNum
​string

页码 默认值1

pageSize
​string

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

查询强平记录 › Response Parameters

200

Successful response

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

强平记录列表

orderId
​string

订单ID

loanCoin
​string

已借币种

pledgeCoin
​string

质押币种

reduceTime
​string

强平时间

pledgeRate
​string

强平时质押率百分比

pledgePrice
​string

强平时质押价格

status
​string

强平状态 COMPLETE 已强平 WAIT 强平中

pledgeAmount
​string

强平质押币数量

reduceFee
​string

强平费用

residueAmount
​string

剩余质押币数量

runlockAmount
​string

释放质押币数量

repayLoanAmount
​string

偿还借币欠款

GET/api/v3/loan/reduces
curl 'https://api.bitget.com/api/v3/loan/reduces?startTime=<string>&endTime=<string>'
Example Responses
{ "code": "00000", "msg": "success", "requestTime": 1711697588556, "data": [ { "loanCoin": "ETH", "reduceTime": "1765274978412", "pledgeRate": "60", "pledgeCoin": "USDT", "pledgePrice": "0.00016108", "status": "complete", "pledgeAmount": "100", "reduceFee": "0.00030606", "residueAmount": "0", "runlockAmount": "0", "repayLoanAmount": "0.0096652", "orderId": "1382228549318361088" } ] }
json
application/json

查询资产负债

GET
https://api.bitget.com
/api/v3/loan/debts

限频规则: 10次/秒/UID

查询资产负债

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

查询资产负债 › Response Parameters

200

Successful response

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

负债资产

>coin
​string

负债币种

>amount
​string

负债币种数量 单位为coin

>amountUsdt
​string

负债币种价值 单位为USDT

pledgeInfos
​string[]

质押资产

GET/api/v3/loan/debts
curl https://api.bitget.com/api/v3/loan/debts
Example Responses
{ "code": "00000", "msg": "success", "requestTime": 1770266637419, "data": { "pledgeInfos": [ { "coin": "BGB", "amount": "1.02556765", "amountUsdt": "3.03" } ], "loanInfos": [ { "coin": "USDT", "amount": "2.00009297", "amountUsdt": "2.01" } ] } }
json
application/json