Borrow

POST/api/v3/margin/borrow

:::info[Description]
This API endpoint is used to initiate an application for cross or isolated margin borrowing.
:::

Request

currency

string

required

currency

Examples:

BTCETHUSDT

size

number

required

Borrow amount

timeInForce

enum<string>

required

timeInForce: IOC, FOK

Allowed values:

IOCFOK

symbol

string

optional

symbol, mandatory for isolated margin account

Examples:

BTC-USDTETH-USDTKCS-USDT

isIsolated

boolean

optional

true-isolated, false-cross; default is false

Default:

false

isHf

boolean

optional

true: high frequency borrowing, false: low frequency borrowing; default false

Default:

false

{
  "currency": "USDT",
  "size": 10,
  "timeInForce": "FOK",
  "isIsolated": false,
  "isHf": false
}

Request samples

Responses

OK(200)

HTTP Code: 200

Content Type : JSONapplication/json

code

string

required

data

object

required

orderNo

string

required

Borrow Order Id

actualSize

string

required

Actual borrowed amount

{
  "code": "200000",
  "data": {
    "orderNo": "67187162c0d6990007717b15",
    "actualSize": "10"
  }
}

Last modified: a month ago