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=0.01234567&timestamp=1724952745123

  • MARKET SELL: symbol=PLEX-HBAR&side=SELL&type=MARKET&quantity=250.0&timestamp=1724952745123

  • STOP_LIMIT BUY: symbol=PLEX-HBAR&side=BUY&type=STOP_LIMIT&timeInForce=GTC&quantity=100.0&price=0.01200000&stopPrice=0.01150000&timestamp=1724952745123&stopComparison=LE

Weight: 1

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

Authorizations
signaturestringRequired

Ed25519 signature of payload

X-API-KEYstringRequired
Query parameters
symbolstring · min: 3 · max: 33Required

Trading pair symbol

Example: PLEX-HBARPattern: ^[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 user, 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

Acknowledgement returned when an order is accepted

symbolstringOptional

Trading pair symbol

Example: PLEX-HBAR
orderIdstringOptional

Exchange-assigned order ID

Example: 26a911ff-f546-eaaf-4b22-e57657b57571
clientOrderIdstring · max: 36Optional

Client-supplied order ID (if any, max 36 chars)

Example: myOrder-001
transactTimeinteger · int64Optional

Acceptance time (ms since epoch)

Example: 1724952746123
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
signaturestringRequired

Ed25519 signature of payload

X-API-KEYstringRequired
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}$
Responses
chevron-right
200

Order canceled

application/json

Acknowledgement returned when an order is canceled

symbolstringOptional

Trading pair symbol

Example: PLEX-HBAR
origClientOrderIdstring · max: 36Optional

Original client-supplied order ID (if any, max 36 chars)

Example: myOrder-001
orderIdstringOptional

Exchange-assigned order ID

Example: 26a911ff-f546-eaaf-4b22-e57657b57571
transactTimeinteger · int64Optional

Cancel time (ms since epoch)

Example: 1724952746123
pricenumberOptional

Price for LIMIT/*_LIMIT orders; null for MARKET/STOP orders

Example: 0.01234567
origQtynumberOptional

Original order quantity (base asset)

Example: 100
executedQtynumberOptional

Executed quantity (base asset)

Example: 25
cumulativeQuoteQtynumberOptional

Cumulative quote quantity (quote asset)

Example: 0.30864175
statusstring · enumOptional

Canceled order status

Example: CANCELEDPossible values:
timeInForcestring · enumOptional

Time in force for LIMIT/*_LIMIT orders; null otherwise

Example: GTCPossible values:
typestring · enumOptional

Order type

Example: LIMITPossible values:
sidestring · enumOptional

Order side

Example: BUYPossible values:
delete
/api/v1/order

Last updated