Skip to main content
POST
/
v1
/
orders
/
perp
Place perpetual order
curl --request POST \
  --url https://api.trydocent.com/v1/orders/perp \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "symbol": "BTC",
  "size": "0.01",
  "price": 100000,
  "reduceOnly": true,
  "takeProfitPrice": 123,
  "stopLossPrice": 123
}
'
{
  "success": true,
  "actionId": "<string>",
  "workflowId": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://docs.trydocent.com/llms.txt

Use this file to discover all available pages before exploring further.

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