Orders

Order management

Place a new order

post

Places a new order for the authenticated account.

Security

Requires both XApiKey (header) and Ed25519Sig (query) via the global security requirement. The signature is computed over the request query string (including timestamp and any other parameters you send).

Parameter Rules

  • LIMIT: requires quantity, price, and timeInForce.

  • MARKET: requires quantity.

  • STOP_MARKET: requires quantity, stopPrice, and stopComparison.

  • STOP_LIMIT: require quantity, price, timeInForce, stopPrice, and stopComparison.

Examples (query-string style)

  • LIMIT BUY: symbol=PLEX-HBAR&side=BUY&type=LIMIT&timeInForce=GTC&quantity=1.5&price=1800.00&timestamp=1724952745123

  • MARKET SELL: symbol=WBTC-USDC&side=SELL&type=MARKET&quantity=0.05&timestamp=1724952745123

  • STOP_LIMIT BUY: symbol=WBTC-USDC&side=BUY&type=STOP_LIMIT&timeInForce=GTC&quantity=0.01&price=65000.00&stopPrice=64000.00&timestamp=1724952745123&stopComparison=LE

Weight: 1

This endpoint also counts against your Order Count limit (API key based).

Authorizations
X-API-KEYstringRequired
signaturestringRequired

Ed25519 signature of payload

Query parameters
symbolstring · min: 3 · max: 33Required

Trading pair symbol

Example: WETH-USDCPattern: ^[A-Z0-9_]+-[A-Z0-9_]+$
sidestring · enumRequired

Order side

Possible values:
typestring · enumRequired

Supported order types. LIMIT requires price, quantity, and timeInForce. MARKET requires quantity. STOP_LIMIT requires stopPrice and quantity. *_LIMIT types require price, stopPrice, quantity, and timeInForce.

Possible values:
timeInForcestring · enumOptional

Applied to LIMIT and *_LIMIT orders.

Possible values:
quantitystringOptional

Order quantity. Required for all order types

Example: 1.5
pricestringOptional

Price for LIMIT and STOP_LIMIT orders.

Example: 1800
newClientOrderIdstring · min: 1 · max: 36Optional

Optional client-assigned ID (must be unique per account, max 36 chars)

Example: myorder-001Pattern: ^[A-Za-z0-9._-]{1,36}$
stopPricestringOptional

Trigger price for STOP_MARKET and STOP_LIMIT orders

Example: 64000
stopComparisonstring · enumOptional

Comparison operator for stop trigger (GE = stop when mid-price >= stopPrice; LE = stop when mid-price <= stopPrice)

Possible values:
Responses
chevron-right
200

Order accepted

application/json
post
/api/v1/order

Cancel an existing order

delete

Deletes an existing order for the authenticated account.

Security

Requires both XApiKey (header) and Ed25519Sig (query) via the global security requirement. The signature is computed over the request query string (including timestamp and any other parameters you send).

Weight: 1

This endpoint also counts against your Order Count limit (API key based).

Authorizations
X-API-KEYstringRequired
signaturestringRequired

Ed25519 signature of payload

Query parameters
symbolstring · min: 3 · max: 33Required

Trading pair symbol

Example: PLEX-HBARPattern: ^[A-Z0-9_]+-[A-Z0-9_]+$
orderIdstring · uuidOptional

Server-assigned order ID (if combined with origClientOrderId, must refer to same order)

Example: 26a911ff-f546-eaaf-4b22-e57657b57571
origClientOrderIdstring · min: 1 · max: 36Optional

Original client-assigned order ID (optional if orderId is set, max 36 chars)

Example: myorder-001Pattern: ^[A-Za-z0-9._-]{1,36}$
newClientOrderIdstring · min: 1 · max: 36Optional

New client-assigned order ID (optional, max 36 chars)

Example: cancelOrder1Pattern: ^[A-Za-z0-9._-]{1,36}$
Responses
chevron-right
200

Order canceled

application/json
delete
/api/v1/order

Last updated