{
"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"
]
}
}{
"messages": [
{
"topic": "candle:100000",
"content": "{\"InstrumentID\":100000,\"Interval\":\"1m\",\"Open\":83900.10,\"High\":84200.55,\"Low\":83850.00,\"Close\":84072.94,\"Volume\":12.348,\"OpenTime\":\"2025-04-01T08:36:00Z\",\"CloseTime\":\"2025-04-01T08:37:00Z\"}",
"id": "c92e5f3b-8d4a-4b71-9e23-6f7a8b9c0d12",
"type": "Trading.Instrument.Candle"
}
]
}Instrument candles
Subscribe with topic candle:<instrumentId> (e.g. candle:100000). Each push carries a content field that is a JSON-encoded string of a Trading.Instrument.Candle object (see schema). Requires a prior successful Authenticate, like every topic.
{
"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"
]
}
}{
"messages": [
{
"topic": "candle:100000",
"content": "{\"InstrumentID\":100000,\"Interval\":\"1m\",\"Open\":83900.10,\"High\":84200.55,\"Low\":83850.00,\"Close\":84072.94,\"Volume\":12.348,\"OpenTime\":\"2025-04-01T08:36:00Z\",\"CloseTime\":\"2025-04-01T08:37:00Z\"}",
"id": "c92e5f3b-8d4a-4b71-9e23-6f7a8b9c0d12",
"type": "Trading.Instrument.Candle"
}
]
}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.
A batch of one or more instrument candle updates.