Forex

Major FX pairs and crosses as six-character symbols (e.g. EURUSD), priced as indicative OTC-style quotes.

Authx-api-key headerBase path/forexWebSocketforex.quotes · forex.tradesSymbol formatSix-letter pairs (e.g. EURUSD, GBPJPY, USDTRY)

Symbols

Pairs are six-letter codes such as EURUSD, GBPJPY and USDTRY; list the enabled ones with GET /forex/symbols (Symbols). A raw single-venue line is also served as SYMBOL.RAW, outside the symbol list: see Raw line.

GET/forex/symbols

Open .md

Symbol list

Returns enabled FX pairs and crosses, sorted by symbol ascending.

Request

curl -sS "https://api.tickerlayer.com/forex/symbols" \
  -H "x-api-key: <YOUR_API_KEY>"

Response 200 OK

{
  "symbols": [
    { "symbol": "EURUSD", "name": "Euro / United States Dollar" },
    { "symbol": "GBPUSD", "name": "British Pound / United States Dollar" }
  ]
}

GET/forex/quote/:symbol

Open .md

Latest quote

Bid and ask from the aggregated FX quote cache when present; otherwise resolved via the REST aggregation path for the pair.

Path parameters

symbolstringRequired: Enabled forex pair (e.g. EURUSD). Six-character concatenated pair, trimmed and uppercased before lookup. Retrieve the full list from GET /forex/symbols.

Request

Symbol

curl -sS "https://api.tickerlayer.com/forex/quote/EURUSD" \
  -H "x-api-key: <YOUR_API_KEY>"

Send runs against the live API with your account key (never exposed in the browser).

Response 200 OK

{
  "symbol": "EURUSD",
  "bid": 1.0522,
  "ask": 1.0524,
  "bid_size": 42,
  "ask_size": 37,
  "timestamp": 1743512400000
}

Notes

404 unknown symbol if the pair is not in the enabled registry.

GET/forex/trade/last/:symbol

Open .md

Last trade

Most recent trade from the aggregated tape when present; when the tape snapshot is empty, price and timestamp fall back to the consolidated quote mid.

Path parameters

symbolstringRequired: Enabled forex pair (e.g. EURUSD). Six-character concatenated pair, trimmed and uppercased before lookup. Retrieve the full list from GET /forex/symbols.

Request

Symbol

curl -sS "https://api.tickerlayer.com/forex/trade/last/EURUSD" \
  -H "x-api-key: <YOUR_API_KEY>"

Send runs against the live API with your account key (never exposed in the browser).

Response 200 OK

{
  "symbol": "EURUSD",
  "price": 1.0523,
  "size": 96,
  "timestamp": 1743512400000
}

Notes

size is number | null: it may occasionally be null when no lot size exists in the consolidated view.

GET/forex/snapshot/:symbol

Open .md

Snapshot

Combined bid/ask, last price, previous daily close, and derived change metrics in one normalized aggregated view.

Path parameters

symbolstringRequired: Enabled forex pair (e.g. EURUSD). Six-character concatenated pair, trimmed and uppercased before lookup. Retrieve the full list from GET /forex/symbols.

Request

Symbol

curl -sS "https://api.tickerlayer.com/forex/snapshot/EURUSD" \
  -H "x-api-key: <YOUR_API_KEY>"

Send runs against the live API with your account key (never exposed in the browser).

Response 200 OK

{
  "symbol": "EURUSD",
  "bid": 1.0522,
  "ask": 1.0524,
  "bid_size": 42,
  "ask_size": 37,
  "last_price": 1.0523,
  "last_timestamp": 1743512400000,
  "prev_close": 1.0480,
  "change": 0.0043,
  "change_percent": 0.4103
}

Notes

last_size appears when a trade size is available in the consolidated snapshot; otherwise it is omitted from the payload. change_percent is null when prev_close is zero or not yet available.

GET/forex/agg/:symbol/prev

Open .md

Previous bar

Single most-recently completed UTC daily candle for the pair.

Path parameters

symbolstringRequired: Enabled forex pair (e.g. EURUSD). Six-character concatenated pair, trimmed and uppercased before lookup. Retrieve the full list from GET /forex/symbols.

Query parameters

intervalstring: Returns the most recently settled bar at that interval instead of the previous daily bar, and adds interval, bar_start, bar_end and as_of to the response. Leave it out for the daily bar.
Values1m5m15m1h4h1d

Request

curl -sS "https://api.tickerlayer.com/forex/agg/EURUSD/prev" \
  -H "x-api-key: <YOUR_API_KEY>"

Response 200 OK

{
  "symbol": "EURUSD",
  "result": {
    "o": 1.0500,
    "h": 1.0528,
    "l": 1.0488,
    "c": 1.0523,
    "v": 9820000000,
    "t": 1733011200000
  }
}

Notes

404 no bar available when the daily bar cannot be resolved yet. A bar requested with ?interval= is held for a short settle lag after it closes, so small clock differences between callers do not change which bar comes back, and it is the same bar the range endpoint returns for that window. Cache-Control and ETag mark when the value can next change. While the market is closed the last real bar is returned, still labelled with its own bar_start.

GET/forex/agg/:symbol/:multiplier/:timespan/:from/:to

Open .md

Aggregate bars (OHLCV)

Historical FX bars between two UTC calendar dates.

Path parameters

symbolstringRequired: An enabled symbol of this asset class, for example BTCUSD or US:KO. Trimmed before lookup.
multipliernumberRequired: Bar size in units of timespan: 1, 5 or 15 with minute; 1 or 4 with hour; 1 with day. Other pairs return 400, and the message lists the valid ones.
timespanstringRequired: Case-insensitive. Other values return 400.
Valuesminutehourday
fromstringRequired: First UTC date, inclusive, as YYYY-MM-DD.
tostringRequired: Last UTC date, inclusive, as YYYY-MM-DD. Not before from.

Query parameters

limitnumber: Page size, up to 5000. results_count is the size of this page and total_count the bars in the whole range; follow next_offset until it is null.
Default500
offsetnumber: Zero-based row offset, applied after sorting.
Default0
sortstring: Order of bars by timestamp t, applied before pagination.
ValuesascdescDefaultdesc

Request

curl -sS "https://api.tickerlayer.com/forex/agg/EURUSD/1/day/2025-11-01/2025-11-30?sort=desc&limit=2" \
  -H "x-api-key: <YOUR_API_KEY>"

Response 200 OK

{
  "symbol": "EURUSD",
  "results_count": 2,
  "results": [
    { "o": 1.0500, "h": 1.0528, "l": 1.0488, "c": 1.0523, "v": 9820000000, "t": 1733011200000 },
    { "o": 1.0475, "h": 1.0505, "l": 1.0460, "c": 1.0500, "v": 8750000000, "t": 1732924800000 }
  ],
  "next_offset": 2
}

Notes

One request covers at most 31 days of 1-minute bars, 90 of 5-minute, 180 of 15-minute, 365 of hourly, 730 of 4-hour and 5000 of daily bars, counting from and to as whole UTC days. A longer range returns 400 with the limit in the message.
v may occasionally be null when no consolidated volume is published for that interval.

WebSocket

Stream live quotes and trades for this asset class over the public WebSocket.

wss://stream.tickerlayer.com/?apiKey=<YOUR_API_KEY>

Available channels

Quotesforex.quotesTradesforex.trades

Subscribe example

After the connection is ready, send a JSON text frame:

{
  "action": "subscribe",
  "channels": [
    "forex.quotes",
    "forex.trades"
  ],
  "symbols": [
    "EURUSD",
    "GBPUSD"
  ]
}

Example message

{
  "type": "quote",
  "channel": "forex.quotes",
  "asset": "forex",
  "symbol": "EURUSD",
  "bid": "1.08512",
  "ask": "1.08518",
  "bid_size": "1000000",
  "ask_size": "1000000",
  "ts": 1743512400000
}

Timestamps

Every frame carries a millisecond ts that is strictly increasing per symbol within its channel, so two ticks never share a timestamp and clients can sort or de-duplicate on it safely.

General WebSocket documentation

For authentication, subscribe/unsubscribe lifecycle, errors, limits, and heartbeats, see the WebSocket overview, Subscriptions and Message types.

Raw line: SYMBOL.RAW

The default feed is consolidated across venues, which keeps it stable for pricing, oracles and risk. For charting, backtesting and anything that must look like a broker terminal, add .RAW to the pair: the same pairs as an unblended single-venue tick stream, every tick as the venue printed it, with real tick volume and no smoothing. Same key, channels and message shape.

{
  "action": "subscribe",
  "channels": ["forex.quotes", "forex.trades"],
  "symbols": ["EURUSD.RAW", "GBPUSD.RAW", "XAUUSD.RAW"]
}

One venue: Published as received: candles built from it match a raw-spread broker terminal, wicks included.
Sizes: forex.trades carries the venue tick volume in size; quote bid_size and ask_size are null.
REST and history: Also on /forex/quote, /forex/trade/last and /forex/snapshot. The aggregates endpoints accept .RAW too, with candles and tick volume from the same venue back to 2010.
Coverage: The majors, the main crosses and emerging-market pairs, plus spot gold, silver, platinum and palladium. Still expanding: tell us if a pair you chart is missing.