eToro candle:{instrumentId}
Candle updates for one instrument: each push carries the open, high, low, close and volume of one interval. The page says no authentication is needed.
Risk warning: CFDs and spread bets are complex instruments and come with a high risk of losing money rapidly due to leverage. You can lose money on these products, and each provider publishes its own loss figure under FCA rules. You should consider whether you understand how they work and whether you can afford to take the high risk of losing your money. Automated and API trading can amplify losses through bugs, connectivity failures and runaway orders.
This is a subscription of the eToro WebSocket API, not an HTTP endpoint. It has no method and no path: it is sent as JSON over an open WebSocket connection.
Subscribed to with the Subscribe request, with the instrument's id in place of {instrumentId}, for example candle:100000. eToro's Topics page describes the instrument and private topics and does not mention this one, so this record rests on the candles page and the AsyncAPI document alone. Neither says how an interval is chosen.
The message
- Name
- candle:{instrumentId}
- Direction
- Subscription, opened by the client and then fed by the server
- Subscribed to as
- candle:{instrumentId}
- Carried by
- WebSocket.
- WebSocket address
- wss://ws.etoro.com/ws
- Answers
Fields
| Name | Type | Description |
|---|---|---|
| messagesrequired | array of objects | The envelope of every push. It holds one update or several. |
| messages[].topicrequired | string | The topic the update belongs to, such as candle:100000. |
| messages[].typerequired | string | Says what kind of update it is. Here it is Trading.Instrument.Candle. |
| messages[].idrequired | string (uuid) | The id of this push message. |
| messages[].contentrequired | string | The update itself, as a string of JSON that has to be parsed a second time. The fields below, written content.Name, are what that string holds. |
| content.InstrumentID | integer | The instrument the candle is for. |
| content.Interval | string | The interval of the candle. The page's examples are 1m, 5m and 1h. |
| content.Open | number (float) | The opening price. |
| content.High | number (float) | The highest price. |
| content.Low | number (float) | The lowest price. |
| content.Close | number (float) | The closing price. |
| content.Volume | number (float) | The volume in the interval. |
| content.OpenTime | string (date-time) | When the interval opened. |
| content.CloseTime | string (date-time) | When the interval closed. |
Limits that apply at eToro
| Limit | Value | Scope | Source |
|---|---|---|---|
| Headline limit | 60/min reads per key | user | api-portal.etoro.comchecked |