Sign in

v1

latestOpenAPI 3.0.12026-07-26171200932.8 KB
Trading - Demo

Get order information and position details

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/demo/close-orders/{orderId}
  • GET /api/v1/trading/info/demo/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.

get/api/v2/trading/info/demo/orders:lookup

Query parameters

orderIdinteger

Numeric order identifier. Mutually exclusive with referenceId.

referenceIdstring

Request ID header sent during order submission. Mutually exclusive with orderId.

Headers

x-request-idstring uuid required
Example:50d83c65-522f-468f-add1-dad29a78df15

A unique request identifier.

x-api-keystring password required
Example:lhgfaslk21490FAScVPkdsb53F9dNkfHG4faZSG5vfjndfcfgdssdgsdHF4663

API key for authentication.

x-user-keystring password required
Example:eyJlYW4iOiJVbnJlZ2lzdGVyZWRBcHBsaWNhdGlvbiIsImVrIjoiOE5sZ2cwcW5EUVdROUFNWGpXT2lmOWktZnpidG5KcUlqWGJ3WHJZZkpZcldrbG90ZEhvLVBjSWhQaU8xU1ZtMW84aU1WZGZqN2xWNzFjLXFxLmcybXE1dnh4Q1hUT25xaWRUaTFlcEhmVk1fIn0_

User-specific authentication key.

Response

Order information retrieved successfully.

accountIdinteger

The account identifier associated with this order.

gcidinteger

The global customer identifier.

portfolioIdinteger

The portfolio identifier.

orderIdinteger

The unique identifier of the order.

actionstring

The order action. Possible values: open, close.

transactionstring

The transaction direction. Possible values: buy, sell, sellShort, buyToCover.

typestring

The order type. Possible values: mkt, mit.

etoroOrderTypeIdinteger

The internal eToro order type identifier.

orderCurrencystring

The currency used for the order.

requestedAmountnumber double nullable

The requested monetary amount for the order.

requestedUnitsnumber double nullable

The requested number of units for the order.

requestedContractsnumber double nullable

The requested number of contracts for the order.

frozenAmountnumber double nullable

The amount frozen/reserved for the order including costs.

requestedTriggerRatenumber double nullable

The trigger rate for limit or stop orders.

openStopLossRatenumber double nullable

The stop-loss rate at order open.

openTakeProfitRatenumber double nullable

The take-profit rate at order open.

stopLossTypestring nullable

The stop-loss type. Possible values: fixed, trailing.

totalCostsnumber double

Total costs associated with the order.

positionsToCloseinteger[]

List of position IDs to close as part of a close order.

requestTimestring date-time

The timestamp when the order was requested.

lastUpdatestring date-time

The timestamp of the last update to the order.

openActionTypestring

The action type that initiated the order.

requestTypestring

The request sizing type. Possible values: byAmount, byUnits, byContracts.