# Pending orders

Source: https://docs.pipsocket.com/api/pending-orders

Pending orders, read fresh from the terminal.

All calls: `https://api.pipsocket.com`, with `Authorization: Bearer <your workspace key>`.

## List pending orders

`GET /v1/accounts/{account}/orders`

The account's pending orders, read fresh from its terminal.

### Path

- `account` (string, required): The account's id, `acc_` and 26 characters, as the dashboard shows it.

### Response

A list of:

- `ticket` (integer, MT5 `ORDER_TICKET`): 
- `symbol` (string, MT5 `ORDER_SYMBOL`): 
- `type` (enum, or null, MT5 `ORDER_TYPE`): MT5's `ENUM_ORDER_TYPE`: `buy` and `sell` are market orders (`ORDER_TYPE_BUY`, `ORDER_TYPE_SELL`); `buy_limit`, `sell_limit`, `buy_stop`, `sell_stop`, `buy_stop_limit` and `sell_stop_limit` are pending orders (`ORDER_TYPE_BUY_LIMIT` and so on); `close_by` is `ORDER_TYPE_CLOSE_BY`. One of: `buy`, `sell`, `buy_limit`, `sell_limit`, `buy_stop`, `sell_stop`, `buy_stop_limit`, `sell_stop_limit`, `close_by`.
- `volume_initial` (number, MT5 `ORDER_VOLUME_INITIAL`): 
- `volume_current` (number, MT5 `ORDER_VOLUME_CURRENT`): 
- `price_open` (number, MT5 `ORDER_PRICE_OPEN`): 
- `sl` (number, MT5 `ORDER_SL`): 
- `tp` (number, MT5 `ORDER_TP`): 
- `magic` (integer, MT5 `ORDER_MAGIC`): 
- `comment` (string, MT5 `ORDER_COMMENT`): 
- `position` (integer, MT5 `ORDER_POSITION_ID`): The position the order belongs to, if any.

### Answers

- 200: Every pending order.
- 401: - `missing_api_key`: No API key: send it as `Authorization: Bearer <key>`.; `invalid_api_key`: The key is not a workspace's current key (a rolled key stops working within about a minute).
- 404: - `no_such_account`: No such account, or one the key's workspace doesn't have: the two look the same.
- 503: - `account_not_connected`: The account's terminal is not connected to the engine (stopped, starting, or restarting). Nothing was sent, except by the kill switch: engaging it still engages it, and may already have deleted pending orders.; `engine_busy`: The account's engine host has too many calls in flight (256). Nothing was done; try again.; `engine_unavailable`: The account's engine host is not connected to Pipsocket, or disconnected while the call waited. A trade it already had is still settled: look it up.
- 504: - `terminal_timeout`: The account's terminal did not answer within 5 seconds.; `engine_timeout`: The account's engine did not answer within 30 seconds.

### Example

```bash
curl "https://api.pipsocket.com/v1/accounts/acc_01m6tx3k9f2qw8r7bznd5yvh4c/orders" \
  -H "Authorization: Bearer $PIPSOCKET_KEY"
```

200 orders:

```json
[
  {
    "comment": "",
    "magic": 0,
    "position": 0,
    "price_open": 1.075,
    "sl": 0,
    "symbol": "EURUSD",
    "ticket": 881402377,
    "tp": 0,
    "type": "buy_limit",
    "volume_current": 0.1,
    "volume_initial": 0.1
  }
]
```