curl --request GET \
--url https://public-api.etoro.com/api/v1/data/stockback/payments \
--header 'x-api-key: <api-key>' \
--header 'x-request-id: <x-request-id>' \
--header 'x-user-key: <api-key>'import requests
url = "https://public-api.etoro.com/api/v1/data/stockback/payments"
headers = {
"x-request-id": "<x-request-id>",
"x-api-key": "<api-key>",
"x-user-key": "<api-key>"
}
response = requests.get(url, headers=headers)
print(response.text)const options = {
method: 'GET',
headers: {
'x-request-id': '<x-request-id>',
'x-api-key': '<api-key>',
'x-user-key': '<api-key>'
}
};
fetch('https://public-api.etoro.com/api/v1/data/stockback/payments', 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/data/stockback/payments",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"x-api-key: <api-key>",
"x-request-id: <x-request-id>",
"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"
"net/http"
"io"
)
func main() {
url := "https://public-api.etoro.com/api/v1/data/stockback/payments"
req, _ := http.NewRequest("GET", url, nil)
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>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://public-api.etoro.com/api/v1/data/stockback/payments")
.header("x-request-id", "<x-request-id>")
.header("x-api-key", "<api-key>")
.header("x-user-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://public-api.etoro.com/api/v1/data/stockback/payments")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-request-id"] = '<x-request-id>'
request["x-api-key"] = '<api-key>'
request["x-user-key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"results": [
{
"channel": "stockback",
"paidUsd": 12.5,
"stockName": "AAPL",
"positionId": 9001,
"sourceTxId": "tx-1",
"txLabel": "Stockback reward",
"paymentDate": "2026-10-01",
"eom": "2026-10-31"
},
{
"channel": "cashback",
"paidUsd": 3,
"stockName": null,
"positionId": null,
"sourceTxId": null,
"txLabel": null,
"paymentDate": "2026-09-01",
"eom": "2026-09-30"
}
],
"pagination": {
"page": 1,
"pageSize": 50,
"hasNext": false
}
}{
"success": false,
"error": {
"code": "INVALID_REQUEST",
"message": "The request is invalid"
}
}{
"success": false,
"error": {
"code": "GCID_REQUIRED",
"message": "This endpoint requires a gateway-issued GCID"
}
}{
"success": false,
"error": {
"code": "DEPENDENCY_UNAVAILABLE",
"message": "The requested resource is temporarily unavailable"
}
}Get Stockback Payments
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.
Retrieves information about the rewards given to the calling user as part of the 4% Card Promo stock-back promotion. The data is returned as a list of individual reward events, each with the date the reward was given, the stock name, and the amount in USD.
Rewards fall into two types:
- Stock reward (airdrop) — stock deposited directly into the user’s account
- Cash reward — paid when the user is unable to receive a stock airdrop, or in case the user is a Popular Investor (PI)
This is user-scoped: the caller is identified by their own gateway-issued GCID, not a path or query parameter, so it always answers for ‘me’. Results are returned under results with a pagination block; a customer with no payments returns 200 with an empty results array, not 404.
curl --request GET \
--url https://public-api.etoro.com/api/v1/data/stockback/payments \
--header 'x-api-key: <api-key>' \
--header 'x-request-id: <x-request-id>' \
--header 'x-user-key: <api-key>'import requests
url = "https://public-api.etoro.com/api/v1/data/stockback/payments"
headers = {
"x-request-id": "<x-request-id>",
"x-api-key": "<api-key>",
"x-user-key": "<api-key>"
}
response = requests.get(url, headers=headers)
print(response.text)const options = {
method: 'GET',
headers: {
'x-request-id': '<x-request-id>',
'x-api-key': '<api-key>',
'x-user-key': '<api-key>'
}
};
fetch('https://public-api.etoro.com/api/v1/data/stockback/payments', 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/data/stockback/payments",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"x-api-key: <api-key>",
"x-request-id: <x-request-id>",
"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"
"net/http"
"io"
)
func main() {
url := "https://public-api.etoro.com/api/v1/data/stockback/payments"
req, _ := http.NewRequest("GET", url, nil)
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>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://public-api.etoro.com/api/v1/data/stockback/payments")
.header("x-request-id", "<x-request-id>")
.header("x-api-key", "<api-key>")
.header("x-user-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://public-api.etoro.com/api/v1/data/stockback/payments")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-request-id"] = '<x-request-id>'
request["x-api-key"] = '<api-key>'
request["x-user-key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"results": [
{
"channel": "stockback",
"paidUsd": 12.5,
"stockName": "AAPL",
"positionId": 9001,
"sourceTxId": "tx-1",
"txLabel": "Stockback reward",
"paymentDate": "2026-10-01",
"eom": "2026-10-31"
},
{
"channel": "cashback",
"paidUsd": 3,
"stockName": null,
"positionId": null,
"sourceTxId": null,
"txLabel": null,
"paymentDate": "2026-09-01",
"eom": "2026-09-30"
}
],
"pagination": {
"page": 1,
"pageSize": 50,
"hasNext": false
}
}{
"success": false,
"error": {
"code": "INVALID_REQUEST",
"message": "The request is invalid"
}
}{
"success": false,
"error": {
"code": "GCID_REQUIRED",
"message": "This endpoint requires a gateway-issued GCID"
}
}{
"success": false,
"error": {
"code": "DEPENDENCY_UNAVAILABLE",
"message": "The requested resource is temporarily unavailable"
}
}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
Headers
Query Parameters
Response
One page of the caller's stockback payments, newest payment date first.
One page of the caller's stockback payments. The collection is a property of this object rather than a bare top-level array, so further fields can be added without a breaking change.