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

Section titled “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
Example
{
  "type": "l",
  "side": "b",
  "leverage": 10,
  "quantity": 100,
  "margin": 1000,
  "price": 20000
}

Responses

Section titled “ Responses ”

200

Section titled “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

Section titled “400 ”

400