Please note that this documentation site is deprecated and is no longer being maintained. For the latest, most accurate information, please visit our new API documentation portal:

https://docs.trading212.com/

Welcome to the official documentation for the Trading 212 Public API! This guide provides all the information you need to start building your own trading applications and integrations.

This API is currently in beta and is under active development. We're continuously adding new features and improvements, and we welcome your feedback.

API Environments

We provide two distinct environments for development and trading:

• Paper Trading (Demo): https://demo.trading212.com/api/v0
• Live Trading (Real Money): https://live.trading212.com/api/v0

You can test your applications extensively in the paper trading environment without risking real funds before moving to live trading.

⚠️ Beta Limitations

Please be aware of the following limitations during the beta period:

• Live Trading Orders: For the live (real money) environment, only Market Orders are supported for execution via the API at this time.

Key Concepts

• Authentication: Every request to the API must be authenticated using a secure key pair. See the Authentication section below for details.
• Rate Limiting: All API calls are subject to rate limits to ensure fair usage and stability. See the Rate Limiting section for a full explanation.
• IP Restrictions: For enhanced security, you can optionally restrict your API keys to a specific set of IP addresses from within your Trading 212 account settings.
• Selling Orders: To execute a sell order, you must provide a negative value for the quantity parameter (e.g., -10.5). This is a core convention of the API.

This simple example shows you how to retrieve your account's cash balance.

First, you must generate your API keys from within the Trading 212 mobile app. For detailed instructions, please visit our Help Centre:

• How to get your Trading 212 API key

Once you have your API Key and API Secret, you can make your first call using cURL:

# Step 1: Replace with your actual credentials and Base64-encode them.
# The `-n` is important as it prevents adding a newline character.
CREDENTIALS=$(echo -n "<YOUR_API_KEY>:<YOUR_API_SECRET>" | base64)

# Step 2: Make the API call to the live environment using the encoded credentials.
curl -X GET "[https://live.trading212.com/api/v0/equity/account/cash](https://live.trading212.com/api/v0/equity/account/cash)" \
     -H "Authorization: Basic $CREDENTIALS"

The API uses a secure key pair for authentication on every request. You must provide your API Key as the username and your API Secret as the password, formatted as an HTTP Basic Authentication header.

The Authorization header is constructed by Base64-encoding your API_KEY:API_SECRET string and prepending it with Basic .

Building the Authorization Header

Here are examples of how to generate the required value in different environments.

Linux or macOS (Terminal)

You can use the echo and base64 commands. Remember to use the -n flag with echo to prevent it from adding a trailing newline, which would invalidate the credential string.

# This command outputs the required Base64-encoded string for your header.
echo -n "<YOUR_API_KEY>:<YOUR_API_SECRET>" | base64

Python

This simple snippet shows how to generate the full header value.

import base64

# 1. Your credentials
api_key = "<YOUR_API_KEY>"
api_secret = "<YOUR_API_SECRET>"

# 2. Combine them into a single string
credentials_string = f"{api_key}:{api_secret}"

# 3. Encode the string to bytes, then Base64 encode it
encoded_credentials = base64.b64encode(credentials_string.encode('utf-8')).decode('utf-8')

# 4. The final header value
auth_header = f"Basic {encoded_credentials}"

print(auth_header)

To ensure high performance and fair access for all users, all API endpoints are subject to rate limiting.

IMPORTANT NOTE: All rate limits are applied on a per-account basis, regardless of which API key is used or which IP address the request originates from.

Specific rate limits are detailed in the reference for each endpoint.

Response Headers

Every API response includes the following headers to help you manage your request frequency and avoid hitting limits.

• x-ratelimit-limit: The total number of requests allowed in the current time period.
• x-ratelimit-period: The duration of the time period in seconds.
• x-ratelimit-remaining: The number of requests you have left in the current period.
• x-ratelimit-reset: A Unix timestamp indicating the exact time when the limit will be fully reset.
• x-ratelimit-used: The number of requests you have already made in the current period.

How It Works

The rate limiter allows for requests to be made in bursts. For example, an endpoint with a limit of 50 requests per 1 minute does not strictly mean you can only make one request every 1.2 seconds. Instead, you could:

• Make a burst of all 50 requests in the first 5 seconds of a minute. You would then need to wait for the reset time indicated by the x-ratelimit-reset header before making more requests.
• Pace your requests evenly, for example, by making one call every 1.2 seconds, ensuring you always stay within the limit.

Function-Specific Limits

In addition to the general rate limits on HTTP calls, some actions have their own functional limits. For example, there is a maximum of 50 pending orders allowed per ticker, per account.

Here are some additional resources that you may find helpful.

• Trading 212 API Terms
• Trading 212 Community Forum - A great place to ask questions and share what you've built.

Manage your investment Pies. Use these endpoints to create, view, update, and delete your custom portfolios, making automated and diversified investing simple.

Place, monitor, and cancel equity trade orders. This section provides the core functionality for programmatically executing your trading strategies for stocks and ETFs.

Access fundamental information about your trading account. Retrieve details such as your account ID, currency, and current cash balance.

View the current state of your portfolio. Get a real-time overview of all your open positions, including quantity, average price, and current profit or loss.

Discover what you can trade. These endpoints provide comprehensive lists of all tradable instruments and the exchanges they belong to, including details like tickers and trading hours.

Review your account's trading history. Access detailed records of past orders, dividend payments, and cash transactions, or generate downloadable CSV reports for analysis and record-keeping.