> ## Documentation Index > Fetch the complete documentation index at: https://api-portal.etoro.com/llms.txt > Use this file to discover all available pages before exploring further. # Get order information > Deprecated: This endpoint is marked deprecated in the eToro Public API Swagger. Prefer the current replacement endpoints where available. **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/v2/trading/info/orders:lookup` --- Retrieves the current state and execution details of an order submitted for the authenticated real account. Use this endpoint to track whether the order was received, placed, filled, rejected, cancelled, expired, or is still waiting for execution conditions. ## OpenAPI ````yaml /api-reference/deprecated-openapi.json get /api/v1/trading/info/real/orders/{orderId} openapi: 3.0.1 info: title: eToro Api version: v1.352.0 description: >- eToro’s public API provides access to real-time financial data, trading insights, and account management features, allowing developers to integrate eToro’s services into their applications. With access to market prices, historical data, and social trading information, the API empowers users to enhance their trading strategies. Designed for security and scalability, the eToro API ensures smooth and reliable integration for a variety of financial applications. For more details on integrating with eToro's public WebSocket service, please refer to the dedicated [WebSocket documentation](./websocket/websocket-doc.html). ## Authentication Every request must be authenticated with exactly one of two options: an OAuth 2.0 access token (`Authorization: Bearer `), or the non-interactive credential pair (`x-api-key` + `x-user-key` headers). The two options are mutually exclusive — a request carrying both is rejected. Each operation lists the OAuth scopes that grant access as alternative security requirements: a bearer token needs only ONE of them, and the same permissions govern the credential pair. servers: - url: https://public-api.etoro.com description: eToro Public API - Deprecated security: - apiKeyAuth: [] userKeyAuth: [] - oauth2: [] tags: - name: Agent Portfolios - name: Social Feeds - name: Trading - Demo - name: Trading - Real paths: /api/v1/trading/info/real/orders/{orderId}: get: tags: - Trading - Real summary: Get order information description: >- Deprecated: This endpoint is marked deprecated in the eToro Public API Swagger. Prefer the current replacement endpoints where available. **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/v2/trading/info/orders:lookup` --- Retrieves the current state and execution details of an order submitted for the authenticated real account. Use this endpoint to track whether the order was received, placed, filled, rejected, cancelled, expired, or is still waiting for execution conditions. operationId: getTradingInfoRealOrdersByOrderId parameters: - name: x-request-id in: header required: true schema: type: string format: uuid example: 1ace4004-1a85-4d93-963e-7b6a75cc5f78 description: A unique request identifier. - name: orderId in: path required: true description: The unique identifier of the order. schema: type: integer format: int64 responses: '200': description: Order information retrieved successfully. content: application/json: schema: $ref: '#/components/schemas/GetOrderInfoResponse' headers: RateLimit-Limit: description: >- Maximum number of requests allowed per window. This budget is SHARED across 3 endpoints (it is NOT per-endpoint): a request to any endpoint in the group spends the same budget. See this operation's description for the full list of endpoints sharing it. schema: type: integer example: 60 RateLimit-Remaining: description: Requests remaining in the current window for this quota. schema: type: integer RateLimit-Reset: description: Seconds until the current window resets. schema: type: integer RateLimit-Policy: description: Quota policy in the form `;w=`. schema: type: string example: 60;w=60 '400': description: Invalid request. Validation failed. content: application/json: schema: $ref: '#/components/schemas/ProblemDetails' '401': description: Unauthorized. Invalid or missing authentication. content: application/json: schema: $ref: '#/components/schemas/ProblemDetails' '404': description: Order not found. content: application/json: schema: $ref: '#/components/schemas/ProblemDetails' '429': description: >- Too Many Requests — the shared rate limit (60 requests / 60s) was exceeded. headers: RateLimit-Limit: description: >- Maximum number of requests allowed per window. This budget is SHARED across 3 endpoints (it is NOT per-endpoint): a request to any endpoint in the group spends the same budget. See this operation's description for the full list of endpoints sharing it. schema: type: integer example: 60 RateLimit-Remaining: description: Requests remaining in the current window for this quota. schema: type: integer RateLimit-Reset: description: Seconds until the current window resets. schema: type: integer RateLimit-Policy: description: Quota policy in the form `;w=`. schema: type: string example: 60;w=60 Retry-After: description: Seconds to wait before retrying. schema: type: integer example: 60 deprecated: true security: - apiKeyAuth: [] userKeyAuth: [] - oauth2: - etoro-public:real:read - oauth2: - etoro-public:real:write - oauth2: - etoro-public:trade.real:read - oauth2: - etoro-public:trade.real:write components: schemas: GetOrderInfoResponse: type: object description: >- Detailed information about a specific order retrieved via the orders lookup endpoint. properties: accountId: type: integer format: int64 description: The account identifier associated with this order. gcid: type: integer format: int64 description: The global customer identifier. portfolioId: type: integer format: int32 description: The portfolio identifier. orderId: type: integer format: int64 description: The unique identifier of the order. action: type: string description: 'The order action. Possible values: open, close.' transaction: type: string description: >- The transaction direction. Possible values: buy, sell, sellShort, buyToCover. type: type: string description: 'The order type. Possible values: mkt, mit.' etoroOrderTypeId: type: integer format: int32 description: The internal eToro order type identifier. status: $ref: '#/components/schemas/GetOrderInfoStatus' asset: $ref: '#/components/schemas/GetOrderInfoAsset' orderCurrency: type: string description: The currency used for the order. requestedAmount: type: number format: double nullable: true description: The requested monetary amount for the order. requestedUnits: type: number format: double nullable: true description: The requested number of units for the order. requestedContracts: type: number format: double nullable: true description: The requested number of contracts for the order. frozenAmount: type: number format: double nullable: true description: The amount frozen/reserved for the order including costs. requestedTriggerRate: type: number format: double nullable: true description: The trigger rate for limit or stop orders. openStopLossRate: type: number format: double nullable: true description: The stop-loss rate at order open. openTakeProfitRate: type: number format: double nullable: true description: The take-profit rate at order open. stopLossType: type: string nullable: true description: 'The stop-loss type. Possible values: fixed, trailing.' totalCosts: type: number format: double description: Total costs associated with the order. positionsToClose: type: array items: type: integer format: int64 description: List of position IDs to close as part of a close order. positionExecutions: type: array items: $ref: '#/components/schemas/GetOrderInfoPositionExecution' description: List of position executions resulting from this order. requestTime: type: string format: date-time description: The timestamp when the order was requested. lastUpdate: type: string format: date-time description: The timestamp of the last update to the order. openActionType: type: string description: The action type that initiated the order. requestType: type: string description: >- The request sizing type. Possible values: byAmount, byUnits, byContracts. ProblemDetails: type: object properties: type: type: string nullable: true title: type: string nullable: true status: type: integer format: int32 nullable: true detail: type: string nullable: true instance: type: string nullable: true additionalProperties: {} GetOrderInfoStatus: type: object description: Status information for the order. properties: id: type: integer format: int32 description: >- 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: type: string description: Human-readable status name. errorCode: type: integer format: int32 description: Error code if the order failed. Zero indicates no error. errorMessage: type: string nullable: true description: Human-readable error message if the order failed. GetOrderInfoAsset: type: object description: Asset information associated with the order. properties: symbol: type: string description: The asset ticker symbol. instrumentId: type: integer format: int32 description: The eToro instrument identifier. currency: type: string description: The asset's base currency. settlementType: type: string description: >- Settlement type. Possible values: cfd, real, realFutures, marginTrade. leverage: type: integer format: int32 description: The leverage applied to the order. side: type: string description: 'The position side. Possible values: long, short.' GetOrderInfoPositionExecution: type: object description: Details of a position execution resulting from the order. properties: positionId: type: integer format: int64 description: The unique identifier of the executed position. state: type: string description: 'The current state of the position. Possible values: open, closed.' investedAmountCurrency: type: number format: double description: The invested amount in the account currency. initialExposureAccountCurrency: type: number format: double description: The initial exposure in the account currency. initialExposureAssetCurrency: type: number format: double description: The initial exposure in the asset currency. addedFunds: type: number format: double description: Additional funds added to the position. marginAccountCurrency: type: number format: double description: Margin held in the account currency. marginAssetCurrency: type: number format: double description: Margin held in the asset currency. remainingUnits: type: number format: double description: Remaining units in the position. remainingContracts: type: number format: double nullable: true description: Remaining contracts in the position. stopLossRate: type: number format: double nullable: true description: The stop-loss rate for the position. takeProfitRate: type: number format: double nullable: true description: The take-profit rate for the position. openingData: $ref: '#/components/schemas/GetOrderInfoOpeningData' GetOrderInfoOpeningData: type: object description: Execution data recorded when the position was opened. properties: openTime: type: string format: date-time description: The timestamp when the position was opened. orderId: type: integer format: int64 description: The order identifier that opened the position. executionTime: type: string format: date-time description: The execution timestamp. units: type: number format: double nullable: true description: Number of units executed. contracts: type: number format: double nullable: true description: Number of contracts executed. avgPrice: type: number format: double description: The average execution price. avgConversionRate: type: number format: double description: The average currency conversion rate applied. marketSpread: type: number format: double description: The market spread at execution time. markup: type: number format: double description: The markup applied to the spread. priceId: type: integer format: int64 description: The price snapshot identifier used for execution. fees: type: number format: double description: Fees charged for the execution. taxes: type: number format: double description: Taxes applied to the execution. securitySchemes: apiKeyAuth: type: apiKey in: header name: x-api-key description: >- API key of the application. Only valid together with the x-user-key header — the pair is an alternative to OAuth bearer authentication, never sent alongside it. The pair is granted the same permissions the operation's OAuth scopes describe. Demo credential for trying the API from these docs: `lhgfaslk21490FAScVPkdsb53F9dNkfHG4faZSG5vfjndfcfgdssdgsdHF4663` x-default: lhgfaslk21490FAScVPkdsb53F9dNkfHG4faZSG5vfjndfcfgdssdgsdHF4663 userKeyAuth: type: apiKey in: header name: x-user-key description: >- User-specific authentication key. Only valid together with the x-api-key header — the pair is an alternative to OAuth bearer authentication, never sent alongside it. Demo credential for trying the API from these docs: `eyJlYW4iOiJVbnJlZ2lzdGVyZWRBcHBsaWNhdGlvbiIsImVrIjoiOE5sZ2cwcW5EUVdROUFNWGpXT2lmOWktZnpidG5KcUlqWGJ3WHJZZkpZcldrbG90ZEhvLVBjSWhQaU8xU1ZtMW84aU1WZGZqN2xWNzFjLXFxLmcybXE1dnh4Q1hUT25xaWRUaTFlcEhmVk1fIn0_` x-default: >- eyJlYW4iOiJVbnJlZ2lzdGVyZWRBcHBsaWNhdGlvbiIsImVrIjoiOE5sZ2cwcW5EUVdROUFNWGpXT2lmOWktZnpidG5KcUlqWGJ3WHJZZkpZcldrbG90ZEhvLVBjSWhQaU8xU1ZtMW84aU1WZGZqN2xWNzFjLXFxLmcybXE1dnh4Q1hUT25xaWRUaTFlcEhmVk1fIn0_ oauth2: type: oauth2 description: >- eToro OAuth2 — send the access token as `Authorization: Bearer `. Each operation lists the scopes that grant access as separate `security` requirements (OpenAPI OR semantics): the caller's token only needs ONE of them — you do NOT need all of them. Mutually exclusive with the x-api-key/x-user-key credential pair: never send both. flows: authorizationCode: authorizationUrl: '' tokenUrl: '' scopes: etoro-public:agent-portfolio:read: Grants access to the 'etoro-public:agent-portfolio:read' scope. etoro-public:agent-portfolio:write: Grants access to the 'etoro-public:agent-portfolio:write' scope. etoro-public:club:read: Grants access to the 'etoro-public:club:read' scope. etoro-public:demo:read: Grants access to the 'etoro-public:demo:read' scope. etoro-public:demo:write: Grants access to the 'etoro-public:demo:write' scope. etoro-public:feed:read: Grants access to the 'etoro-public:feed:read' scope. etoro-public:feed:write: Grants access to the 'etoro-public:feed:write' scope. etoro-public:money.balance:read: Grants access to the 'etoro-public:money.balance:read' scope. etoro-public:money.cash-transactions:read: >- Grants access to the 'etoro-public:money.cash-transactions:read' scope. etoro-public:money.transfer:read: Grants access to the 'etoro-public:money.transfer:read' scope. etoro-public:money.transfer:write: Grants access to the 'etoro-public:money.transfer:write' scope. etoro-public:money:transfer: Grants access to the 'etoro-public:money:transfer' scope. etoro-public:notifications:read: Grants access to the 'etoro-public:notifications:read' scope. etoro-public:notifications:write: Grants access to the 'etoro-public:notifications:write' scope. etoro-public:pi-data:read: Grants access to the 'etoro-public:pi-data:read' scope. etoro-public:price-alerts:read: Grants access to the 'etoro-public:price-alerts:read' scope. etoro-public:price-alerts:write: Grants access to the 'etoro-public:price-alerts:write' scope. etoro-public:real:read: Grants access to the 'etoro-public:real:read' scope. etoro-public:real:write: Grants access to the 'etoro-public:real:write' scope. etoro-public:sso-applications:read: Grants access to the 'etoro-public:sso-applications:read' scope. etoro-public:sso-applications:write: Grants access to the 'etoro-public:sso-applications:write' scope. etoro-public:sso-scopes:read: Grants access to the 'etoro-public:sso-scopes:read' scope. etoro-public:sso-scopes:write: Grants access to the 'etoro-public:sso-scopes:write' scope. etoro-public:sub-accounts:read: Grants access to the 'etoro-public:sub-accounts:read' scope. etoro-public:sub-accounts:write: Grants access to the 'etoro-public:sub-accounts:write' scope. etoro-public:trade.demo:read: Grants access to the 'etoro-public:trade.demo:read' scope. etoro-public:trade.demo:write: Grants access to the 'etoro-public:trade.demo:write' scope. etoro-public:trade.real:read: Grants access to the 'etoro-public:trade.real:read' scope. etoro-public:trade.real:write: Grants access to the 'etoro-public:trade.real:write' scope. etoro-public:user-info:read: Grants access to the 'etoro-public:user-info:read' scope. etoro-public:watchlist:read: Grants access to the 'etoro-public:watchlist:read' scope. etoro-public:watchlist:write: Grants access to the 'etoro-public:watchlist:write' scope. ````