Trading212 Public API (v0)

Download OpenAPI specification:Download

Instruments Metadata

Tradeable instruments metadata

Exchange List

Fetch all exchanges and their corresponding working schedules that your account has access to

SecurityapiKeyHeader

Responses

200

401

Bad API key

403

Scope( metadata ) missing for API key

408

Timed-out

429

Limited: 1 / 30s

get/api/v0/equity/metadata/exchanges

Request samples

curl
NodeJs
Python
Java
Go

Response samples

application/json

[{"id": 0,
"name": "string",
"workingSchedules": [{"id": 0,
"timeEvents": [{"date": "2019-08-24T14:15:22Z",
"type": "OPEN"
}
]
}
]
}
]

Instrument List

Fetch all instruments that your account has access to

SecurityapiKeyHeader

Responses

200

401

Bad API key

403

Scope( metadata ) missing for API key

408

Timed-out

429

Limited: 1 / 50s

get/api/v0/equity/metadata/instruments

Request samples

curl
NodeJs
Python
Java
Go

Response samples

application/json

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

Pies

Endpoints for managing pies

Fetch all pies

Fetches all pies for the account

SecurityapiKeyHeader

Responses

200

401

Bad API key

403

Scope( pies:read ) missing for API key

408

Timed-out

429

Limited: 1 / 30s

get/api/v0/equity/pies

Request samples

curl
NodeJs
Python
Java
Go

Response samples

application/json

[{"cash": 0,
"dividendDetails": {"gained": 0,
"inCash": 0,
"reinvested": 0
},
"id": 0,
"progress": 0.5,
"result": {"investedValue": 0,
"result": 0,
"resultCoef": 0,
"value": 0
},
"status": "AHEAD"
}
]

Create pie

Creates a pie for the account by given params

SecurityapiKeyHeader

Request

Request Body schema: application/json

dividendCashAction	string Enum: "REINVEST" "TO_ACCOUNT_CASH"
endDate	string <date-time>
goal	number
icon	string Enum: "Home" "PiggyBank" "Iceberg" "Airplane" "RV" "Unicorn" "Whale" "Convertable" "Family" "Coins" "Education" "BillsAndCoins" "Bills" "Water" "Wind" "Car" "Briefcase" "Medical" "Landscape" "Child" "Vault" "Travel" "Cabin" "Apartments" "Burger" "Bus" "Energy" "Factory" "Global" "Leaf" "Materials" "Pill" "Ring" "Shipping" "Storefront" "Tech" "Umbrella"
	object
name	string

Responses

200

400

Bad create request

401

Bad API key

403

Scope( pies:write ) missing for API key

408

Timed-out

429

Limited: 1 / 5s

post/api/v0/equity/pies

Request samples

application/json

{"dividendCashAction": "REINVEST",
"endDate": "2019-08-24T14:15:22Z",
"goal": 0,
"icon": "Home",
"instrumentShares": {"AAPL_US_EQ": 0.5,
"MSFT_US_EQ": 0.5
},
"name": "string"
}

Response samples

application/json

{"instruments": [{"currentShare": 0,
"expectedShare": 0,
"issues": [{"name": "DELISTED",
"severity": "IRREVERSIBLE"
}
],
"ownedQuantity": 0,
"result": {"investedValue": 0,
"result": 0,
"resultCoef": 0,
"value": 0
},
"ticker": "string"
}
],
"settings": {"creationDate": "2019-08-24T14:15:22Z",
"dividendCashAction": "REINVEST",
"endDate": "2019-08-24T14:15:22Z",
"goal": 0,
"icon": "Home",
"id": 0,
"initialInvestment": 0,
"instrumentShares": {"property1": 0,
"property2": 0
},
"name": "string",
"pubicUrl": "string"
}
}

Delete pie

Deletes a pie by given id

SecurityapiKeyHeader

Request

path Parameters

required

integer <int64>

Responses

200

401

Bad API key

403

Scope( pies:write ) missing for API key

404

Pie not found

408

Timed-out

429

Limited: 1 / 5s

delete/api/v0/equity/pies/{id}

Request samples

curl
NodeJs
Python
Java
Go

Response samples

application/json

{ }

Fetch a pie

Fetches a pies for the account with detailed information

SecurityapiKeyHeader

Request

path Parameters

required

integer <int64>

Responses

200

401

Bad API key

403

Scope( pies:read ) missing for API key

408

Timed-out

429

Limited: 1 / 5s

get/api/v0/equity/pies/{id}

Request samples

curl
NodeJs
Python
Java
Go

Response samples

application/json

{"instruments": [{"currentShare": 0,
"expectedShare": 0,
"issues": [{"name": "DELISTED",
"severity": "IRREVERSIBLE"
}
],
"ownedQuantity": 0,
"result": {"investedValue": 0,
"result": 0,
"resultCoef": 0,
"value": 0
},
"ticker": "string"
}
],
"settings": {"creationDate": "2019-08-24T14:15:22Z",
"dividendCashAction": "REINVEST",
"endDate": "2019-08-24T14:15:22Z",
"goal": 0,
"icon": "Home",
"id": 0,
"initialInvestment": 0,
"instrumentShares": {"property1": 0,
"property2": 0
},
"name": "string",
"pubicUrl": "string"
}
}

Update pie

Updates a pie for the account by given params

SecurityapiKeyHeader

Request

path Parameters

required

integer <int64>

Request Body schema: application/json

dividendCashAction	string Enum: "REINVEST" "TO_ACCOUNT_CASH"
endDate	string <date-time>
goal	number
icon	string Enum: "Home" "PiggyBank" "Iceberg" "Airplane" "RV" "Unicorn" "Whale" "Convertable" "Family" "Coins" "Education" "BillsAndCoins" "Bills" "Water" "Wind" "Car" "Briefcase" "Medical" "Landscape" "Child" "Vault" "Travel" "Cabin" "Apartments" "Burger" "Bus" "Energy" "Factory" "Global" "Leaf" "Materials" "Pill" "Ring" "Shipping" "Storefront" "Tech" "Umbrella"
	object
name	string

Responses

200

400

Bad update request

401

Bad API key

403

Scope( pies:write ) missing for API key

408

Timed-out

429

Limited: 1 / 5s

post/api/v0/equity/pies/{id}

Request samples

application/json

{"dividendCashAction": "REINVEST",
"endDate": "2019-08-24T14:15:22Z",
"goal": 0,
"icon": "Home",
"instrumentShares": {"AAPL_US_EQ": 0.5,
"MSFT_US_EQ": 0.5
},
"name": "string"
}

Response samples

application/json

{"instruments": [{"currentShare": 0,
"expectedShare": 0,
"issues": [{"name": "DELISTED",
"severity": "IRREVERSIBLE"
}
],
"ownedQuantity": 0,
"result": {"investedValue": 0,
"result": 0,
"resultCoef": 0,
"value": 0
},
"ticker": "string"
}
],
"settings": {"creationDate": "2019-08-24T14:15:22Z",
"dividendCashAction": "REINVEST",
"endDate": "2019-08-24T14:15:22Z",
"goal": 0,
"icon": "Home",
"id": 0,
"initialInvestment": 0,
"instrumentShares": {"property1": 0,
"property2": 0
},
"name": "string",
"pubicUrl": "string"
}
}

Equity Orders

Order information and dispatcher

Fetch all

SecurityapiKeyHeader

Responses

200

401

Bad API key

403

Scope( orders:read ) missing for API key

408

Timed-out

429

Limited: 1 / 5s

get/api/v0/equity/orders

Request samples

curl
NodeJs
Python
Java
Go

Response samples

application/json

[{"creationTime": "2019-08-24T14:15:22Z",
"filledQuantity": 0,
"filledValue": 0,
"id": 0,
"limitPrice": 0,
"quantity": 0,
"status": "LOCAL",
"stopPrice": 0,
"strategy": "QUANTITY",
"ticker": "AAPL_US_EQ",
"type": "LIMIT",
"value": 0
}
]

Place Limit order

SecurityapiKeyHeader

Request

Request Body schema: application/json

limitPrice	number
quantity	number
ticker	string
timeValidity	string Expiration Enum: "DAY" "GTC"

Responses

200

400

Failed validation

401

Bad API key

403

Scope( orders:execute ) missing for API key

408

Timed-out

429

Limited: 1 / 2s

post/api/v0/equity/orders/limit

Request samples

application/json

{"limitPrice": 100.23,
"quantity": 0.1,
"ticker": "AAPL_US_EQ",
"timeValidity": "DAY"
}

Response samples

application/json

{"creationTime": "2019-08-24T14:15:22Z",
"filledQuantity": 0,
"filledValue": 0,
"id": 0,
"limitPrice": 0,
"quantity": 0,
"status": "LOCAL",
"stopPrice": 0,
"strategy": "QUANTITY",
"ticker": "AAPL_US_EQ",
"type": "LIMIT",
"value": 0
}

Place Market order

SecurityapiKeyHeader

Request

Request Body schema: application/json

quantity	number
ticker	string

Responses

200

400

Failed validation

401

Bad API key

403

Scope( orders:execute ) missing for API key

408

Timed-out

429

Limited: 1 / 1s

post/api/v0/equity/orders/market

Request samples

application/json

{"quantity": 0.1,
"ticker": "AAPL_US_EQ"
}

Response samples

application/json

{"creationTime": "2019-08-24T14:15:22Z",
"filledQuantity": 0,
"filledValue": 0,
"id": 0,
"limitPrice": 0,
"quantity": 0,
"status": "LOCAL",
"stopPrice": 0,
"strategy": "QUANTITY",
"ticker": "AAPL_US_EQ",
"type": "LIMIT",
"value": 0
}

Place Stop order

SecurityapiKeyHeader

Request

Request Body schema: application/json

quantity	number
stopPrice	number
ticker	string
timeValidity	string Expiration Enum: "DAY" "GTC"

Responses

200

400

Failed validation

401

Bad API key

403

Scope( orders:execute ) missing for API key

408

Timed-out

429

Limited: 1 / 2s

post/api/v0/equity/orders/stop

Request samples

application/json

{"quantity": 0.1,
"stopPrice": 100.23,
"ticker": "AAPL_US_EQ",
"timeValidity": "DAY"
}

Response samples

application/json

{"creationTime": "2019-08-24T14:15:22Z",
"filledQuantity": 0,
"filledValue": 0,
"id": 0,
"limitPrice": 0,
"quantity": 0,
"status": "LOCAL",
"stopPrice": 0,
"strategy": "QUANTITY",
"ticker": "AAPL_US_EQ",
"type": "LIMIT",
"value": 0
}

Place StopLimit order

SecurityapiKeyHeader

Request

Request Body schema: application/json

limitPrice	number
quantity	number
stopPrice	number
ticker	string
timeValidity	string Expiration Enum: "DAY" "GTC"

Responses

200

400

Failed validation

401

Bad API key

403

Scope( orders:execute ) missing for API key

408

Timed-out

429

Limited: 1 / 2s

post/api/v0/equity/orders/stop_limit

Request samples

application/json

{"limitPrice": 100.23,
"quantity": 0.1,
"stopPrice": 100.23,
"ticker": "AAPL_US_EQ",
"timeValidity": "DAY"
}

Response samples

application/json

{"creationTime": "2019-08-24T14:15:22Z",
"filledQuantity": 0,
"filledValue": 0,
"id": 0,
"limitPrice": 0,
"quantity": 0,
"status": "LOCAL",
"stopPrice": 0,
"strategy": "QUANTITY",
"ticker": "AAPL_US_EQ",
"type": "LIMIT",
"value": 0
}

Cancel by ID

SecurityapiKeyHeader

Request

path Parameters

required

integer <int64>

Responses

200

400

Not available for real money accounts

401

Bad API key

403

Scope( orders:execute ) missing for API key

404

Order not found

408

Timed-out

429

Limited: 1 / 1s

delete/api/v0/equity/orders/{id}

Request samples

curl
NodeJs
Python
Java
Go

Fetch by ID

SecurityapiKeyHeader

Request

path Parameters

required

integer <int64>

Responses

200

Order found

401

Bad API key

403

Scope( orders:read ) missing for API key

404

Order not found

408

Timed-out

429

Limited: 1 / 1s

get/api/v0/equity/orders/{id}

Request samples

curl
NodeJs
Python
Java
Go

Response samples

application/json

{"creationTime": "2019-08-24T14:15:22Z",
"filledQuantity": 0,
"filledValue": 0,
"id": 0,
"limitPrice": 0,
"quantity": 0,
"status": "LOCAL",
"stopPrice": 0,
"strategy": "QUANTITY",
"ticker": "AAPL_US_EQ",
"type": "LIMIT",
"value": 0
}

Account Data

Relevant information about your account

Fetch account cash

SecurityapiKeyHeader

Responses

200

401

Bad API key

403

Scope( account ) missing for API key

408

Timed-out

429

Limited: 1 / 2s

get/api/v0/equity/account/cash

Request samples

curl
NodeJs
Python
Java
Go

Response samples

application/json

{"blocked": 0,
"free": 0,
"invested": 0,
"pieCash": 0,
"ppl": 0,
"result": 0,
"total": 0
}

Fetch account metadata

SecurityapiKeyHeader

Responses

200

401

Bad API key

403

Scope( account ) missing for API key

408

Timed-out

429

Limited: 1 / 30s

get/api/v0/equity/account/info

Request samples

curl
NodeJs
Python
Java
Go

Response samples

application/json

{"currencyCode": "USD",
"id": 0
}

Personal Portfolio

State of your trading portfolio

Fetch all open positions

Fetch an open positions for your account

SecurityapiKeyHeader

Responses

200

401

Bad API key

403

Scope( portfolio ) missing for API key

408

Timed-out

429

Limited: 1 / 5s

get/api/v0/equity/portfolio

Request samples

curl
NodeJs
Python
Java
Go

Response samples

application/json

[{"averagePrice": 0,
"currentPrice": 0,
"frontend": "API",
"fxPpl": 0,
"initialFillDate": "2019-08-24T14:15:22Z",
"maxBuy": 0,
"maxSell": 0,
"pieQuantity": 0,
"ppl": 0,
"quantity": 0,
"ticker": "AAPL_US_EQ"
}
]

Fetch a specific position

Fetch an open position by ticker

SecurityapiKeyHeader

Request

path Parameters

ticker

required

string

Example: AAPL_US_EQ

Responses

200

400

Invalid ticker supplied

401

Bad API key

403

Scope( portfolio ) missing for API key

404

No open position with that ticker

408

Timed-out

429

Limited: 1 / 1s

get/api/v0/equity/portfolio/{ticker}

Request samples

curl
NodeJs
Python
Java
Go

Response samples

application/json

{"averagePrice": 0,
"currentPrice": 0,
"frontend": "API",
"fxPpl": 0,
"initialFillDate": "2019-08-24T14:15:22Z",
"maxBuy": 0,
"maxSell": 0,
"pieQuantity": 0,
"ppl": 0,
"quantity": 0,
"ticker": "AAPL_US_EQ"
}

Historical items

Reports about past events

Historical order data

SecurityapiKeyHeader

Request

query Parameters

cursor	integer <int64> Pagination cursor
ticker	string Ticker filter
limit	integer <int32> Default: 20 Max items: 50 Example: limit=21

Responses

200

400

Bad filtering arguments

401

Bad API key

403

Scope( history:orders ) missing for API key

408

Timed-out

429

Limited: 6 / 1m0s

get/api/v0/equity/history/orders

Request samples

curl
NodeJs
Python
Java
Go

Response samples

application/json

{"items": [{"dateCreated": "2019-08-24T14:15:22Z",
"dateExecuted": "2019-08-24T14:15:22Z",
"dateModified": "2019-08-24T14:15:22Z",
"executor": "API",
"fillCost": 0,
"fillId": 0,
"fillPrice": 0,
"fillResult": 0,
"fillType": "TOTV",
"filledQuantity": 0,
"filledValue": 0,
"id": 0,
"limitPrice": 0,
"orderedQuantity": 0,
"orderedValue": 0,
"parentOrder": 0,
"status": "LOCAL",
"stopPrice": 0,
"taxes": [{"fillId": "string",
"name": "COMMISSION_TURNOVER",
"quantity": 0,
"timeCharged": "2019-08-24T14:15:22Z"
}
],
"ticker": "string",
"timeValidity": "DAY",
"type": "LIMIT"
}
],
"nextPagePath": "string"
}

Paid out dividends

SecurityapiKeyHeader

Request

query Parameters

cursor	integer <int64> Pagination cursor
ticker	string Ticker filter
limit	integer <int32> Default: 20 Max items: 50 Example: limit=21

Responses

200

400

Bad filtering arguments

401

Bad API key

403

Scope( history:dividends ) missing for API key

408

Timed-out

429

Limited: 6 / 1m0s

get/api/v0/history/dividends

Request samples

curl
NodeJs
Python
Java
Go

Response samples

application/json

{"items": [{"amount": 0,
"amountInEuro": 0,
"grossAmountPerShare": 0,
"paidOn": "2019-08-24T14:15:22Z",
"quantity": 0,
"reference": "string",
"ticker": "string",
"type": "ORDINARY"
}
],
"nextPagePath": "string"
}

Exports List

Lists detailed information about all csv account exports

SecurityapiKeyHeader

Responses

200

400

Bad filtering arguments

401

Bad API key

403

Missing Permissions

408

Timed-out

429

Limited: 1 / 1m0s

get/api/v0/history/exports

Request samples

curl
NodeJs
Python
Java
Go

Response samples

application/json

[{"dataIncluded": {"includeDividends": true,
"includeInterest": true,
"includeOrders": true,
"includeTransactions": true
},
"downloadLink": "string",
"reportId": 0,
"status": "Queued",
"timeFrom": "2019-08-24T14:15:22Z",
"timeTo": "2019-08-24T14:15:22Z"
}
]

Export csv

Request a csv export of the account's orders, dividends and transactions history

SecurityapiKeyHeader

Request

Request Body schema: application/json

	object (ReportDataIncluded)
timeFrom	string <date-time>
timeTo	string <date-time>

Responses

200

400

Bad filtering arguments

401

Bad API key

403

Missing Permissions

408

Timed-out

429

Limited: 1 / 30s

post/api/v0/history/exports

Request samples

application/json

{"dataIncluded": {"includeDividends": true,
"includeInterest": true,
"includeOrders": true,
"includeTransactions": true
},
"timeFrom": "2019-08-24T14:15:22Z",
"timeTo": "2019-08-24T14:15:22Z"
}

Response samples

application/json

{"reportId": 0
}

Transaction list

Fetch superficial information about movements to and from your account

SecurityapiKeyHeader

Request

query Parameters

cursor	string Pagination cursor
limit	integer <int32> Default: 20 Max items: 50 Example: limit=21

Responses

200

400

Bad filtering arguments

401

Bad API key

403

Scope( history:transactions ) missing for API key

408

Timed-out

429

Limited: 6 / 1m0s

get/api/v0/history/transactions

Request samples

curl
NodeJs
Python
Java
Go

Response samples

application/json

{"items": [{"amount": 0,
"dateTime": "2019-08-24T14:15:22Z",
"reference": "string",
"type": "WITHDRAW"
}
],
"nextPagePath": "string"
}