# Look up a request Source: https://docs.pipsocket.com/api/look-up-a-request A trade request and MT5's answer. All calls: `https://api.pipsocket.com`, with `Authorization: Bearer `. ## Look up a request `GET /v1/accounts/{account}/requests/{request}` A trade request as it stands now: the request as recorded for the terminal, its state, and MT5's answer. Requests are kept for 7 days. ### Path - `account` (string, required): The account's id, `acc_` and 26 characters, as the dashboard shows it. - `request` (string, required): The request's id (`req_...`), from the trade call's answer. ### Response - `request` (string): The request's id (`req_...`): look it up with `GET /requests/{request}`. - `state` (enum): A trade request's state: `pending` (sent, no answer yet: never sent again), `done` (MT5 answered: filled, placed or rejected, as `result.retcode` says), `unknown` (no answer within 130 seconds; it becomes `done` if the terminal reports the answer later) or `refused` (the terminal did not send it). One of: `pending`, `done`, `unknown`, `refused`. - `sent` (object): MT5's `MqlTradeRequest`, field for field, exactly as recorded to send to the terminal: the request's `state` and `result` say whether it reached MT5. Fields the call does not use carry MT5's empty values (0, "", `fok`, `gtc`). - `action` (enum, MT5 `action`): What the request does. One of: `deal`, `pending`, `sltp`, `modify`, `remove`, `close_by`. - `symbol` (string, MT5 `symbol`): The symbol, exactly as the broker names it. - `type` (enum, MT5 `type`): The order type. One of: `buy`, `sell`, `buy_limit`, `sell_limit`, `buy_stop`, `sell_stop`, `buy_stop_limit`, `sell_stop_limit`, `close_by`. - `volume` (number, MT5 `volume`): Lots. - `price` (number, MT5 `price`): The price: a pending order's, or the one instant and request execution trade at. - `stoplimit` (number, MT5 `stoplimit`): A stop-limit order's limit price, placed once `price` is reached. - `sl` (number, MT5 `sl`): Stop loss price; 0 for none. - `tp` (number, MT5 `tp`): Take profit price; 0 for none. - `deviation` (integer, MT5 `deviation`): The largest difference from `price` MT5 accepts, in points. - `type_filling` (enum, MT5 `type_filling`): How the order may fill. One of: `fok`, `ioc`, `return`, `boc`. - `type_time` (enum, MT5 `type_time`): How long a pending order lasts. One of: `gtc`, `day`, `specified`, `specified_day`. - `expiration` (integer, MT5 `expiration`): Broker server time, seconds since 1970, as MT5 takes it. - `order` (integer, MT5 `order`): The pending order the request is about (modify, remove). - `position` (integer, MT5 `position`): The position the request is about (close, stops, close by). - `position_by` (integer, MT5 `position_by`): The opposite position, for close by. - `magic` (integer, MT5 `magic`): Your own number, kept by MT5 on the order, its deals and its position. - `comment` (string, MT5 `comment`): Up to 31 characters, kept by MT5 on the order. - `result` (object, or null): MT5's `MqlTradeResult` once `done`; why it was not sent once `refused`; otherwise null. - `message` (string): What the answer means, in a sentence. ### Answers - 200: The request is `done`, or `unknown`: the trade server's answer did not arrive in time. - 202: The request is still `pending`. - 401: - `missing_api_key`: No API key: send it as `Authorization: Bearer `.; `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.; `no_such_request`: The account has no request with that id (requests are kept 7 days). - 503: - `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.; the request's state is `refused`: the terminal did not send it. `result` says why. - 504: - `engine_timeout`: The account's engine did not answer within 30 seconds. ### Example ```bash curl "https://api.pipsocket.com/v1/accounts/acc_01m6tx3k9f2qw8r7bznd5yvh4c/requests/req_5f0c2a9e41d7b3a8c6e2f190" \ -H "Authorization: Bearer $PIPSOCKET_KEY" ``` 200 done: ```json { "message": "The request was completed.", "request": "req_5f0c2a9e41d7b3a8c6e2f190", "result": { "ask": 1.08412, "bid": 1.0841, "comment": "Request executed", "deal": 771203455, "order": 881402311, "position": 0, "price": 1.08412, "retcode": 10009, "retcode_external": 0, "retcode_name": "TRADE_RETCODE_DONE", "volume": 0.1 }, "sent": { "action": "deal", "comment": "", "deviation": 0, "expiration": 0, "magic": 0, "order": 0, "position": 0, "position_by": 0, "price": 0, "sl": 1.079, "stoplimit": 0, "symbol": "EURUSD", "tp": 0, "type": "buy", "type_filling": "ioc", "type_time": "gtc", "volume": 0.1 }, "state": "done" } ``` 200 unknown: ```json { "message": "The trade server's answer has not arrived in time. Check positions and history; if the terminal reports it later, this request shows it.", "request": "req_5f0c2a9e41d7b3a8c6e2f190", "result": null, "sent": { "action": "deal", "comment": "", "deviation": 0, "expiration": 0, "magic": 0, "order": 0, "position": 0, "position_by": 0, "price": 0, "sl": 1.079, "stoplimit": 0, "symbol": "EURUSD", "tp": 0, "type": "buy", "type_filling": "ioc", "type_time": "gtc", "volume": 0.1 }, "state": "unknown" } ``` 202 pending: ```json { "message": "No answer from the trade server yet. The order may still execute; it is not sent again.", "request": "req_5f0c2a9e41d7b3a8c6e2f190", "result": null, "sent": { "action": "deal", "comment": "", "deviation": 0, "expiration": 0, "magic": 0, "order": 0, "position": 0, "position_by": 0, "price": 0, "sl": 1.079, "stoplimit": 0, "symbol": "EURUSD", "tp": 0, "type": "buy", "type_filling": "ioc", "type_time": "gtc", "volume": 0.1 }, "state": "pending" } ```