Test Order

Validates an order request without creating an actual order.

This endpoint simulates the full order creation logic to verify both request parameters and order availability, without creating a real order.

  • You can test order placement without any trading fees, and pre-check for possible errors before placing a real order.
  • It is especially useful right after an exchange maintenance, to check whether a specific trading pair is open for trading.
    • A successful response indicates that the pair is currently available for trading.
    • If a market_offline error is returned, it means that the pair is not yet available for order placement.
  • Test orders undergo the same validation process as real orders, but no actual order is created. Therefore, the returned UUID (or identifier) cannot be used for order query or cancellation requests.

Version Date Changes
v1.3.1 2025-10-27 Addition of Test Order Creation feature
Rate Limit
Up to 8 calls per second are allowed. Rate is measured per account and shared within the 'test order' group.

API Key Permission
This API requires authentication and an API Key with the [Order Placement] permission.
If you encounter an out_of_scope error, please verify permission settings in the API Key Management page.

Body Params
string
required

Target trading pair for the order. (required)

string
enum
required

Order direction (ask=sell, bid=buy)

Allowed:
string

Order volume.

string

Order price or total amount.

string
enum
required

Order type.

  • limit: Limit order
  • price: Market buy order (by total price)
  • market: Market sell order (by volume)
  • best: Best available price order
Allowed:
string

Client-assigned order identifier.

string
enum

Time in force condition.

  • fok: Fill or Kill
  • ioc: Immediate or Cancel
  • post_only: Post only (maker only)
Allowed:
string
enum

Self-Match Prevention (SMP) mode.

  • cancel_maker: Cancel maker order
  • cancel_taker: Cancel taker order
  • reduce: Reduce order quantity
Allowed:
Responses

Language
URL
LoadingLoading…
Response
Choose an example:
application/json