POST
cURL
This operation serves perps markets only. Send a perps symbol in the BASE/QUOTE:SETTLE format in every edit. Read Which symbol format.

Authorizations

Authorization
string
header
required

The authorization field takes the session bearer returned by sign-in, or an API key where the route allows keys. Paste the token itself into the authorization field. When invitation-only access is enabled, private operations require the account's sign-in email to be invited. Sign-in can complete without an invitation, but private HTTP, MCP and FIX operations refuse with access_not_allowlisted (HTTP 403): "Private access is limited to invited accounts. Contact support to request access." Public market data remains available. Invitation changes apply to the next private operation, including existing FIX sessions. Do not retry until support confirms access.

Headers

Idempotency-Key
string
required
Minimum string length: 1

Body

application/json
Required array length: 1 - 24 elements
symbol
string
required
Minimum string length: 1
type
string
required
Allowed value: "limit"
side
enum<string>
required
Available options:
buy,
sell
amount
number
required
price
number
required
id
string
required
Minimum string length: 1
params
object

Response

Accepted for processing

Required array length: 1 - 24 elements
id
string
required
Minimum string length: 1
symbol
string
required
Minimum string length: 1
status
enum<string>
required
Available options:
open,
closed,
canceled
info
object
required
clientOrderId
string | null

1 to 256 ASCII letters, digits, periods, underscores, colons or hyphens. Canonical bot identifiers also allow the fixed bot-order/v1: prefix followed by an optional sha256: marker and 64 lowercase hexadecimal digits.

Required string length: 1 - 256
Pattern: ^(?:[A-Za-z0-9._:-]+|bot-order\/v1:(?:sha256:)?[a-f0-9]{64})$
timestamp
integer | null
Required range: x >= 0
datetime
string | null
lastUpdateTimestamp
integer
Required range: x >= 0
side
enum<string> | null
Available options:
buy,
sell,
null
type
enum<string> | null
Available options:
limit,
market,
null
timeInForce
enum<string>
Available options:
GTC,
IOC,
FOK,
PO
price
number | null
amount
number | null
Required range: x >= 0
filled
number | null
Required range: x >= 0
remaining
number | null
Required range: x >= 0
reduceOnly
boolean | null
postOnly
boolean | null
lastTradeTimestamp
integer | null
Required range: x >= 0
cost
number | null
trades
array
Required array length: 0 element
fee
object | null