Crypto Loans

Get Loan Coins

GET

https://api.bitget.com

/api/v3/loan/coins

Rate limit: 10/sec/UID

Get Loan Coins

Rate limit: 10/sec/UID
Permission: UTA mgt. (read)

Get Loan Coins › Request Parameters

coin

string

Coin name

Get Loan Coins › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

loanInfos

string[]

List of borrowable coins

>coin

string

Borrowable coin

>hourRateFlexible

string

Flexible hourly interest rate (percentage)

>rateFlexible

string

Flexible APR (annualized percentage)

>hourRate7D

string

7-day fixed hourly interest rate (pct.)

>rate7D

string

7-day fixed APR (annualized percentage)

>hourRate30D

string

30-day fixed hourly interest rate (pct.)

>rate30D

string

30-day fixed APR (annualized percentage)

>minBorrowLimit

string

Minimum borrow limit (in USDT)

>maxBorrowLimit

string

Maximum borrow limit (in USDT)

>minBorrowAmount

string

Minimum borrow amount

>maxBorrowAmount

string

Maximum borrow amount

pledgeInfos

string[]

List of collateralizable coins

>initRate

string

Initial collateral ratio (percentage)

>supRate

string

Margin call (top-up) collateral ratio (pct.)

>forceRate

string

Liquidation collateral ratio (pct.)

>minPledgeAmount

string

Minimum collateral limit (in USDT)

>maxPledgeAmount

string

Maximum collateral limit (in 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 Loan Interest

GET

https://api.bitget.com

/api/v3/loan/interest

Rate limit: 10/sec/UID

Get Loan Interest

Rate limit: 10/sec/UID
Permission: UTA mgt. (read)

Get Loan Interest › Request Parameters

loanCoin

string · required

Coin to borrow e.g.BTC

pledgeCoin

string · required

Collateral coin e.g.ETH

daily

string · required

Pledge term: SEVEN 7 days THIRTY 30 days FLEXIBLE flexible

pledgeAmount

string · required

Pledge Amount

Get Loan Interest › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

hourInterest

string

Estimated interest amount per hour

loanAmount

string

Borrowable amount

Borrow Coins

POST

https://api.bitget.com

/api/v3/loan/borrow

Rate limit: 10/sec/UID

Rate limit: 10/sec/UID
Permission: UTA mgt. (read & write)

Borrow Coins › Request Parameters

loanCoin

string · required

Coin to borrow e.g.BTC

pledgeCoin

string · required

Collateral coin e.g.ETH

daily

string · required

Pledge term: SEVEN 7 days THIRTY 30 days FLEXIBLE flexible

pledgeAmount

string

Collateral amount choose one of pledgeAmount or loanAmount

loanAmount

string

Borrow amount choose one of loanAmount or pledgeAmount

Borrow Coins › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

orderId

string

Order Id

Get Borrow Ongoing

GET

https://api.bitget.com

/api/v3/loan/borrow-ongoing

Rate limit: 10/sec/UID

Get Borrow Ongoing

Rate limit: 10/sec/UID
Permission: UTA mgt. (read)

Get Borrow Ongoing › Request Parameters

orderId

string

Order ID

loanCoin

string

Borrowed coin

pledgeCoin

string

Collateral coin

Get Borrow Ongoing › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object[]

Ongoing borrow order list

orderId

string

Order ID

loanCoin

string

borrowed coin

loanAmount

string

borrowed amount

interestAmount

string

Accrued interest amount

hourInterestRate

string

Hourly interest rate

pledgeCoin

string

Collateral coin

pledgeAmount

string

Collateral amount

pledgeRate

string

Collateral ratio

supRate

string

Margin call (top-up) collateral ratio (pct.)

forceRate

string

Liquidation collateral ratio (pct.)

borrowTime

string

Borrow time Unix timestamp in milliseconds

expireTime

string

Expiry time Unix timestamp in milliseconds

Get Borrow History

GET

https://api.bitget.com

/api/v3/loan/borrow-history

Rate limit: 10/sec/UID

Get Borrow History

Rate limit: 10/sec/UID
Permission: UTA mgt. (read)

Get Borrow History › Request Parameters

startTime

string · required

Start time only supports querying data from the last 3 months

endTime

string · required

End time

orderId

string

Order ID

loanCoin

string

Borrowed coin

pledgeCoin

string

Collateral coin

status

string

Status ROLLBACK: failed FORCE: liquidated REPAY: repaid

pageNum

string

Page number default is 1

pageSize

string

Items per page default is 10, maximum is 100

Get Borrow History › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object[]

Borrow history list

loanCoin

string

Borrowed coin

pledgeCoin

string

Collateral coin

orderId

string

Order ID

initPledgeAmount

string

Initial collateral amount

initLoanAmount

string

Initial borrowed amount

hourRate

string

Hourly interest rate

pledgeDays

string

Pledge/loan term in days

borrowTime

string

Borrow time

status

string

Status ROLLBACK: failed FORCE: liquidated REPAY: repaid

daily

string

Loan term type FLEXIBLE Flexible loan

Repay Coins

POST

https://api.bitget.com

/api/v3/loan/repay

Rate limit: 10/sec/UID

Repay Coins

Rate limit: 10/sec/UID
Permission: UTA mgt. (read & write)

Repay Coins › Request Parameters

orderId

string · required

Order ID

repayAll

string · required

Repay in full yes no If yes, the repayment amount will be ignored

amount

string

Repayment amount Required when repayAll=no

repayUnlock

string

Whether to redeem collateral yesredeem nodo not redeem Default is no if omitted. Not effective when repayAll=yes

Repay Coins › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

loanCoin

string

Borrowed coin

pledgeCoin

string

Collateral coin

repayAmount

string

Repayment amount

payInterest

string

Interest paid (in the borrowed coin)

repayLoanAmount

string

Principal repaid (in the borrowed coin)

repayUnlockAmount

string

Redeemed (unlocked) amount

Get Repay History

GET

https://api.bitget.com

/api/v3/loan/repay-history

Rate limit: 10/sec/UID

Get Repay History

Rate limit: 10/sec/UID
Permission: UTA mgt. (read)

Get Repay History › Request Parameters

startTime

string · required

Start time only supports querying data from the last 3 months

endTime

string · required

End time

orderId

string

Order ID

loanCoin

string

Borrowed coin

pledgeCoin

string

Collateral coin

pageNum

string

Page number default is 1

pageSize

string

Items per page default is 10, maximum is 100

Get Repay History › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object[]

Repay history list

orderId

string

Order ID

loanCoin

string

Borrowed coin

pledgeCoin

string

Collateral coin

repayAmount

string

Repayment amount

payInterest

string

Interest paid (in the borrowed coin)

repayLoanAmount

string

Principal repaid (in the borrowed coin)

repayUnlockAmount

string

Redeemed (unlocked) amount

repayTime

string

Repayment time

Revise Pledge

POST

https://api.bitget.com

/api/v3/loan/revise-pledge

Rate limit: 10/sec/UID

Revise Pledge

Rate limit: 10/sec/UID
Permission: UTA mgt. (read & write)

Revise Pledge › Request Parameters

orderId

string · required

Order ID

amount

string · required

Adjustment amount

pledgeCoin

string · required

Collateral coin

reviseType

string

Adjustment type OUT: withdraw collateral IN add collateral

Revise Pledge › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

loanCoin

string

Borrowed coin

pledgeCoin

string

Collateral coin

afterPledgeRate

string

Post-adjustment collateral ratio (percentage)

Get Pledge Rate History

GET

https://api.bitget.com

/api/v3/loan/pledge-rate-history

Rate limit: 10/sec/UID

Get Pledge Rate History

Rate limit: 10/sec/UID
Permission: UTA mgt. (read)

Get Pledge Rate History › Request Parameters

startTime

string · required

Start time only supports querying data from the last 3 months

endTime

string · required

End time

orderId

string

Order ID

reviseSide

string

Adjustment direction down: transfer in, decrease up: transfer out, increase

pledgeCoin

string

Collateral coin

pageNum

string

Page number default is 1

pageSize

string

Items per page default is 10, maximum is 100

Get Pledge Rate History › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object[]

Pledge rate adjustment history list

loanCoin

string

Borrowed coin

pledgeCoin

string

Collateral coin

orderId

string

Order ID

reviseTime

string

Adjustment time

reviseSide

string

Adjustment direction down: transfer in, decrease up: transfer out, increase

reviseAmount

string

Adjustment amount

afterPledgeRate

string

Post-adjustment collateral ratio (percentage)

beforePledgeRate

string

Pre-adjustment collateral ratio (percentage)

Get Loan Reduces

GET

https://api.bitget.com

/api/v3/loan/reduces

Rate limit: 10/sec/UID

Get Loan Reduces

Rate limit: 10/sec/UID
Permission: UTA mgt. (read)

Get Loan Reduces › Request Parameters

startTime

string · required

Start time only supports querying data from the last 3 months

endTime

string · required

End time

orderId

string

Order ID

loanCoin

string

Borrowed coin

pledgeCoin

string

Collateral coin

status

string

Liquidation status COMPLETE liquidated WAIT liquidation

pageNum

string

Page number default is 1

pageSize

string

Items per page default is 10, maximum is 100

Get Loan Reduces › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object[]

Liquidation record list

orderId

string

Order ID

loanCoin

string

Borrowed coin

pledgeCoin

string

Collateral coin

reduceTime

string

Liquidation time

pledgeRate

string

Collateral ratio at liquidation (percentage)

pledgePrice

string

Collateral price at liquidation

status

string

Liquidation status COMPLETE liquidated WAIT liquidation

pledgeAmount

string

Liquidated collateral amount

reduceFee

string

Liquidation fee

residueAmount

string

Remaining collateral amount

runlockAmount

string

Released (unlocked) collateral amount

repayLoanAmount

string

Repaid loan debt amount

Get Loan Debts

GET

https://api.bitget.com

/api/v3/loan/debts

Rate limit: 10/sec/UID

Get Loan Debts

Rate limit: 10/sec/UID
Permission: UTA mgt. (read)

Get Loan Debts › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

loanInfos

string[]

Liability assets

>coin

string

Liability coin

>amount

string

Liability amount (denominated in coin)

>amountUsdt

string

Liability value (in USDT)

pledgeInfos

string[]

Collateral assets

Crypto Loans

Get Loan Coins

GET

https://api.bitget.com

/api/v3/loan/coins

Rate limit: 10/sec/UID

Get Loan Coins

Rate limit: 10/sec/UID
Permission: UTA mgt. (read)

Get Loan Coins › Request Parameters

coin

string

Coin name

Get Loan Coins › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

loanInfos

string[]

List of borrowable coins

>coin

string

Borrowable coin

>hourRateFlexible

string

Flexible hourly interest rate (percentage)

>rateFlexible

string

Flexible APR (annualized percentage)

>hourRate7D

string

7-day fixed hourly interest rate (pct.)

>rate7D

string

7-day fixed APR (annualized percentage)

>hourRate30D

string

30-day fixed hourly interest rate (pct.)

>rate30D

string

30-day fixed APR (annualized percentage)

>minBorrowLimit

string

Minimum borrow limit (in USDT)

>maxBorrowLimit

string

Maximum borrow limit (in USDT)

>minBorrowAmount

string

Minimum borrow amount

>maxBorrowAmount

string

Maximum borrow amount

pledgeInfos

string[]

List of collateralizable coins

>initRate

string

Initial collateral ratio (percentage)

>supRate

string

Margin call (top-up) collateral ratio (pct.)

>forceRate

string

Liquidation collateral ratio (pct.)

>minPledgeAmount

string

Minimum collateral limit (in USDT)

>maxPledgeAmount

string

Maximum collateral limit (in 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 Loan Interest

GET

https://api.bitget.com

/api/v3/loan/interest

Rate limit: 10/sec/UID

Get Loan Interest

Rate limit: 10/sec/UID
Permission: UTA mgt. (read)

Get Loan Interest › Request Parameters

loanCoin

string · required

Coin to borrow e.g.BTC

pledgeCoin

string · required

Collateral coin e.g.ETH

daily

string · required

Pledge term: SEVEN 7 days THIRTY 30 days FLEXIBLE flexible

pledgeAmount

string · required

Pledge Amount

Get Loan Interest › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

hourInterest

string

Estimated interest amount per hour

loanAmount

string

Borrowable amount

Borrow Coins

POST

https://api.bitget.com

/api/v3/loan/borrow

Rate limit: 10/sec/UID

Rate limit: 10/sec/UID
Permission: UTA mgt. (read & write)

Borrow Coins › Request Parameters

loanCoin

string · required

Coin to borrow e.g.BTC

pledgeCoin

string · required

Collateral coin e.g.ETH

daily

string · required

Pledge term: SEVEN 7 days THIRTY 30 days FLEXIBLE flexible

pledgeAmount

string

Collateral amount choose one of pledgeAmount or loanAmount

loanAmount

string

Borrow amount choose one of loanAmount or pledgeAmount

Borrow Coins › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

orderId

string

Order Id

Get Borrow Ongoing

GET

https://api.bitget.com

/api/v3/loan/borrow-ongoing

Rate limit: 10/sec/UID

Get Borrow Ongoing

Rate limit: 10/sec/UID
Permission: UTA mgt. (read)

Get Borrow Ongoing › Request Parameters

orderId

string

Order ID

loanCoin

string

Borrowed coin

pledgeCoin

string

Collateral coin

Get Borrow Ongoing › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object[]

Ongoing borrow order list

orderId

string

Order ID

loanCoin

string

borrowed coin

loanAmount

string

borrowed amount

interestAmount

string

Accrued interest amount

hourInterestRate

string

Hourly interest rate

pledgeCoin

string

Collateral coin

pledgeAmount

string

Collateral amount

pledgeRate

string

Collateral ratio

supRate

string

Margin call (top-up) collateral ratio (pct.)

forceRate

string

Liquidation collateral ratio (pct.)

borrowTime

string

Borrow time Unix timestamp in milliseconds

expireTime

string

Expiry time Unix timestamp in milliseconds

Get Borrow History

GET

https://api.bitget.com

/api/v3/loan/borrow-history

Rate limit: 10/sec/UID

Get Borrow History

Rate limit: 10/sec/UID
Permission: UTA mgt. (read)

Get Borrow History › Request Parameters

startTime

string · required

Start time only supports querying data from the last 3 months

endTime

string · required

End time

orderId

string

Order ID

loanCoin

string

Borrowed coin

pledgeCoin

string

Collateral coin

status

string

Status ROLLBACK: failed FORCE: liquidated REPAY: repaid

pageNum

string

Page number default is 1

pageSize

string

Items per page default is 10, maximum is 100

Get Borrow History › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object[]

Borrow history list

loanCoin

string

Borrowed coin

pledgeCoin

string

Collateral coin

orderId

string

Order ID

initPledgeAmount

string

Initial collateral amount

initLoanAmount

string

Initial borrowed amount

hourRate

string

Hourly interest rate

pledgeDays

string

Pledge/loan term in days

borrowTime

string

Borrow time

status

string

Status ROLLBACK: failed FORCE: liquidated REPAY: repaid

daily

string

Loan term type FLEXIBLE Flexible loan

Repay Coins

POST

https://api.bitget.com

/api/v3/loan/repay

Rate limit: 10/sec/UID

Repay Coins

Rate limit: 10/sec/UID
Permission: UTA mgt. (read & write)

Repay Coins › Request Parameters

orderId

string · required

Order ID

repayAll

string · required

Repay in full yes no If yes, the repayment amount will be ignored

amount

string

Repayment amount Required when repayAll=no

repayUnlock

string

Whether to redeem collateral yesredeem nodo not redeem Default is no if omitted. Not effective when repayAll=yes

Repay Coins › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

loanCoin

string

Borrowed coin

pledgeCoin

string

Collateral coin

repayAmount

string

Repayment amount

payInterest

string

Interest paid (in the borrowed coin)

repayLoanAmount

string

Principal repaid (in the borrowed coin)

repayUnlockAmount

string

Redeemed (unlocked) amount

Get Repay History

GET

https://api.bitget.com

/api/v3/loan/repay-history

Rate limit: 10/sec/UID

Get Repay History

Rate limit: 10/sec/UID
Permission: UTA mgt. (read)

Get Repay History › Request Parameters

startTime

string · required

Start time only supports querying data from the last 3 months

endTime

string · required

End time

orderId

string

Order ID

loanCoin

string

Borrowed coin

pledgeCoin

string

Collateral coin

pageNum

string

Page number default is 1

pageSize

string

Items per page default is 10, maximum is 100

Get Repay History › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object[]

Repay history list

orderId

string

Order ID

loanCoin

string

Borrowed coin

pledgeCoin

string

Collateral coin

repayAmount

string

Repayment amount

payInterest

string

Interest paid (in the borrowed coin)

repayLoanAmount

string

Principal repaid (in the borrowed coin)

repayUnlockAmount

string

Redeemed (unlocked) amount

repayTime

string

Repayment time

Revise Pledge

POST

https://api.bitget.com

/api/v3/loan/revise-pledge

Rate limit: 10/sec/UID

Revise Pledge

Rate limit: 10/sec/UID
Permission: UTA mgt. (read & write)

Revise Pledge › Request Parameters

orderId

string · required

Order ID

amount

string · required

Adjustment amount

pledgeCoin

string · required

Collateral coin

reviseType

string

Adjustment type OUT: withdraw collateral IN add collateral

Revise Pledge › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

loanCoin

string

Borrowed coin

pledgeCoin

string

Collateral coin

afterPledgeRate

string

Post-adjustment collateral ratio (percentage)

Get Pledge Rate History

GET

https://api.bitget.com

/api/v3/loan/pledge-rate-history

Rate limit: 10/sec/UID

Get Pledge Rate History

Rate limit: 10/sec/UID
Permission: UTA mgt. (read)

Get Pledge Rate History › Request Parameters

startTime

string · required

Start time only supports querying data from the last 3 months

endTime

string · required

End time

orderId

string

Order ID

reviseSide

string

Adjustment direction down: transfer in, decrease up: transfer out, increase

pledgeCoin

string

Collateral coin

pageNum

string

Page number default is 1

pageSize

string

Items per page default is 10, maximum is 100

Get Pledge Rate History › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object[]

Pledge rate adjustment history list

loanCoin

string

Borrowed coin

pledgeCoin

string

Collateral coin

orderId

string

Order ID

reviseTime

string

Adjustment time

reviseSide

string

Adjustment direction down: transfer in, decrease up: transfer out, increase

reviseAmount

string

Adjustment amount

afterPledgeRate

string

Post-adjustment collateral ratio (percentage)

beforePledgeRate

string

Pre-adjustment collateral ratio (percentage)

Get Loan Reduces

GET

https://api.bitget.com

/api/v3/loan/reduces

Rate limit: 10/sec/UID

Get Loan Reduces

Rate limit: 10/sec/UID
Permission: UTA mgt. (read)

Get Loan Reduces › Request Parameters

startTime

string · required

Start time only supports querying data from the last 3 months

endTime

string · required

End time

orderId

string

Order ID

loanCoin

string

Borrowed coin

pledgeCoin

string

Collateral coin

status

string

Liquidation status COMPLETE liquidated WAIT liquidation

pageNum

string

Page number default is 1

pageSize

string

Items per page default is 10, maximum is 100

Get Loan Reduces › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object[]

Liquidation record list

orderId

string

Order ID

loanCoin

string

Borrowed coin

pledgeCoin

string

Collateral coin

reduceTime

string

Liquidation time

pledgeRate

string

Collateral ratio at liquidation (percentage)

pledgePrice

string

Collateral price at liquidation

status

string

Liquidation status COMPLETE liquidated WAIT liquidation

pledgeAmount

string

Liquidated collateral amount

reduceFee

string

Liquidation fee

residueAmount

string

Remaining collateral amount

runlockAmount

string

Released (unlocked) collateral amount

repayLoanAmount

string

Repaid loan debt amount

Get Loan Debts

GET

https://api.bitget.com

/api/v3/loan/debts

Rate limit: 10/sec/UID

Get Loan Debts

Rate limit: 10/sec/UID
Permission: UTA mgt. (read)

Get Loan Debts › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

loanInfos

string[]

Liability assets

>coin

string

Liability coin

>amount

string

Liability amount (denominated in coin)

>amountUsdt

string

Liability value (in USDT)

pledgeInfos

string[]

Collateral assets