Skip to main content
GET
/
api
/
v1
/
curated-lists
Get curated lists
curl --request GET \
  --url https://public-api.etoro.com/api/v1/curated-lists \
  --header 'x-api-key: <x-api-key>' \
  --header 'x-request-id: <x-request-id>' \
  --header 'x-user-key: <x-user-key>'
{
  "curatedLists": [
    {
      "uuid": "12345",
      "name": "Tech Watchlist",
      "description": "A list of tech stocks",
      "listImageUrl": "https://example.com/tech-watchlist.jpg",
      "items": [
        {
          "instrumentId": 12345
        }
      ]
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://api-portal.etoro.com/llms.txt

Use this file to discover all available pages before exploring further.

Headers

​
x-request-id
string<uuid>
required

A unique request identifier.

Example:

"e4af9d96-c96c-4dcd-a334-84648edf0aa7"

​
x-api-key
string<password>
required

API key for authentication.

Example:

"lhgfaslk21490FAScVPkdsb53F9dNkfHG4faZSG5vfjndfcfgdssdgsdHF4663"

​
x-user-key
string<password>
required

User-specific authentication key.

Example:

"eyJlYW4iOiJVbnJlZ2lzdGVyZWRBcHBsaWNhdGlvbiIsImVrIjoiOE5sZ2cwcW5EUVdROUFNWGpXT2lmOWktZnpidG5KcUlqWGJ3WHJZZkpZcldrbG90ZEhvLVBjSWhQaU8xU1ZtMW84aU1WZGZqN2xWNzFjLXFxLmcybXE1dnh4Q1hUT25xaWRUaTFlcEhmVk1fIn0_"

Response

Successfully retrieved curated lists

Response containing curated investment lists

​
curatedLists
object[]

List of curated investment lists