Market Data
GETRecent ticks (MARKET_DATA)
API Description
The most recent ticks for a symbol.
HTTP Request
HTTP
GET /v1/ticksRequest Weight
2
Request Parameters
| Name | Type | Mandatory | Description |
|---|---|---|---|
symbol |
STRING | YES | Exact, case-sensitive. |
limit |
INT | NO | Default 100, range 1–1000 (-1130 outside it). Fewer are returned if the buffer holds fewer. |
Response Example
Response — oldest first.
JSON
[
{"symbol":"XAUUSD","bid":"2331.14","ask":"2331.41","last":"2331.14","volume":3,"bidDirection":-1,"askDirection":-1,"time":1789012345601},
{"symbol":"XAUUSD","bid":"2331.15","ask":"2331.42","last":"2331.15","volume":8,"bidDirection":1,"askDirection":1,"time":1789012345678}
]| Field | Type | Description |
|---|---|---|
symbol |
STRING | |
bid / ask / last |
DECIMAL | |
volume |
LONG | Tick volume reported with the quote. |
bidDirection / askDirection |
INT | 1 up, -1 down, 0 unchanged versus the previous tick. |
time |
LONG | Tick time, Unix ms. |
An empty array means the symbol is not currently streamed. Subscribing to <SYMBOL>@tick on the
WebSocket starts the feed for that symbol; the buffer fills from that point on.