Skip to main content
POST
/
place_order
cURL
curl --request POST \
  --url https://sandbox.x.architect.co/orders/place_order \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "d": "B",
  "p": "<string>",
  "po": true,
  "q": 123,
  "s": "<string>",
  "tag": "<string>",
  "tif": "<string>"
}'
{
  "oid": "<string>"
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
d
enum<string>
required

Order side; buying ("B") or selling ("S")

Available options:
B,
S
​
p
string
required

Order price in USD as decimal string; e.g. "1.2345"

​
po
boolean
required

Whether the order is post-only (maker-or-cancel)

​
q
integer
required

Order quantity in contracts; e.g. 100, 1000

​
s
string
required

Order symbol; e.g. GBPUSD-PERP, EURUSD-PERP

​
tif
string
required

Order time in force; e.g. "GTC", "IOC", "DAY"

​
tag
string | null

Optional order tag; maximum 10 alphanumeric characters

Response

Order placed successfully

​
oid
string
required

Order ID of the placed order; e.g. "ORD-1234567890"