{
"id": "ed72693c-1545-4fa1-8a10-aca7cf5419a6",
"operation": "Authenticate",
"data": {
"userKey": "<your user key>",
"apiKey": "<your API key>"
}
}{
"id": "ed72693c-1545-4fa1-8a10-aca7cf5419a6",
"operation": "Subscribe",
"data": {
"topics": [
"instrument:100000"
],
"snapshot": true
}
}{
"id": "ed72693c-1545-4fa1-8a10-aca7cf5419a6",
"operation": "Unsubscribe",
"data": {
"topics": [
"instrument:100000"
]
}
}Control channel (request / response)
All client requests share one JSON envelope: { "id": "<guid>", "operation": "<Authenticate|Subscribe|Unsubscribe>", "data": { ... } }. The server answers each request on the same connection with an acknowledgement that echoes the id and the operation. The id is a client-generated GUID used to correlate the request with its acknowledgement.
{
"id": "ed72693c-1545-4fa1-8a10-aca7cf5419a6",
"operation": "Authenticate",
"data": {
"userKey": "<your user key>",
"apiKey": "<your API key>"
}
}{
"id": "ed72693c-1545-4fa1-8a10-aca7cf5419a6",
"operation": "Subscribe",
"data": {
"topics": [
"instrument:100000"
],
"snapshot": true
}
}{
"id": "ed72693c-1545-4fa1-8a10-aca7cf5419a6",
"operation": "Unsubscribe",
"data": {
"topics": [
"instrument:100000"
]
}
}etoro API credentials, sent as a pair inside the Authenticate request's data object -- userKey (the user identifier) and apiKey (the secret) -- not as an HTTP header. Required before subscribing to any topic, public market data included: the WebSocket service rejects a Subscribe or Unsubscribe on an unauthenticated session with SessionNotAuthenticated. Both values come from the API key section of etoro account settings, which appears once the account is verified.
GET
Authenticate the WebSocket session with your API credentials.
Subscribe to one or more topics.
Stop receiving messages for one or more topics.