curl --request POST \
--url https://public-api.etoro.com/api/v1/registration/users \
--header 'Content-Type: application/json' \
--header 'X-Request-Id: <x-request-id>' \
--header 'x-api-key: <api-key>' \
--header 'x-user-key: <api-key>' \
--data '
{
"countryIso": "GB",
"consents": [
{
"signedAt": "2026-05-27T12:00:00Z",
"documentId": 42,
"clientIp": "1.2.3.4"
}
],
"languageIso": "en-gb",
"username": "partneruser01",
"email": "user@example.com",
"partnerCorrelationId": "partner-ref-001"
}
'import requests
url = "https://public-api.etoro.com/api/v1/registration/users"
payload = {
"countryIso": "GB",
"consents": [
{
"signedAt": "2026-05-27T12:00:00Z",
"documentId": 42,
"clientIp": "1.2.3.4"
}
],
"languageIso": "en-gb",
"username": "partneruser01",
"email": "user@example.com",
"partnerCorrelationId": "partner-ref-001"
}
headers = {
"X-Request-Id": "<x-request-id>",
"x-api-key": "<api-key>",
"x-user-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
'X-Request-Id': '<x-request-id>',
'x-api-key': '<api-key>',
'x-user-key': '<api-key>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
countryIso: 'GB',
consents: [{signedAt: '2026-05-27T12:00:00Z', documentId: 42, clientIp: '1.2.3.4'}],
languageIso: 'en-gb',
username: 'partneruser01',
email: 'user@example.com',
partnerCorrelationId: 'partner-ref-001'
})
};
fetch('https://public-api.etoro.com/api/v1/registration/users', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://public-api.etoro.com/api/v1/registration/users",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'countryIso' => 'GB',
'consents' => [
[
'signedAt' => '2026-05-27T12:00:00Z',
'documentId' => 42,
'clientIp' => '1.2.3.4'
]
],
'languageIso' => 'en-gb',
'username' => 'partneruser01',
'email' => 'user@example.com',
'partnerCorrelationId' => 'partner-ref-001'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-Request-Id: <x-request-id>",
"x-api-key: <api-key>",
"x-user-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://public-api.etoro.com/api/v1/registration/users"
payload := strings.NewReader("{\n \"countryIso\": \"GB\",\n \"consents\": [\n {\n \"signedAt\": \"2026-05-27T12:00:00Z\",\n \"documentId\": 42,\n \"clientIp\": \"1.2.3.4\"\n }\n ],\n \"languageIso\": \"en-gb\",\n \"username\": \"partneruser01\",\n \"email\": \"user@example.com\",\n \"partnerCorrelationId\": \"partner-ref-001\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-Request-Id", "<x-request-id>")
req.Header.Add("x-api-key", "<api-key>")
req.Header.Add("x-user-key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://public-api.etoro.com/api/v1/registration/users")
.header("X-Request-Id", "<x-request-id>")
.header("x-api-key", "<api-key>")
.header("x-user-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"countryIso\": \"GB\",\n \"consents\": [\n {\n \"signedAt\": \"2026-05-27T12:00:00Z\",\n \"documentId\": 42,\n \"clientIp\": \"1.2.3.4\"\n }\n ],\n \"languageIso\": \"en-gb\",\n \"username\": \"partneruser01\",\n \"email\": \"user@example.com\",\n \"partnerCorrelationId\": \"partner-ref-001\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://public-api.etoro.com/api/v1/registration/users")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-Request-Id"] = '<x-request-id>'
request["x-api-key"] = '<api-key>'
request["x-user-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"countryIso\": \"GB\",\n \"consents\": [\n {\n \"signedAt\": \"2026-05-27T12:00:00Z\",\n \"documentId\": 42,\n \"clientIp\": \"1.2.3.4\"\n }\n ],\n \"languageIso\": \"en-gb\",\n \"username\": \"partneruser01\",\n \"email\": \"user@example.com\",\n \"partnerCorrelationId\": \"partner-ref-001\"\n}"
response = http.request(request)
puts response.read_body{
"success": true,
"data": {
"username": "partneruser01",
"loginSucceeded": true,
"partnerCorrelationId": "partner-ref-001",
"loginInfo": {}
}
}Partner registers a new etoro user
Rate limit: 60 requests per 60 seconds. This is the default shared quota — it is shared with every other endpoint that has no dedicated limit, so requests across those endpoints all draw from the same budget.
Registers a user on behalf of the partner. No password is supplied; etoro generates one. The synchronous response includes a user-scoped token bundle (access token, plus an ID token for the registration flow) issued by sts-idp with claims scoped by the SSO client_id resolved from X-ClientId, so the partner can chain the rest of the flow without an interactive login.
username is optional: when it is omitted, etoro generates one and returns it in data.username.
curl --request POST \
--url https://public-api.etoro.com/api/v1/registration/users \
--header 'Content-Type: application/json' \
--header 'X-Request-Id: <x-request-id>' \
--header 'x-api-key: <api-key>' \
--header 'x-user-key: <api-key>' \
--data '
{
"countryIso": "GB",
"consents": [
{
"signedAt": "2026-05-27T12:00:00Z",
"documentId": 42,
"clientIp": "1.2.3.4"
}
],
"languageIso": "en-gb",
"username": "partneruser01",
"email": "user@example.com",
"partnerCorrelationId": "partner-ref-001"
}
'import requests
url = "https://public-api.etoro.com/api/v1/registration/users"
payload = {
"countryIso": "GB",
"consents": [
{
"signedAt": "2026-05-27T12:00:00Z",
"documentId": 42,
"clientIp": "1.2.3.4"
}
],
"languageIso": "en-gb",
"username": "partneruser01",
"email": "user@example.com",
"partnerCorrelationId": "partner-ref-001"
}
headers = {
"X-Request-Id": "<x-request-id>",
"x-api-key": "<api-key>",
"x-user-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
'X-Request-Id': '<x-request-id>',
'x-api-key': '<api-key>',
'x-user-key': '<api-key>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
countryIso: 'GB',
consents: [{signedAt: '2026-05-27T12:00:00Z', documentId: 42, clientIp: '1.2.3.4'}],
languageIso: 'en-gb',
username: 'partneruser01',
email: 'user@example.com',
partnerCorrelationId: 'partner-ref-001'
})
};
fetch('https://public-api.etoro.com/api/v1/registration/users', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://public-api.etoro.com/api/v1/registration/users",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'countryIso' => 'GB',
'consents' => [
[
'signedAt' => '2026-05-27T12:00:00Z',
'documentId' => 42,
'clientIp' => '1.2.3.4'
]
],
'languageIso' => 'en-gb',
'username' => 'partneruser01',
'email' => 'user@example.com',
'partnerCorrelationId' => 'partner-ref-001'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-Request-Id: <x-request-id>",
"x-api-key: <api-key>",
"x-user-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://public-api.etoro.com/api/v1/registration/users"
payload := strings.NewReader("{\n \"countryIso\": \"GB\",\n \"consents\": [\n {\n \"signedAt\": \"2026-05-27T12:00:00Z\",\n \"documentId\": 42,\n \"clientIp\": \"1.2.3.4\"\n }\n ],\n \"languageIso\": \"en-gb\",\n \"username\": \"partneruser01\",\n \"email\": \"user@example.com\",\n \"partnerCorrelationId\": \"partner-ref-001\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-Request-Id", "<x-request-id>")
req.Header.Add("x-api-key", "<api-key>")
req.Header.Add("x-user-key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://public-api.etoro.com/api/v1/registration/users")
.header("X-Request-Id", "<x-request-id>")
.header("x-api-key", "<api-key>")
.header("x-user-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"countryIso\": \"GB\",\n \"consents\": [\n {\n \"signedAt\": \"2026-05-27T12:00:00Z\",\n \"documentId\": 42,\n \"clientIp\": \"1.2.3.4\"\n }\n ],\n \"languageIso\": \"en-gb\",\n \"username\": \"partneruser01\",\n \"email\": \"user@example.com\",\n \"partnerCorrelationId\": \"partner-ref-001\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://public-api.etoro.com/api/v1/registration/users")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-Request-Id"] = '<x-request-id>'
request["x-api-key"] = '<api-key>'
request["x-user-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"countryIso\": \"GB\",\n \"consents\": [\n {\n \"signedAt\": \"2026-05-27T12:00:00Z\",\n \"documentId\": 42,\n \"clientIp\": \"1.2.3.4\"\n }\n ],\n \"languageIso\": \"en-gb\",\n \"username\": \"partneruser01\",\n \"email\": \"user@example.com\",\n \"partnerCorrelationId\": \"partner-ref-001\"\n}"
response = http.request(request)
puts response.read_body{
"success": true,
"data": {
"username": "partneruser01",
"loginSucceeded": true,
"partnerCorrelationId": "partner-ref-001",
"loginInfo": {}
}
}Authorizations
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
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_
Scopes
Body
Request body for partner user registration.
Optional. Desired username for the new account. If omitted, etoro generates a username and returns it in data.username. Effective rules: 6-16 characters; letters, digits, underscore and hyphen only; leading and trailing spaces are trimmed; names of trading instruments are not allowed. Check a username first with POST /api/v1/registration/users/usernames/validate.
4 - 20"partneruser01"