Skip to content
Documentation

Create a new trade

POST
/v2/futures

Send the order form parameters to add a new trade in database. If type="l", the property price must be included in the request to know when the trade should be filled. You can choose to use the margin or the quantity as a parameter, the other will be calculated with the one you chose

Request Body

Body

object
leverage
required
number
stoploss
number
multiple of 0.5
takeprofit
number
multiple of 0.5
side
required
string
Allowed values: b s
One of:
object
quantity
required
integer
> 0
margin
One of:
object
price
required
number
> 0 multiple of 0.5
type
required
string
Allowed values: l 
{
  "type": "l",
  "side": "b",
  "leverage": 10,
  "quantity": 100,
  "margin": 1000,
  "price": 20000
}

Responses

200

200

One of:
object
id
required
string format: uuid
uid
required
string format: uuid
type
required
string
Allowed values: l
side
required
string
Allowed values: b s
opening_fee
required
integer
>= -9007199254740991 <= 9007199254740991
closing_fee
required
integer
>= -9007199254740991 <= 9007199254740991
maintenance_margin
required
integer
>= -9007199254740991 <= 9007199254740991
quantity
required
number
>= -9007199254740991 <= 9007199254740991
margin
required
integer
>= -9007199254740991 <= 9007199254740991
leverage
required
number
>= -9007199254740991 <= 9007199254740991
price
required
number
>= -9007199254740991 <= 9007199254740991
liquidation
required
number
>= -9007199254740991 <= 9007199254740991
stoploss
required
number
>= -9007199254740991 <= 9007199254740991
takeprofit
required
number
>= -9007199254740991 <= 9007199254740991
exit_price
required
number
nullable >= -9007199254740991 <= 9007199254740991
pl
required
integer
>= -9007199254740991 <= 9007199254740991
creation_ts
required
number
market_filled_ts
required
string format: null
nullable
closed_ts
required
string format: null
nullable
entry_price
required
number
nullable >= -9007199254740991 <= 9007199254740991
entry_margin
required
integer
nullable >= -9007199254740991 <= 9007199254740991
open
required
boolean
running
required
boolean
canceled
required
boolean
closed
required
boolean
sum_carry_fees
required
integer
>= -9007199254740991 <= 9007199254740991

400

400