--- title: "Get order information and position details" method: GET path: "/api/v2/trading/info/orders:lookup" tags: ["Trading - Real"] --- # Get order information and position details `GET /api/v2/trading/info/orders:lookup` **Rate limit:** 60 requests per 60 seconds. This is a **shared quota** — the same budget is consumed by a group of related endpoints, so calling any of them reduces what is left for the others (you cannot call each at the full rate independently). Endpoints sharing this quota: - `GET /api/v1/trading/info/real/close-orders/{orderId}` - `GET /api/v1/trading/info/real/orders/{orderId}` --- Retrieves comprehensive information about a specific order, including the order status, execution details, and all positions that were opened or closed from this order. This endpoint is essential for tracking order execution and identifying which positions were created as a result of a specific order request. The response includes detailed position information with PositionID values that can be used to query position-specific details. Provide exactly one of orderId or referenceId. ## Query parameters - `orderId` integer - `referenceId` string ## Headers - `x-request-id` string, uuid, required - `x-api-key` string, password, required - `x-user-key` string, password, required ## Response `200` Order information retrieved successfully. - GetOrderInfoResponse — Detailed information about a specific order retrieved via the orders lookup endpoint. - `accountId` integer — The account identifier associated with this order. - `gcid` integer — The global customer identifier. - `portfolioId` integer — The portfolio identifier. - `orderId` integer — The unique identifier of the order. - `action` string — The order action. Possible values: open, close. - `transaction` string — The transaction direction. Possible values: buy, sell, sellShort, buyToCover. - `type` string — The order type. Possible values: mkt, mit. - `etoroOrderTypeId` integer — The internal eToro order type identifier. - `status` GetOrderInfoStatus — Status information for the order. - `id` integer — Status identifier. Values: 1 = Received, 2 = Placed, 3 = Filled, 4 = Rejected, 5 = PartiallyFilled, 6 = PendingCancel, 7 = Canceled, 8 = Expired, 9 = CanceledPartiallyFilled, 10 = RejectedPartiallyFilled, 11 = WaitingForMarket, 12 = PendingTriggeredRate. - `name` string — Human-readable status name. - `errorCode` integer — Error code if the order failed. Zero indicates no error. - `errorMessage` string, nullable — Human-readable error message if the order failed. - `asset` GetOrderInfoAsset — Asset information associated with the order. - `symbol` string — The asset ticker symbol. - `instrumentId` integer — The eToro instrument identifier. - `currency` string — The asset's base currency. - `settlementType` string — Settlement type. Possible values: cfd, real, realFutures, marginTrade. - `leverage` integer — The leverage applied to the order. - `side` string — The position side. Possible values: long, short. - `orderCurrency` string — The currency used for the order. - `requestedAmount` number, double, nullable — The requested monetary amount for the order. - `requestedUnits` number, double, nullable — The requested number of units for the order. - `requestedContracts` number, double, nullable — The requested number of contracts for the order. - `frozenAmount` number, double, nullable — The amount frozen/reserved for the order including costs. - `requestedTriggerRate` number, double, nullable — The trigger rate for limit or stop orders. - `openStopLossRate` number, double, nullable — The stop-loss rate at order open. - `openTakeProfitRate` number, double, nullable — The take-profit rate at order open. - `stopLossType` string, nullable — The stop-loss type. Possible values: fixed, trailing. - `totalCosts` number, double — Total costs associated with the order. - `positionsToClose` integer[] — List of position IDs to close as part of a close order. - `positionExecutions` GetOrderInfoPositionExecution[] — List of position executions resulting from this order. - `positionId` integer — The unique identifier of the executed position. - `state` string — The current state of the position. Possible values: open, closed. - `investedAmountCurrency` number, double — The invested amount in the account currency. - `initialExposureAccountCurrency` number, double — The initial exposure in the account currency. - `initialExposureAssetCurrency` number, double — The initial exposure in the asset currency. - `addedFunds` number, double — Additional funds added to the position. - `marginAccountCurrency` number, double — Margin held in the account currency. - `marginAssetCurrency` number, double — Margin held in the asset currency. - `remainingUnits` number, double — Remaining units in the position. - `remainingContracts` number, double, nullable — Remaining contracts in the position. - `stopLossRate` number, double, nullable — The stop-loss rate for the position. - `takeProfitRate` number, double, nullable — The take-profit rate for the position. - `openingData` GetOrderInfoOpeningData — Execution data recorded when the position was opened. - `openTime` string, date-time — The timestamp when the position was opened. - `orderId` integer — The order identifier that opened the position. - `executionTime` string, date-time — The execution timestamp. - `units` number, double, nullable — Number of units executed. - `contracts` number, double, nullable — Number of contracts executed. - `avgPrice` number, double — The average execution price. - `avgConversionRate` number, double — The average currency conversion rate applied. - `marketSpread` number, double — The market spread at execution time. - `markup` number, double — The markup applied to the spread. - `priceId` integer — The price snapshot identifier used for execution. - `fees` number, double — Fees charged for the execution. - `taxes` number, double — Taxes applied to the execution. - `requestTime` string, date-time — The timestamp when the order was requested. - `lastUpdate` string, date-time — The timestamp of the last update to the order. - `openActionType` string — The action type that initiated the order. - `requestType` string — The request sizing type. Possible values: byAmount, byUnits, byContracts. ## Other responses - `400` — Invalid request. Validation failed. - `401` — Unauthorized. Invalid or missing authentication. - `404` — Order not found. - `429` — Too Many Requests — the shared rate limit (60 requests / 60s) was exceeded. - `500` — Internal server error. --- [API](https://skmtc.dev/etoro/apis/etoro-api.md) · [All operations](https://skmtc.dev/etoro/apis/etoro-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/etoro/etoro-api/revisions/69c1fb266c35/schema)