Market Data
GETSymbol price ticker (MARKET_DATA)
API Description
Latest quote for a symbol, or for every symbol.
HTTP Request
HTTP
GET /v1/ticker/priceRequest Weight
1 with symbol, 2 without
Request Parameters
| Name | Type | Mandatory | Description |
|---|---|---|---|
symbol |
STRING | NO | Exact, case-sensitive. Omit for all symbols. |
Response Example
Response (with symbol)
JSON
{"symbol":"XAUUSD","bid":"2331.15","ask":"2331.42","last":"2331.15","time":1789012345678}Response (without symbol) — an array of the same object.
JSON
[
{"symbol":"XAUUSD","bid":"2331.15","ask":"2331.42","last":"2331.15","time":1789012345678},
{"symbol":"BTCUSD","bid":"64120.50","ask":"64135.00","last":"64120.50","time":1789012345671}
]| Field | Type | Description |
|---|---|---|
symbol |
STRING | |
bid |
DECIMAL | Best bid. What a sell fills at. |
ask |
DECIMAL | Best ask. What a buy fills at. |
last |
DECIMAL | Last traded price. On many forex/CFD symbols MT5 reports last as 0 or equal to bid — the tradable prices are bid and ask. |
time |
LONG | Quote time, Unix ms. |
A symbol that is currently streamed is served from the live feed. Otherwise the single-symbol form
reads the last quote from the trade server (-5015 if it cannot be reached), and the all-symbols
form takes bid, ask and last from the trade server's daily statistics with time set to the
moment of the response. If the trade server cannot be reached, the all-symbols form returns only the
streamed symbols — possibly an empty array — rather than an error. An unknown symbol is -1121.