---
title: "GET /fx/quote/time-series"
method: GET
path: "/fx/quote/time-series"
tags: ["fx", "plan-premium"]
---

# GET /fx/quote/time-series

`GET /fx/quote/time-series`

bid/ask time-series data for a given FX trading pair and interval. Values are the closing bid/ask for the interval. Supports a range of datetime formats and timezone offsets. Datetime format in the response will try to match your request - unless specified explicitly.

## Query parameters

- `pair` string, required — A single FX trading pair, with or without a slash
- `start` union — A datetime value. If no timezone offset supplied, UTC/GMT is assumed. If only a date is supplied, time is assumed to be 00:00:00 UTC.
  - string — UTC/GMT date YYYY-MM-DD
  - string — UTC/GMT datetime YYYY-MM-DD HH:MM:SS
  - string — ISO8601 Datetime with optional timezone offset YYYY-MM-DDTHH:MM:SS±HH:00
  - number — Milliseconds since Jan 1 1970 (unix timestamp with millisecond precision)
- `end` union — A datetime value. If no timezone offset supplied, UTC/GMT is assumed. If only a date is supplied, time is assumed to be 00:00:00 UTC.
  - string — UTC/GMT date YYYY-MM-DD
  - string — UTC/GMT datetime YYYY-MM-DD HH:MM:SS
  - string — ISO8601 Datetime with optional timezone offset YYYY-MM-DDTHH:MM:SS±HH:00
  - number — Milliseconds since Jan 1 1970 (unix timestamp with millisecond precision)
- `dtmfmt` 'ISO' | 'TSP' | 'UTCYMD' — Can be [ISO] ISO8601 datetime including timezone offset, [TSP] UNIX Timestamp in milliseconds, or [UTCYMD] 'YYYY-MM-DD HH:MM:SS' (UTC).
- `interval` string — ISO8601 Duration. https://en.wikipedia.org/wiki/ISO_8601#Durations
- `limit` number

## Response `200`

Success

- object
  - `pair` string — A single FX trading pair, with or without a slash
  - `interval` string — ISO8601 Duration. https://en.wikipedia.org/wiki/ISO_8601#Durations
  - `limit` number
  - `dtmfmt` 'ISO' | 'TSP' | 'UTCYMD' — Can be [ISO] ISO8601 datetime including timezone offset, [TSP] UNIX Timestamp in milliseconds, or [UTCYMD] 'YYYY-MM-DD HH:MM:SS' (UTC).
  - `start` union — A datetime value. If no timezone offset supplied, UTC/GMT is assumed.
    - string — UTC/GMT datetime YYYY-MM-DD HH:MM:SS
    - string — ISO8601 Datetime with optional timezone offset YYYY-MM-DDTHH:MM:SS±HH:00
    - number — Milliseconds since Jan 1 1970 (unix timestamp with millisecond precision)
  - `end` union — A datetime value. If no timezone offset supplied, UTC/GMT is assumed.
    - string — UTC/GMT datetime YYYY-MM-DD HH:MM:SS
    - string — ISO8601 Datetime with optional timezone offset YYYY-MM-DDTHH:MM:SS±HH:00
    - number — Milliseconds since Jan 1 1970 (unix timestamp with millisecond precision)
  - `tzOffset` string — Timezone offset. e.g. +00:00 or -05:00
  - `size` number — Size of the quote is units of the base currency/symbol. Usually 1.
  - `results` object[]
    - `dtm` union — A datetime value. If no timezone offset supplied, UTC/GMT is assumed.
      - string — UTC/GMT datetime YYYY-MM-DD HH:MM:SS
      - string — ISO8601 Datetime with optional timezone offset YYYY-MM-DDTHH:MM:SS±HH:00
      - number — Milliseconds since Jan 1 1970 (unix timestamp with millisecond precision)
    - `bid` number, float
    - `ask` number, float
  - `ms` number — Server response time in milliseconds

## Other responses

- `400` — Bad Request
- `401` — Not Authorized
- `403` — Forbidden
- `429` — Rate limit exceeded

---

[API](https://skmtc.dev/fastforex/apis/fastforex-io.md) · [All operations](https://skmtc.dev/fastforex/apis/fastforex-io/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/fastforex/fastforex-io/revisions/140f748aaf10/schema)