Order

Order Create

Request Parameters

📘

New order type & options

We support the best order type as well as the ioc (Immediate or Cancel) and fok (Fill or Kill) functions.

  • The best order type is added to the ord_type field.
  • The time_in_force field is added. (Type: ioc and fok)
Field NameDescriptionType
market *Market ID (required)String
side *Order Type (required)
  • bid : Buying
  • ask : Selling
String
volume *Order Volume (Required when selling at the limit price or market price)NumberString
price *Order Price. (Required when selling at the limit price or market price)NumberString
ord_type *Order Method (required)
  • limit : Limit Order
  • price : Market Price Order(Bid)
  • market : Market Price Order(Ask)
  • best : Best Order type (time_in_force field is required)
String
identifierUser custom Value for Inquiries (Optional)String (Uniq Value)
time_in_forceIOC, FOK, and Post Only Settings (Optional)
  • ioc: Immediately executes the portion of the order that can be filled; cancels the rest. (Immediate or Cancel)

  • fok: Executes the order only if the entire quantity can be filled immediately; otherwise, the order is canceled. (Fill or Kill)

  • post_only: Places the order only if it would not immediately match with an existing order; otherwise, the order is canceled.

  • The ioc and fok options are supported only when ord_type is set tobest or limit.

  • The post_only option is supported only when ord_type is set tolimit.

String
smp_typeSMP (Self-Match Prevention) Type (Optional)
  • reduce : Prevent matching by reducing the volume of both orders by the matched amount when orders from the same user are matched.
  • cancel_maker : Cancel the maker order when orders from the same user are matched.
  • cancel_taker : Cancel the taker order when orders from the same user are matched.
    • The SMP is determined by thesmp_type of the taker order.The smp_type of the maker order does not affect the prevention logic. Please refer to the [SMP Guide] for more details.

<span style={{color:'red'}}></span>Required\ <span style={{color:'orange'}}></span> Required under specific conditions

🚧

Using the Identifier Parameter

The identifier is a user-generated key, not a system-issued UUID. It can be assigned to search an order and must be unique across all of the user’s orders. Once used, an identifier cannot be reused, regardless of the order’s status (filled, unfilled, or canceled).

Submitting a duplicate identifier will result in an error. Always generate a new uniqueidentifier for each order request.

🚧

Market Price Order

For market price orders, please set the ord_type field to price or market.

For purchase orders, set the ord_type to price and set the volume to null or exclude it completely.
For sale orders, set the ord_type to market and set the price to null or exclude it completely.

For market price orders, ioc and fok functions are not supported.

🚧

Best Order

  • Set ord_type field to best
  • Set time_in_force field to ioc or fok
🚧

Ioc Limit Order & Fok Limit Order

  • Set ord_type field to limit
  • Set time_in_force field to ioc or fok

📘

Post-Only and SMP (Self-Match Prevention) Features Added (June 16, 2025 ~)

  • The post-only order condition

    • You can now set post_only as a value for the time_in_force field.
    • Only limit orders support the post-only condition and SMP is not supported in post-only orders.
  • The SMP (Self-Match Prevention) feature

    • Introduced the smp_type field with the following options: reduce, cancel_maker, cancel_taker

Response

Field NameDescriptionType
uuidUnique Order IDString
sideOrder TypeString
ord_typeOrder MethodString
priceCurrency Price at the Time of OrderNumberString
stateOrder StatusString
marketMarket Unique KeyString
created_atOrder Generation TimeString
volumeUser Input Order VolumeNumberString
remaining_volumeRemaining Order Volume after TradeNumberString
reserved_feeRatio Reserved as FeesNumberString
remaining_feeRemaining FeesNumberString
paid_feeUsed FeesNumberString
lockedRatio being used in TransactionsNumberString
executed_volumeTraded VolumeNumberString
trades_countThe number of Transactions in the orderInteger
time_in_forceIOC, FOK, Post Only settingsString
identifier

User custom value for query

*Provided only for orders created after October 18, 2024

String
smp_typeSMP (Self-Match Prevention) TypeString
prevented_volumeTotal cancelled volume by SMPNumberString
prevented_locked(Buy) The amount canceled due to the Self-Match Prevention (SMP) setting.
(Sell) The volume canceled due to the Self-Match Prevention (SMP) setting.
NumberString
Body Params
string
required

Market ID

string
required

Order Type

string
required

Order Quantity

string
required

Order Price per Unit

string
required

Order Type

string

User Designated Value for Inquiries

string

IOC, FOK, Post Only settings

string
enum

SMP (Self-Match Prevention) Type

Allowed:
Headers
string
required

Authorization token (JWT)

Responses

Language
LoadingLoading…
Response
Choose an example:
application/json