Skip to main content
POST
/
place-order
cURL
curl --request POST \
  --url https://gateway.architect.exchange/orders/place-order \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "p": "<string>",
  "po": true,
  "q": 1,
  "s": "<string>",
  "tif": "<string>",
  "aid": "<string>",
  "cid": 1,
  "tag": "<string>"
}
'
{
  "oid": "<string>"
}

Authorizations

​
Authorization
string
header
required

User session 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<int64>
required

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

Required range: x >= 0
​
s
string
required

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

​
tif
string
required

Order time in force; e.g. "GTC", "IOC". "DAY" is accepted but deprecated and will be removed in a future release — use "GTC" instead.

​
aid
string | null

Optional account ID. If omitted, default (primary) user account is used.

​
cid
null | integer<int64>

Optional client order ID; 64 bit integer

Required range: x >= 0
​
st
enum<string>

Self-trade prevention behavior (defaults to rejecting the incoming aggressor)

Available options:
CancelIncoming,
CancelResting,
CancelBoth
​
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"