get https://api.upbit.com/v1/orders
Get Order List.
Request Parameters
Notice for the changes on states parameter (2021. 03. 22 ~)
From 22-03-21, incomplete orders (wait, watch) and complete orders(done, cancel) cannot be viewed in mixture.
Ex 1) View done, cancel orders all at once => available
Ex 2) View wait, done orders all at once => Unavailable (need to call each API separately)Please refer to the notice on the developer’s center for further details.
| Field Name | Description | Type |
|---|---|---|
| market | Market ID | String |
| uuids | The list of UUID orders | Array |
| identifiers | The list of orders identifier | Array |
| state | The state of order - wait : waiting for orders to be completed (default)- watch : wait for reserved orders- done : completed all orders- cancel : Cancel ordersWhen market order is not inquired on the order list lookup API: A market buy order can occur in both cases when the order status is cancel or done after being executed.- If an order balance occurs after the execution at market price, the remaining balance will be returned and processed as cancel. In most cases, an insignificant amount that is not divisible to 8 decimal places will accrue as the order backlog.- If there is no order remaining and all orders are completed, the order status will turn into done. | String |
| states | The list of states * Incomplete orders (wait, watch) and Completed orders (done, cancel) can’t be viewed in mixture | Array |
| page | The number of page, default : 1 | Number |
| limit | The number of request, default : 100 | Number |
| order_by | Array Method - asc : ascending- desc : descending (default) | String |
Response
Support for new order types and conditions (Check available markets through the Announcement)
New Order Type added: Best Order (Add
besttype at ord_type)New Condition Type added: IOC (Immediate or Cancel), FOK (Fill or Kill)
- time_in_force field is newly added. Available type are
iocandfok.
| Field Name | Description | 타입 |
|---|---|---|
| uuid | Inherit ID for orders | String |
| side | Kinds of orders | String |
| ord_type | Method of orders | String |
| price | Currency price at the moment of order | NumberString |
| state | State of order | String |
| market | Inherit key for the order | String |
| created_at | The time when the order was made | DateString |
| volume | The amount of order entered by the users | NumberString |
| remaining_volume | The amount remaining after the order | NumberString |
| reserved_fee | The cost reserved for the commission | NumberString |
| remaining_fee | Remaining commission fee | NumberString |
| paid_fee | Used commission fee | NumberString |
| locked | Fee being used for transactions | NumberString |
| executed_volume | The amount of the orders made | NumberString |
| trades_count | The number of Transactions in the order | Integer |
| time_in_force | IOC, FOK Settings | String |