Trading 212 Public API

https://docs.trading212.com/api
Admin
The Trading 212 Public API provides official access for developers to build trading applications and...
Tokens:37,281
Snippets:242
Trust Score:5.5
Update:1 week ago
Show doc for...
Tokens:
Raw
### Example response for get all pending orders

Source: https://docs.trading212.com/api/orders/orders

Example response body for the get all pending orders endpoint. Shows the structure of an order object with fields like createdAt, currency, side, status, and type.

```json
[
  {
    "createdAt": "2019-08-24T14:15:22Z",
    "currency": "string",
    "extendedHours": true,
    "filledQuantity": 0,
    "filledValue": 0,
    "id": 0,
    "initiatedFrom": "API",
    "instrument": { … },
    "limitPrice": 0,
    "quantity": 0,
    "side": "BUY",
    "status": "LOCAL",
    "stopPrice": 0,
    "strategy": "QUANTITY",
    "ticker": "AAPL_US_EQ",
    "timeInForce": "DAY",
    "type": "LIMIT",
    "value": 0
  }
]
```

--------------------------------

### Get pending order response example (JSON)

Source: https://docs.trading212.com/api/orders/orderbyid

Example JSON response body for a successful GET request. Shows the structure of an order object, including fields like createdAt, currency, extendedHours, filledQuantity, filledValue, id, initiatedFrom, instrument, limitPrice, quantity, side, status, stopPrice, strategy, ticker, timeInForce, type, and value.

```json
{
  "createdAt": "2019-08-24T14:15:22Z",
  "currency": "string",
  "extendedHours": true,
  "filledQuantity": 0,
  "filledValue": 0,
  "id": 0,
  "initiatedFrom": "API",
  "instrument": {
    "currency": "string",
    "isin": "string",
    "name": "string",
    "ticker": "AAPL_US_EQ"
  },
  "limitPrice": 0,
  "quantity": 0,
  "side": "BUY",
  "status": "LOCAL",
  "stopPrice": 0,
  "strategy": "QUANTITY",
  "ticker": "AAPL_US_EQ",
  "timeInForce": "DAY",
  "type": "LIMIT",
  "value": 0
}
```

--------------------------------

### GET /api/v0/equity/pies response example

Source: https://docs.trading212.com/api/pies-%28deprecated%29

Example response body for the successful GET /api/v0/equity/pies request. Shows the schema fields: cash (number), dividendDetails (object), id (integer int64), progress (number), result (object), and status which can be AHEAD, ON_TRACK, or BEHIND.

```json
[
  {
    "cash": 0,
    "dividendDetails": { … },
    "id": 0,
    "progress": 0.5,
    "result": { … },
    "status": "AHEAD"
  }
]
```

--------------------------------

### Example account summary response

Source: https://docs.trading212.com/api/accounts/getaccountsummary

Example response body for the account summary endpoint. Shows the structure of the cash, investments, currency, and account ID fields. Actual values will populate the fields.

```json
{
  "cash": {
    "availableToTrade": 0,
    "inPies": 0,
    "reservedForOrders": 0
  },
  "currency": "string",
  "id": 0,
  "investments": {
    "currentValue": 0,
    "realizedProfitLoss": 0,
    "totalCost": 0,
    "unrealizedProfitLoss": 0
  },
  "totalValue": 0
}
```

--------------------------------

### GET /api/v0/equity/account/summary

Source: https://docs.trading212.com/api/accounts/getaccountsummary

Documentation for the GET /api/v0/equity/account/summary endpoint, which retrieves account summary information.

```APIDOC
## GET /api/v0/equity/account/summary

### Description
Provides a breakdown of your account's cash and investment metrics, including available funds, invested capital, and total account value.

### Method
GET

### Endpoint
/api/v0/equity/account/summary

### Parameters
#### Authentication
- **Authorization** (string) - Required - Your API key. Use the header `Authorization: YOUR_API_KEY_HERE`.
- **Basic Auth** - Required - Username and password for basic authentication (e.g., `-u '<username>:<password>'`).

### Request Example
```
curl -i -X GET \
  -u '<username>:<password>' \
  https://demo.trading212.com/api/v0/equity/account/summary \
  -H 'Authorization: YOUR_API_KEY_HERE'
```

### Response
#### Success Response (200)
- **cash** (object) - Cash details.
  - **availableToTrade** (number) - Available funds for trading.
  - **inPies** (number) - Funds allocated to pies.
  - **reservedForOrders** (number) - Funds reserved for pending orders.
- **currency** (string) - Primary account currency in ISO 4217 format.
- **id** (integer, int64) - Primary trading account number. This is the same account ID you would see in the Trading 212 web or mobile application.
- **investments** (object) - Investment details.
  - **currentValue** (number) - Current value of investments.
  - **realizedProfitLoss** (number) - Realized profit/loss.
  - **totalCost** (number) - Total cost of investments.
  - **unrealizedProfitLoss** (number) - Unrealized profit/loss.
- **totalValue** (number) - Investments value in your account's primary currency.

#### Response Example
```json
{
  "cash": {
    "availableToTrade": 0,
    "inPies": 0,
    "reservedForOrders": 0
  },
  "currency": "string",
  "id": 0,
  "investments": {
    "currentValue": 0,
    "realizedProfitLoss": 0,
    "totalCost": 0,
    "unrealizedProfitLoss": 0
  },
  "totalValue": 0
}
```

### Error Responses
- **401** - Unauthorized - Invalid or missing API key.
- **403** - Forbidden - Insufficient permissions.
- **408** - Request Timeout - The request took too long.
- **429** - Too Many Requests - Rate limit exceeded. Rate limit: 1 req / 5s.
```

--------------------------------

### Response body for fetch all open positions

Source: https://docs.trading212.com/api/positions/getpositions

Example JSON response from the GET /api/v0/equity/positions endpoint. It shows an array of position objects with fields like averagePricePaid, createdAt, currentPrice, instrument, quantity, quantityAvailableForTrading, quantityInPies, and walletImpact.

```json
[
  {
    "averagePricePaid": 0,
    "createdAt": "2019-08-24T14:15:22Z",
    "currentPrice": 0,
    "instrument": { … },
    "quantity": 0,
    "quantityAvailableForTrading": 0,
    "quantityInPies": 0,
    "walletImpact": { … }
  }
]
```

--------------------------------

### GET /api/v0/equity/history/orders

Source: https://docs.trading212.com/api/accounts

This snippet documents the pagination mechanism for list endpoints, using the historical orders endpoint as an example. It explains the `limit` and `cursor` query parameters and how to use the `nextPagePath` field to fetch subsequent pages.

```APIDOC
## GET /api/v0/equity/history/orders

### Description
Fetches a paginated list of historical orders. Use the `limit` parameter to control page size and the `cursor` parameter to navigate through pages. The response includes a `nextPagePath` field that provides the full path for the next request.

### Method
GET

### Endpoint
/api/v0/equity/history/orders

### Parameters
#### Query Parameters
- **limit** (integer) - Optional - Maximum number of items to return. Default: 20, Maximum: 50.
- **cursor** (string | number) - Optional - Pointer to a specific item in the dataset, used to fetch the next page.

### Request Example
```
curl -X GET "https://demo.trading212.com/api/v0/equity/history/orders?limit=2" \
     -u "API_KEY:API_SECRET"
```

### Response
#### Success Response (200)
- **items** (array) - List of order objects.
- **nextPagePath** (string | null) - Full path for the next page, or `null` if there are no more pages.

#### Response Example
```
{
  "items": [
    { "id": 987654321, "ticker": "AAPL_US_EQ", ... },
    { "id": 987654320, "ticker": "MSFT_US_EQ", ... }
  ],
  "nextPagePath": "/api/v0/equity/history/orders?limit=2&cursor=1760346100000"
}
```
```

--------------------------------

### GET /api/v0/equity/history/orders

Source: https://docs.trading212.com/api/section/general-information/api-environments

Example of paginating through historical orders using the Trading212 API. Demonstrates how to use the `limit` and `cursor` parameters and the `nextPagePath` field to fetch all pages.

```APIDOC
## [GET] /api/v0/equity/history/orders

### Description
Fetches a paginated list of historical orders. Use the `limit` parameter to control page size and the `cursor` parameter to navigate through pages. The response includes a `nextPagePath` field that provides the full path for the next request.

### Method
GET

### Endpoint
/api/v0/equity/history/orders

### Parameters
#### Query Parameters
- **limit** (integer) - Optional - Maximum number of items to return. Default: 20, Maximum: 50.
- **cursor** (string | number) - Optional - Pointer to a specific item in the dataset, indicating where to start the next page of results.

### Request Example
```
curl -X GET "https://demo.trading212.com/api/v0/equity/history/orders?limit=2" \
     -u "API_KEY:API_SECRET"
```

### Response
#### Success Response (200)
- **items** (array) - List of order objects.
- **nextPagePath** (string | null) - Full path for the next page of results, or `null` if there are no more pages.

#### Response Example
```
{
  "items": [
    { "id": 987654321, "ticker": "AAPL_US_EQ", ... },
    { "id": 987654320, "ticker": "MSFT_US_EQ", ... }
  ],
  "nextPagePath": "/api/v0/equity/history/orders?limit=2&cursor=1760346100000"
}
```
```

--------------------------------

### Request 1: Get the first page with curl

Source: https://docs.trading212.com/api/section/authentication/building-the-authorization-header

Initial request to the orders endpoint with a limit of 2. Do not include a cursor parameter.

```bash
curl -X GET "https://demo.trading212.com/api/v0/equity/history/orders?limit=2" \
     -u "API_KEY:API_SECRET"
```

--------------------------------

### GET /api/v0/equity/pies

Source: https://docs.trading212.com/api/pies-%28deprecated%29

API documentation for the deprecated GET /api/v0/equity/pies endpoint, which fetches all pies for the account.

```APIDOC
## GET /api/v0/equity/pies

### Description
Fetches all pies for the account. This endpoint is deprecated and will not be further supported or updated.

### Method
GET

### Endpoint
/api/v0/equity/pies

### Parameters
#### Security
- **authWithSecretKey** (string) - Required - API key authentication
- **legacyApiKeyHeader** (string) - Required - Legacy API key header authentication

### Request Example
```
curl -i -X GET \
  -u '<username>:<password>' \
  https://demo.trading212.com/api/v0/equity/pies \
  -H 'Authorization: YOUR_API_KEY_HERE'
```

### Response
#### Success Response (200)
- **cash** (number) - Amount of money put into the pie in account currency
- **dividendDetails** (object) - Dividend details object
- **id** (integer, int64) - Pie ID
- **progress** (number) - Progress of the pie based on the set goal (example: 0.5)
- **result** (object) - Investment result object
- **status** (string) - Status of the pie based on the set goal. Enum: "AHEAD", "ON_TRACK", "BEHIND"

#### Response Example
```json
[
  {
    "cash": 0,
    "dividendDetails": { },
    "id": 0,
    "progress": 0.5,
    "result": { },
    "status": "AHEAD"
  }
]
```

### Error Responses
- **401** - Unauthorized
- **403** - Forbidden
- **408** - Request Timeout
- **429** - Too Many Requests
```

--------------------------------

### Request 3: Get the final page

Source: https://docs.trading212.com/api/section/authentication/building-the-authorization-header

Use the nextPagePath from the previous response to fetch the final page.

```bash
curl -X GET "https://demo.trading212.com/api/v0/equity/history/orders?limit=2&cursor=1660015723000" \
     -u "API_KEY:API_SECRET"
```

--------------------------------

### GET /api/v0/equity/metadata/instruments

Source: https://docs.trading212.com/api/instruments/instruments

Retrieves all accessible instruments. Data is refreshed every 10 minutes. Rate limit: 1 request per 50 seconds.

```APIDOC
## GET /api/v0/equity/metadata/instruments

### Description
Retrieves all accessible instruments. Data is refreshed every 10 minutes.

### Method
GET

### Endpoint
/api/v0/equity/metadata/instruments

### Parameters
#### Authentication
- **Authorization** (string) - Required - Your API key. Use the header `Authorization: YOUR_API_KEY_HERE`.
- **Basic Auth** (string) - Required - Username and password for basic authentication.

### Request Example
```
curl -i -X GET \
  -u '<username>:<password>' \
  https://demo.trading212.com/api/v0/equity/metadata/instruments \
  -H 'Authorization: YOUR_API_KEY_HERE'
```

### Response
#### Success Response (200)
- **addedOn** (string, date-time) - On the platform since.
- **currencyCode** (string, 3 characters) - ISO 4217 currency code. Example: "USD".
- **extendedHours** (boolean) - Indicates if extended hours trading is available.
- **isin** (string) - ISIN identifier.
- **maxOpenQuantity** (number) - Maximum open quantity.
- **name** (string) - Instrument name.
- **shortName** (string) - Short name.
- **ticker** (string) - Unique identifier. Example: "AAPL_US_EQ".
- **type** (string) - Instrument type. Enum: "CRYPTOCURRENCY", "ETF", "FOREX", "FUTURES", "INDEX", "STOCK", "WARRANT", "CRYPTO", "CVR", "CORPACT". Example: "ETF".
- **workingScheduleId** (integer, int64) - Identifier for the working schedule. See /exchanges endpoint.

#### Response Example
```json
[
  {
    "addedOn": "2019-08-24T14:15:22Z",
    "currencyCode": "USD",
    "extendedHours": true,
    "isin": "string",
    "maxOpenQuantity": 0,
    "name": "string",
    "shortName": "string",
    "ticker": "AAPL_US_EQ",
    "type": "ETF",
    "workingScheduleId": 0
  }
]
```

### Error Responses
- **401** - Unauthorized
- **403** - Forbidden
- **408** - Request Timeout
- **429** - Too Many Requests

### Rate Limit
1 request per 50 seconds
```

--------------------------------

### Response 2: Get the next page (and a new nextPagePath)

Source: https://docs.trading212.com/api/section/authentication/building-the-authorization-header

The response contains the next page of items and a new nextPagePath for the following request.

```json
{
  "items": [
    { "id": 987654319, "ticker": "AAPL_US_EQ", ... },
    { "id": 987654320, "987654318": "MSFT_US_EQ", ... }
  ],
  "nextPagePath": "/api/v0/equity/history/orders?limit=2&cursor=1660015723000"
}
```

--------------------------------

### Paginate through Trading212 API list endpoints using nextPagePath

Source: https://docs.trading212.com/api

Step-by-step example of fetching all transactions 2 at a time using cursor-based pagination. Each request uses the full nextPagePath from the previous response until nextPagePath is null, indicating the end.

```bash
curl -X GET "https://demo.trading212.com/api/v0/equity/history/orders?limit=2" \
     -u "API_KEY:API_SECRET"
```

```json
{
  "items": [
    { "id": 987654321, "ticker": "AAPL_US_EQ", ... },
    { "id": 987654320, "ticker": "MSFT_US_EQ", ... }
  ],
  "nextPagePath": "/api/v0/equity/history/orders?limit=2&cursor=1760346100000"
}
```

```bash
curl -X GET "https://demo.trading212.com/api/v0/equity/history/orders?limit=2&cursor=1760346100000" \
     -u "API_KEY:API_SECRET"
```

```json
{
  "items": [
    { "id": 987654319, "ticker": "AAPL_US_EQ", ... },
    { "id": 987654320, "987654318": "MSFT_US_EQ", ... }
  ],
  "nextPagePath": "/api/v0/equity/history/orders?limit=2&cursor=1660015723000"
}
```

```bash
curl -X GET "https://demo.trading212.com/api/v0/equity/history/orders?limit=2&cursor=1660015723000" \
     -u "API_KEY:API_SECRET"
```

```json
{
  "items": [
    { "id": 987654317, "ticker": "AMZN_US_EQ", ... }
  ],
  "nextPagePath": null
}
```

--------------------------------

### Response body - reportId

Source: https://docs.trading212.com/api/historical-events/requestreport

Example response body for a successful request. Contains the reportId (integer) used to track the generation status via the GET /history/exports endpoint.

```json
{
  "reportId": 0
}
```

--------------------------------

### POST /api/v0/equity/orders/limit

Source: https://docs.trading212.com/api/orders/placemarketorder

Creates a new Limit order, which executes at a specified price or better. To place a buy order, use a positive quantity; to place a sell order, use a negative quantity. The order will fill at the limitPrice or lower for buys, and at the limitPrice or higher for sells.

```APIDOC
## POST /api/v0/equity/orders/limit

### Description
Creates a new Limit order, which executes at a specified price or better. To place a **buy** order, use a positive `quantity`. The order will fill at the `limitPrice` or lower. To place a **sell** order, use a negative `quantity`. The order will fill at the `limitPrice` or higher.

### Method
POST

### Endpoint
/api/v0/equity/orders/limit

### Parameters
#### Request Body
- **limitPrice** (number) - Required - The limit price for the order. Example: 100.23
- **quantity** (number) - Required - The quantity of shares. Positive for buy, negative for sell. Example: 0.1
- **ticker** (string) - Required - The unique instrument identifier. Example: "AAPL_US_EQ"
- **timeValidity** (string, TimeValidity) - Required - Expiration of the order. Enum: "DAY", "GOOD_TILL_CANCEL". Example: "DAY"

### Request Example
```
curl -i -X POST \
  -u '<username>:<password>' \
  https://demo.trading212.com/api/v0/equity/orders/limit \
  -H 'Authorization: YOUR_API_KEY_HERE' \
  -H 'Content-Type: application/json' \
  -d '{
    "limitPrice": 100.23,
    "quantity": 0.1,
    "ticker": "AAPL_US_EQ",
    "timeValidity": "DAY"
  }'
```

### Response
#### Success Response (200)
- **createdAt** (string, date-time) - The ISO 8601 formatted date of when the order was created.
- **currency** (string) - The currency used for the order in ISO 4217 format.
- **extendedHours** (boolean) - If true, the order is eligible for execution outside regular trading hours.
- **filledQuantity** (number) - The number of shares that have been successfully executed. Applicable to quantity orders.
- **filledValue** (number) - The total monetary value of the executed portion of the order. Applicable to orders placed by value. Note: Placing orders by value is not currently supported via the API but can be done through other Trading 212 platforms.
- **id** (integer, int64) - A unique, system-generated identifier for the order.
- **initiatedFrom** (string) - How the order was initiated. Enum: "API", "IOS", "ANDROID", "WEB", "SYSTEM", "AUTOINVEST", "INSTRUMENT_AUTOINVEST"
- **instrument** (object, Instrument) - Instrument information as given by /instruments endpoint. Contains properties: currency, isin, name, ticker.
- **limitPrice** (number) - Applicable to LIMIT and STOP_LIMIT orders.
- **quantity** (number) - The total number of shares requested. Applicable to quantity orders.
- **side** (string) - Indicates whether the order is BUY or SELL. Enum: "BUY", "SELL"
- **status** (string) - The current state of the order in its lifecycle. Enum: "LOCAL", "UNCONFIRMED", "CONFIRMED", "NEW", "CANCELLING", "CANCELLED", "PARTIALLY_FILLED", "FILLED", "REJECTED", "REPLACING", and one more.
- **stopPrice** (number) - Applicable to STOP and STOP_LIMIT orders.
- **strategy** (string) - The strategy used to place the order, either by QUANTITY or VALUE. The API currently only supports placing orders by QUANTITY. Enum: "QUANTITY", "VALUE"
- **ticker** (string) - Unique instrument identifier. Get from the /instruments endpoint. Example: "AAPL_US_EQ"
- **timeInForce** (string, TimeValidity) - Specifies how long the order remains active. Enum: "DAY", "GOOD_TILL_CANCEL"
- **type** (string) - Enum: "LIMIT", "STOP", "MARKET", "STOP_LIMIT"
- **value** (number) - The total monetary value of the order. Applicable to value orders.

#### Response Example
```
{
  "createdAt": "2019-08-24T14:15:22Z",
  "currency": "string",
  "extendedHours": true,
  "filledQuantity": 0,
  "filledValue": 0,
  "id": 0,
  "initiatedFrom": "API",
  "instrument": {
    "currency": "string",
    "isin": "string",
    "name": "string",
    "ticker": "AAPL_US_EQ"
  },
  "limitPrice": 0,
  "quantity": 0,
  "side": "BUY",
  "status": "LOCAL",
  "stopPrice": 0,
  "strategy": "QUANTITY",
  "ticker": "AAPL_US_EQ",
  "timeInForce": "DAY",
  "type": "LIMIT",
  "value": 0
}
```

### Error Responses
- **400** - Bad Request
- **401** - Unauthorized
- **403** - Forbidden
- **408** - Request Timeout
- **429** - Too Many Requests

```

--------------------------------

### Request 2: Use the full nextPagePath for the next request

Source: https://docs.trading212.com/api/section/authentication/building-the-authorization-header

Use the entire nextPagePath string as the path for the next request. This includes the limit and cursor parameters.

```bash
curl -X GET "https://demo.trading212.com/api/v0/equity/history/orders?limit=2&cursor=1760346100000" \
     -u "API_KEY:API_SECRET"
```

--------------------------------

### Fetch all open positions with curl

Source: https://docs.trading212.com/api/positions/getpositions

Use this curl command to fetch all open positions. It requires basic authentication with username and password, and an API key in the Authorization header. The optional ticker query parameter filters by instrument ticker.

```bash
curl -i -X GET \
  -u '<username>:<password>' \
  'https://demo.trading212.com/api/v0/equity/positions?ticker=AAPL_US_EQ' \
  -H 'Authorization: YOUR_API_KEY_HERE'
```

--------------------------------

### Get a pending order by ID (curl GET request)

Source: https://docs.trading212.com/api/orders/orderbyid

Sends a GET request to retrieve a single pending order using its unique numerical ID. Useful for checking the status of a specific order. Rate limit: 1 req / 1s. Requires authentication with secret key or legacy API key header.

```curl
curl -i -X GET \
  -u '<username>:<password>' \
  'https://demo.trading212.com/api/v0/equity/orders/{id}' \
  -H 'Authorization: YOUR_API_KEY_HERE'
```

--------------------------------

### POST /api/v0/equity/orders/market

Source: https://docs.trading212.com/api/orders/placestoporder_1

Documentation for the POST /api/v0/equity/orders/market endpoint, which creates a new market order.

```APIDOC
## [POST] /api/v0/equity/orders/market

### Description
Creates a new Market order, which is an instruction to trade a security immediately at the next available price. To place a buy order, use a positive quantity; to place a sell order, use a negative quantity.

### Method
POST

### Endpoint
/api/v0/equity/orders/market

### Parameters
#### Request Body
- **extendedHours** (boolean) - Optional - Default: false. Set to true to allow the order to be filled outside of the standard trading session.
- **quantity** (number) - Required - The quantity of shares to trade. Positive for buy, negative for sell.
- **ticker** (string) - Required - Unique instrument identifier. Example: "AAPL_US_EQ".

### Request Example
```
curl -i -X POST \
  -u '<username>:<password>' \
  https://demo.trading212.com/api/v0/equity/orders/market \
  -H 'Authorization: YOUR_API_KEY_HERE' \
  -H 'Content-Type: application/json' \
  -d '{
    "extendedHours": true,
    "quantity": 0.1,
    "ticker": "AAPL_US_EQ"
  }'
```

### Response
#### Success Response (200)
- **createdAt** (string, date-time) - The ISO 8601 formatted date of when the order was created.
- **currency** (string) - The currency used for the order in ISO 4217 format.
- **extendedHours** (boolean) - If true, the order is eligible for execution outside regular trading hours.
- **filledQuantity** (number) - The number of shares that have been successfully executed. Applicable to quantity orders.
- **filledValue** (number) - The total monetary value of the executed portion of the order. Applicable to orders placed by value.
- **id** (integer, int64) - A unique, system-generated identifier for the order.
- **initiatedFrom** (string) - How the order was initiated. Enum: "API", "IOS", "ANDROID", "WEB", "SYSTEM", "AUTOINVEST", "INSTRUMENT_AUTOINVEST".
- **instrument** (object) - Instrument information as given by /instruments endpoint.
- **limitPrice** (number) - Applicable to LIMIT and STOP_LIMIT orders.
- **quantity** (number) - The total number of shares requested. Applicable to quantity orders.
- **side** (string) - Indicates whether the order is BUY or SELL. Enum: "BUY", "SELL".
- **status** (string) - The current state of the order in its lifecycle. Enum: "LOCAL", "UNCONFIRMED", "CONFIRMED", "NEW", "CANCELLING", "CANCELLED", "PARTIALLY_FILLED", "FILLED", "REJECTED", "REPLACING", and one more.
- **stopPrice** (number) - Applicable to STOP and STOP_LIMIT orders.
- **strategy** (string) - The strategy used to place the order, either by QUANTITY or VALUE. The API currently only supports placing orders by QUANTITY. Enum: "QUANTITY", "VALUE".
- **ticker** (string) - Unique instrument identifier. Example: "AAPL_US_EQ".
- **timeInForce** (string) - Specifies how long the order remains active. Enum: "DAY", "GOOD_TILL_CANCEL".
- **type** (string) - Enum: "LIMIT", "STOP", "MARKET", "STOP_LIMIT".
- **value** (number) - The total monetary value of the order. Applicable to value orders.

#### Response Example
```
{
  "createdAt": "2019-08-24T14:15:22Z",
  "currency": "string",
  "extendedHours": true,
  "filledQuantity": 0,
  "filledValue": 0,
  "id": 0,
  "initiatedFrom": "API",
  "instrument": {
    "currency": "string",
    "isin": "string",
    "name": "string",
    "ticker": "AAPL_US_EQ"
  },
  "limitPrice": 0,
  "quantity": 0,
  "side": "BUY",
  "status": "LOCAL",
  "stopPrice": 0,
  "strategy": "QUANTITY",
  "ticker": "AAPL_US_EQ",
  "timeInForce": "DAY",
  "type": "LIMIT",
  "value": 0
}
```

### Error Handling
- **400** - Bad Request
- **401** - Unauthorized
- **403** - Forbidden
- **408** - Request Timeout
- **429** - Too Many Requests

### Notes
- Orders can be executed only in the main account currency.
- Market orders can be subject to price slippage.
- This endpoint is not idempotent in this beta version.
- Rate limit: 50 req / 1m0s.
```

--------------------------------

### Instruments metadata response example

Source: https://docs.trading212.com/api/instruments/instruments

Example JSON response for the instruments endpoint. Shows fields like addedOn, currencyCode, extendedHours, isin, maxOpenQuantity, name, shortName, ticker, type, and workingScheduleId.

```json
[
  {
    "addedOn": "2019-08-24T14:15:22Z",
    "currencyCode": "USD",
    "extendedHours": true,
    "isin": "string",
    "maxOpenQuantity": 0,
    "name": "string",
    "shortName": "string",
    "ticker": "AAPL_US_EQ",
    "type": "ETF",
    "workingScheduleId": 0
  }
]
```

--------------------------------

### Place Market Order with curl

Source: https://docs.trading212.com/api/orders/placemarketorder

Use this curl command to place a market order. It requires your username and password for basic auth and an API key in the Authorization header. The request body includes extendedHours, quantity, and ticker. Note that the endpoint is not idempotent and may create duplicate orders if sent multiple times.

```bash
curl -i -X POST \
  -u '<username>:<password>' \
  https://demo.trading212.com/api/v0/equity/orders/market \
  -H 'Authorization: YOUR_API_KEY_HERE' \
  -H 'Content-Type: application/json' \
  -d '{
    "extendedHours": true,
    "quantity": 0.1,
    "ticker": "AAPL_US_EQ"
  }'
```

--------------------------------

### GET /api/v0/equity/orders

Source: https://docs.trading212.com/api/section/useful-links

Retrieves a list of all equity orders placed on the account.

```APIDOC
## GET /api/v0/equity/orders

### Description
Retrieves a list of all equity orders placed on the account.

### Method
GET

### Endpoint
/api/v0/equity/orders

### Parameters
None

### Response
#### Success Response (200)
- **id** (integer) - The order identifier.
- **ticker** (string) - The instrument ticker.
- **quantity** (number) - The quantity of the order.
- **price** (number) - The price of the order.
- **status** (string) - The order status.

#### Response Example
[
  {
    "id": 1,
    "ticker": "AAPL",
    "quantity": 10,
    "price": 150.00,
    "status": "FILLED"
  }
]
```

--------------------------------

### GET /api/v0/equity/positions

Source: https://docs.trading212.com/api/positions/getpositions

Fetch all open positions for your account. Returns an array of position objects with details such as average price paid, current price, quantity, and wallet impact.

```APIDOC
## GET /api/v0/equity/positions

### Description
Fetch all open positions for your account. Provides a real-time overview including quantity, average price, and current profit or loss.

### Method
GET

### Endpoint
/api/v0/equity/positions

### Parameters
#### Query Parameters
- **ticker** (string) - Optional - Example: ticker=AAPL_US_EQ

### Request Example
```
curl -i -X GET \
  -u '<username>:<password>' \
  'https://demo.trading212.com/api/v0/equity/positions?ticker=AAPL_US_EQ' \
  -H 'Authorization: YOUR_API_KEY_HERE'
```

### Response
#### Success Response (200)
- **averagePricePaid** (number) - Average price paid, in instrument currency, per share.
- **createdAt** (string, date-time) - The ISO 8601 formatted date of when the position was opened.
- **currentPrice** (number) - Current price, in instrument currency, of a single share.
- **instrument** (object) - Instrument information as given by /instruments endpoint.
- **quantity** (number) - Total quantity of shares owned.
- **quantityAvailableForTrading** (number) - Quantity of shares available for trading.
- **quantityInPies** (number) - Quantity of shares currently used in pie.
- **walletImpact** (object) - Collects the financial impact of the position on the user's wallet.

#### Response Example
```json
[
  {
    "averagePricePaid": 0,
    "createdAt": "2019-08-24T14:15:22Z",
    "currentPrice": 0,
    "instrument": { … },
    "quantity": 0,
    "quantityAvailableForTrading": 0,
    "quantityInPies": 0,
    "walletImpact": { … }
  }
]
```
```

--------------------------------

### GET /api/v0/equity/orders/{id}

Source: https://docs.trading212.com/api/section/useful-links

Retrieves details of a specific equity order by its ID.

```APIDOC
## GET /api/v0/equity/orders/{id}

### Description
Retrieves details of a specific equity order by its ID.

### Method
GET

### Endpoint
/api/v0/equity/orders/{id}

### Parameters
#### Path Parameters
- **id** (integer) - Required - The order identifier.

### Response
#### Success Response (200)
- **id** (integer) - The order identifier.
- **ticker** (string) - The instrument ticker.
- **quantity** (number) - The quantity of the order.
- **price** (number) - The price of the order.
- **status** (string) - The order status.

#### Response Example
{
  "id": 1,
  "ticker": "AAPL",
  "quantity": 10,
  "price": 150.00,
  "status": "FILLED"
}
```

--------------------------------

### Get all available instruments with curl

Source: https://docs.trading212.com/api/instruments/instruments

Retrieves all accessible instruments. Data is refreshed every 10 minutes. Rate limit: 1 req / 50s. Requires authentication with username/password and an API key.

```bash
curl -i -X GET \
  -u '<username>:<password>' \
  https://demo.trading212.com/api/v0/equity/metadata/instruments \
  -H 'Authorization: YOUR_API_KEY_HERE'
```

--------------------------------

### GET /api/v0/equity/history/exports

Source: https://docs.trading212.com/api/section/useful-links

Retrieves a list of previously generated CSV export files.

```APIDOC
## GET /api/v0/equity/history/exports

### Description
Retrieves a list of previously generated CSV export files.

### Method
GET

### Endpoint
/api/v0/equity/history/exports

```

--------------------------------

### POST /api/v0/equity/orders/market

Source: https://docs.trading212.com/api/orders/placemarketorder

Creates a new Market order, which is an instruction to trade a security immediately at the next available price. Use a positive quantity for buy orders and a negative quantity for sell orders.

```APIDOC
## [POST] /api/v0/equity/orders/market

### Description
Creates a new Market order, which is an instruction to trade a security immediately at the next available price. Use a positive quantity for buy orders and a negative quantity for sell orders. Set extendedHours to true to allow execution outside standard trading sessions.

### Method
POST

### Endpoint
/api/v0/equity/orders/market

### Parameters
#### Request Body
- **extendedHours** (boolean) - Optional - Default: false. Set to true to allow the order to be filled outside of the standard trading session.
- **quantity** (number) - Required - The quantity of the security to trade. Use a positive value for a buy order and a negative value for a sell order.
- **ticker** (string) - Required - Unique instrument identifier. Example: 
```

--------------------------------

### GET /api/v0/equity/pies/{id}

Source: https://docs.trading212.com/api/section/useful-links

Retrieves details of a specific investment Pie by ID. This endpoint is deprecated.

```APIDOC
## GET /api/v0/equity/pies/{id}

### Description
Retrieves details of a specific investment Pie by ID. This endpoint is deprecated.

### Method
GET

### Endpoint
/api/v0/equity/pies/{id}

### Parameters
#### Path Parameters
- **id** (string) - Required - The unique identifier of the Pie.

### Deprecation
This endpoint is deprecated and will not be further supported.

```
Tokens:
Raw