AnnouncementsGuidesAPI ReferenceSupport
API Reference
Start typing to search…

Order

post https://EXCHANGE-REGION-ENDPOINT-URL.com/v1/orders

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 Name

Description

Type

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

identifier

User custom Value for Inquiries (Optional)

String (Uniq Value)

time_in_force

IOC, 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_type

SMP (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

🚧

Use the Identifier Parameter

The identifier is a key value that is issued directly by the user, not the UUID that is issued by the service. This value is used to search orders. This value must deliver a unique value among the user's full order. A request may not be made under the same value in cases of an error during the transaction process.

Regardless of the order being successful or not, duplicate identifier values will cause a duplicate error, so please generate a new value for each 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 Name

Description

Type

uuid

Unique Order ID

String

side

Order Type

String

ord_type

Order Method

String

price

Currency Price at the Time of Order

NumberString

state

Order Status

String

market

Market Unique Key

String

created_at

Order Generation Time

String

volume

User Input Order Volume

NumberString

remaining_volume

Remaining Order Volume after Trade

NumberString

reserved_fee

Ratio Reserved as Fees

NumberString

remaining_fee

Remaining Fees

NumberString

paid_fee

Used Fees

NumberString

locked

Ratio being used in Transactions

NumberString

executed_volume

Traded Volume

NumberString

trades_count

The number of Transactions in the order

Integer

time_in_force

IOC, FOK, Post Only settings

String

identifier

User custom value for query

*Provided only for orders created after October 18, 2024

String

smp_type

SMP (Self-Match Prevention) Type

String

prevented_volume

Total cancelled volume by SMP

NumberString

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

Language