Create order

Submit an order creation request.

The order is queued for processing and will be matched against the orderbook.

Both limit and market orders are rejected with self_cross when they cross your
own opposite-side resting orders for the same symbol and there are no matchable
other-user resting orders. For limits, equal prices count as crossing; markets
cross at any price. Even a partial potential fill against another user passes this
self-cross check. Pending creation requests are not considered. Cancel-pending
other-user orders do not count as liquidity; your own resting orders still count.
Rejections are audited as order.request_denied. This is a database snapshot:
the engine rechecks its live book and may cancel your existing resting orders
reached by its quantity-aware matching walk (self_cross_cancelled). Orders
beyond that walk stay untouched. The API itself does not cancel orders or
guarantee fills; other engine checks, including post-only enforcement, still apply.

Rate Limit: This endpoint is subject to two independent rate limits. Either failure returns HTTP 429:

  • The General per-second rate limit (default 10/sec) — caps burst rate
  • A per-minute order creation limit (default 30/minute) — caps sustained throughput

Both can be customized per API key. See the Rate Limiting section in the API description for details.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
string
required
length ≤ 255

Trading pair symbol

string
enum
required

Order side

Allowed:
float
required

Order quantity (must be > 0)

float
required

Order price (must be > 0)

string
enum
Defaults to limit

Order type (defaults to limit)

Allowed:
string
enum

Optional order subtype. "post_only" ensures the order is maker-only — rejected if it would match on entry.

Allowed:
date-time

Optional expiration timestamp (must be in the future)

Responses

429

Rate limit exceeded. Either the general per-second limit or the
per-minute order creation limit was tripped.

Language
Credentials
Header
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json