Skip to main content
POST
Place perpetual order

Authorizations

Authorization
string
header
required

API key in the format dk_live_.... Pass as Authorization: Bearer dk_live_...

Body

application/json
symbol
string
required

Canonical perpetual symbol (for example BTC, ETH, or xyz:NVDA)

Example:

"BTC"

side
enum<string>
required
Available options:
long,
short
size
string
required

Order size in base units

Example:

"0.01"

orderType
enum<string>
required
Available options:
market,
limit
price
number

Limit price (required for limit orders)

Example:

100000

reduceOnly
boolean

Only reduce an existing position

takeProfitPrice
number

Take-profit trigger price

stopLossPrice
number

Stop-loss trigger price

Response

Order accepted for asynchronous execution

success
boolean
required
Example:

true

actionId
string
required

Action ID for polling status via /v1/actions

workflowId
string
required

Internal workflow ID