List Open Orders

get

https://{region}-api.upbit.com/v1/orders/open

Retrieves the list of open orders that are currently pending execution.

Check the proper endpoint based on your region.

The examples in this page is written using Singapore fiat code(SGD). Set the quote currency to match your region. The base_url differs by country/region. Make sure to specify the correct region value for your environment.

- Singapore (sg): https://sg-api.upbit.com
- Indonesia (id): https://id-api.upbit.com
- Thailand (th): https://th-api.upbit.com

You can retrieve the list of pending orders for the account. Optionally, you may specify filter parameters such as the trading pair and order status (pending execution or reserved order) to query the pending orders that meet these criteria.

The state and states[] parameters cannot be used simultaneously.

Please use only one of these parameters appropriately according to your filtering criteria when filtering by order status.

Revision History

Version	Date	Changes
v1.2.1	2025-07-02	Addition of `Self-Match Prevention (SMP)` feature
v1.1.9	2024-12-04	Addition of `identifier` field
v1.1.4	2024-06-19	Addition of `List Open Orders`

Rate Limit

Up to 30 calls per second are allowed. This is measured on an account basis and request counts are shared within the exchange 'default' group.

API Key Permission

This API requires authentication and the API Key must have [View Orders] permission.
If an out_of_scope permission error occurs, please check and configure the permissions in the API Key Management page.

Query Params

market

string

Trading pair code representing the market.

state

string

enum

Defaults to wait

Status of the order.
This is a filter parameter used to retrieve only orders with the specified status. The available values are "wait" (waiting to be executed) and "watch" (waiting as a reserved order). If not specified, the default value is "wait".

Allowed:

states[]

array of strings

Defaults to wait

Status of the order.
A filter parameter used to retrieve only orders with the specified status. This parameter is in array format, and the available values are "wait" (waiting to be executed) and "watch" (waiting as a reserved order). If not specified, the default value is "wait".

[Example] states[]=wait&states[]=watch

states[]

Allowed:

page

integer

Defaults to 1

Page number for pagination.
A parameter for pagination that allows you to specify the page to retrieve.
If not specified, the default value is 1.

limit

integer

Defaults to 100

Number of items per page.
A parameter for pagination that allows you to specify the number of items per page to retrieve.
Up to 100 items can be retrieved at a time, and if not specified, the default value is 100.

order_by

string

enum

Defaults to desc

Sorting method for query results.
Returns a list of orders sorted according to the specified method based on the order creation time.
The available values are "desc" (descending, latest orders first) or "asc" (ascending, oldest orders first).
The default value is "desc".

Allowed:

Responses

200List of open orders

400error object