### API Playground Request Example

Source: https://www.fastforex.io/docs

Example of a GET request structure for fetching multiple currency rates.

```http
GET /fetch-multi?from=USD&to=EUR,GBP,CHF
```

```text
Configure the API request above & press "Go".
```

--------------------------------

### GET /usage

Source: https://www.fastforex.io/docs/api-reference/admin/usage

Fetch recent API usage data, including the current period start and end dates, total usage, and remaining quota.

```APIDOC
## GET /usage

### Description
Fetch recent API usage data. Includes current period start, end, usage and quota remaining.

### Method
GET

### Endpoint
/usage

### Response
#### Success Response (200)
- **monthly_quota** (number) - Total monthly quota allowed.
- **ms** (number) - Server response time in milliseconds.
- **usage** (object) - Daily usage breakdown.
- **current_period** (object) - Details regarding the current billing period.

#### Response Example
{
  "usage": {
    "2021-01-24": 247,
    "2021-01-25": 312,
    "2021-01-26": 23,
    "2021-01-27": 159,
    "2021-01-28": 0,
    "2021-01-29": 45,
    "2021-01-30": 92,
    "2021-01-31": 240,
    "2021-02-01": 1204,
    "2021-02-02": 34,
    "2021-02-03": 1245,
    "2021-02-04": 4,
    "2021-02-05": 0,
    "2021-02-06": 53,
    "2021-02-07": 3245
  },
  "monthly_quota": 500000,
  "current_period": {
    "start": "2021-02-03",
    "end": "2021-03-02",
    "remaining_quota": 495453,
    "usage": 4547
  },
  "ms": 3
}
```

--------------------------------

### GET /fx/currencies

Source: https://www.fastforex.io/docs/api-reference/fx/currencies

Retrieves a list of supported trading pair currency symbols and their descriptions.

```APIDOC
## GET /fx/currencies

### Description
List of supported trading pair currency symbols and descriptions.

### Method
GET

### Endpoint
/fx/currencies

### Parameters

### Request Example
```json
{
  "example": "request body"
}
```

### Response
#### Success Response (200)
- **ms** (object) - Response time information.
- **currencies** (object) - An object containing currency symbols as keys and their descriptions as values. Minimum of 150 entries.

#### Response Example
```json
{
  "ms": {
    "time_taken": 0.00123
  },
  "currencies": {
    "AED": "United Arab Emirates Dirham",
    "AFN": "Afghan Afghani",
    "ALL": "Albanian Lek",
    "AMD": "Armenian Dram",
    "ANG": "Dutch Guilders",
    "AOA": "Angolan Kwanza",
    "ARS": "Argentine Peso",
    "AUD": "Australian Dollar",
    "AWG": "Aruban Florin",
    "AZN": "Azerbaijani Manat",
    "BAM": "Bosnia-Herzegovina Convertible Mark",
    "BBD": "Barbadian Dollar",
    "BDT": "Bangladeshi Taka",
    "BGN": "Bulgarian Lev",
    "BHD": "Bahraini Dinar",
    "BIF": "Burundian Franc",
    "BMD": "Bermudian Dollar",
    "BND": "Bruneian Dollar",
    "BOB": "Bolivian Boliviano",
    "BRL": "Brazilian Real",
    "BRX": "Brazilian PTAX",
    "BSD": "Bahamian Dollar",
    "BTN": "Bhutanese Ngultrum",
    "BWP": "Botswanan Pula",
    "BYN": "Belarusian Ruble",
    "BZD": "Belizean Dollar",
    "CAD": "Canadian Dollar",
    "CDF": "Congolese Franc",
    "CHF": "Swiss Franc",
    "CLF": "Chilean Unit of Account UF",
    "CLP": "Chilean Peso",
    "CNH": "Chinese Yuan Offshore",
    "CNY": "Chinese Yuan",
    "COP": "Colombian Peso",
    "COU": "Unidad de Valor Real (Colombia)",
    "CRC": "Costa Rican Colon",
    "CUP": "Cuban Peso",
    "CVE": "Cape Verdean Escudo",
    "CZK": "Czech Republic Koruna",
    "DJF": "Djiboutian Franc",
    "DKK": "Danish Krone",
    "DOP": "Dominican Peso",
    "DZD": "Algerian Dinar",
    "EGP": "Egyptian Pound",
    "ERN": "Eritrean Nakfa",
    "ETB": "Ethiopian Birr",
    "EUR": "Euro",
    "FJD": "Fijian Dollar",
    "FKP": "Falkland Islands Pound",
    "GBP": "British Pound Sterling",
    "GEL": "Georgian Lari",
    "GHS": "Ghanaian Cedi",
    "GIP": "Gibraltar Pound",
    "GMD": "Gambian Dalasi",
    "GNF": "Guinean Franc",
    "GTQ": "Guatemalan Quetzal",
    "GYD": "Guyanaese Dollar",
    "HKD": "Hong Kong Dollar",
    "HNL": "Honduran Lempira",
    "HRK": "Croatian Kuna",
    "HTG": "Haitian Gourde",
    "HUF": "Hungarian Forint",
    "HUX": "Hungarian Forint Official Rate",
    "IDR": "Indonesian Rupiah",
    "ILS": "Israeli New Sheqel",
    "INR": "Indian Rupee",
    "IQD": "Iraqi Dinar",
    "IRR": "Iranian Rial",
    "ISK": "Icelandic Krona",
    "JMD": "Jamaican Dollar",
    "JOD": "Jordanian Dinar",
    "JPY": "Japanese Yen",
    "KES": "Kenyan Shilling",
    "KGS": "Kyrgystani Som",
    "KHR": "Cambodian Riel",
    "KMF": "Comorian Franc",
    "KPW": "North Korean Won",
    "KRW": "South Korean Won",
    "KWD": "Kuwaiti Dinar"
  }
}
```
```

--------------------------------

### GET /crypto/fetch-prices

Source: https://www.fastforex.io/docs/api-reference/crypto/fetch-prices

Fetch one or more (up to 10) real-time prices for supported cryptocurrency pairs.

```APIDOC
## GET /crypto/fetch-prices

### Description
Fetch one or more (up to 10) real-time prices for supported cryptocurrency pairs.

### Method
GET

### Endpoint
/crypto/fetch-prices

### Parameters
#### Query Parameters
- **pairs** (CryptoCurrencyPairList) - Required - Up to 10 target currency pairs, comma separated in XXX/YYY format

### Request Example
```json
{
  "pairs": "BTC/USD,ETH/BTC"
}
```

### Response
#### Success Response (200)
- **ms** (ResponseTime) - Server response time in milliseconds
- **prices** (object) - An object where keys are cryptocurrency pairs and values are their real-time prices (float).

#### Response Example
```json
{
  "prices": {
    "BTC/USD": 20624.21,
    "ETH/BTC": 0.075316
  },
  "ms": 8
}
```

#### Error Responses
- **400** - Bad Request
- **401** - Not Authorized
- **403** - Forbidden
- **429** - Rate limit exceeded
```

--------------------------------

### GET /fetch-multi

Source: https://www.fastforex.io/docs/api-reference/currency/fetch-multi

Fetch multiple target exchange rates from a single source currency using midpoint spot rates.

```APIDOC
## GET /fetch-multi

### Description
Fetch multiple target exchange rates from a single source currency. Midpoint spot rates.

### Method
GET

### Endpoint
/fetch-multi

### Parameters
#### Query Parameters
- **from** (string) - Optional - Base currency 3-letter symbol, defaults to USD
- **to** (string) - Required - Target currencies, comma separated list of 3-letter symbols

### Response
#### Success Response (200)
- **base** (string) - Base currency code
- **updated** (string) - Datetime of the update
- **ms** (number) - Server response time in milliseconds
- **results** (object) - Map of target currency symbols to their exchange rates

#### Response Example
{
  "base": "USD",
  "results": {
    "EUR": 0.82791,
    "GBP": 0.73605
  },
  "updated": "2021-01-16T16:34:29Z",
  "ms": 8
}
```

--------------------------------

### GET /time-series

Source: https://www.fastforex.io/docs/api-reference/currency/time-series

Fetches a time-series dataset of daily currency exchange rates for a specified interval. Currently, only daily intervals are supported.

```APIDOC
## GET /time-series

### Description
Fetch a time-series dataset of daily currency exchange rates for the specified interval (only daily supported currently). See our FX quote & OHLC time-series endpoints for more granular data.

### Method
GET

### Endpoint
/time-series

### Parameters
#### Query Parameters
- **from** (Currency) - Optional - Base currency 3-letter symbol, defaults to USD
- **to** (Currency) - Required - Target currency 3-letter symbol
- **start** (Date) - Required - UTC start date in YYYY-MM-DD format. As far back as Jan 1970, depending on the currency pair.
- **end** (Date) - Required - UTC end date in YYYY-MM-DD format. As far back as Jan 1970, depending on the currency pair.
- **interval** (Duration) - Optional - ISO8601 duration, such as P1D (daily). Defaults to P1D. Currently only supports daily.

### Request Example
```json
{
  "from": "USD",
  "to": "EUR",
  "start": "2021-01-24",
  "end": "2021-01-30",
  "interval": "P1D"
}
```

### Response
#### Success Response (200)
- **start** (Date) - The start date of the time series.
- **end** (Date) - The end date of the time series.
- **interval** (Duration) - The interval of the data points.
- **base** (Currency) - The base currency.
- **ms** (ResponseTime) - Server response time in milliseconds.
- **results** (object) - An object containing currency exchange rates for each day.
  - (additional properties) (number) - The exchange rate for a specific date.

#### Response Example
```json
{
  "start": "2021-01-24",
  "end": "2021-01-30",
  "interval": "P1D",
  "base": "USD",
  "ms": 15,
  "results": {
    "EUR": {
      "2021-01-24": 0.82,
      "2021-01-25": 0.82,
      "2021-01-26": 0.83,
      "2021-01-27": 0.83,
      "2021-01-28": 0.82,
      "2021-01-29": 0.82,
      "2021-01-30": 0.82
    }
  }
}
```

#### Error Responses
- **400** - Bad Request
- **401** - Not Authorized
- **403** - Forbidden
- **429** - Rate limit exceeded
```

--------------------------------

### GET /fx/quote

Source: https://www.fastforex.io/docs/api-reference/fx/quote

Retrieves live bid and ask quotes for specified FX trading pairs.

```APIDOC
## GET /fx/quote

### Description
Live bid & ask quote for 1 or more (up to 10 in a single request) FX trading pairs.

### Method
GET

### Endpoint
/fx/quote

### Parameters
#### Query Parameters
- **pairs** (string) - Required - Up to 10 target currency pairs, comma separated in XXXYYY or XXX/YYY format

### Response
#### Success Response (200)
- **prices** (object) - Object containing bid, ask, tsp, and size for each requested pair
- **ms** (number) - Server response time in milliseconds

#### Response Example
{
  "quotes": {
    "EURUSD": {
      "bid": 1.2145,
      "ask": 1.2146,
      "tsp": 1739305030072,
      "size": 1
    },
    "GBPUSD": {
      "bid": 1.4145,
      "ask": 1.4146,
      "tsp": 1739305029908,
      "size": 1
    }
  },
  "ms": 8
}
```

--------------------------------

### GET /currencies

Source: https://www.fastforex.io/docs/api-reference/currency/currencies

Retrieves a list of over 160 supported currencies along with their symbols.

```APIDOC
## GET /currencies

### Description
Fetch a list of 160+ supported currencies with symbols.

### Method
GET

### Endpoint
/currencies

### Response
#### Success Response (200)
- **currencies** (object) - A map of currency codes to their full names.

#### Response Example
{
  "currencies": {
    "AED": "United Arab Emirates Dirham",
    "AFN": "Afghan Afghani",
    "ALL": "Albanian Lek"
  }
}
```

--------------------------------

### GET /fetch-matrix

Source: https://www.fastforex.io/docs/api-reference/currency/fetch-matrix

Fetch a matrix of multiple from/to currency pairs. Midpoint spot rates. Costs one API call per pair returned.

```APIDOC
## GET /fetch-matrix

### Description
Fetch a matrix of multiple from/to currency pairs. Midpoint spot rates. Costs one API call per pair returned.

### Method
GET

### Endpoint
/fetch-matrix

### Parameters
#### Query Parameters
- **from** (string) - Required - Source currencies, comma separated list of 3-letter symbols
- **to** (string) - Required - Target currencies, comma separated list of 3-letter symbols

### Response
#### Success Response (200)
- **from** (array) - List of source currencies
- **to** (array) - List of target currencies
- **matrix** (object) - Object containing the exchange rates
- **updated** (string) - Timestamp of the update
- **calls** (number) - The number of API calls consumed by this request
- **ms** (number) - Server response time in milliseconds

#### Response Example
{
  "from": ["USD", "CHF", "ZAR", "AED"],
  "to": ["USD", "GBP", "JPY", "CNY"],
  "matrix": {
    "USD": {
      "GBP": 0.74196,
      "JPY": 147.488,
      "CNY": 7.119,
      "USD": 1
    },
    "CHF": {
      "USD": 1.2573,
      "GBP": 0.93291,
      "JPY": 185.444,
      "CNY": 8.9504
    },
    "ZAR": {
      "USD": 0.0581,
      "GBP": 0.04308,
      "JPY": 8.56229,
      "CNY": 0.41342
    },
    "AED": {
      "USD": 0.27223,
      "GBP": 0.20196,
      "JPY": 40.1552,
      "CNY": 1.938
    }
  },
  "updated": "2025-10-03T16:52:05Z",
  "calls": 16,
  "ms": 8
}
```

--------------------------------

### WebSocket Server Responses

Source: https://www.fastforex.io/docs/websockets

Examples of various JSON messages received from the server, including connection status, authentication results, subscription confirmations, and price updates.

```json
{
  "op": "connect",
  "status": 200,
  "tsp": 1745877646598,
  "msg": "Connected to server"
}
```

```json
{
  "op": "auth",
  "status": 200,
  "tsp": 1745877646598,
  "msg": "Authenticated OK"
}
```

```json
{
  "op": "subscribe",
  "status": 200,
  "tsp": 1745877671164,
  "msg": "Subscribed to 2 streams"
}
```

```json
{
  "op": "price",
  "sym": "EURUSD",
  "bid": "1.14218",
  "ask": "1.14218"
}
```

--------------------------------

### GET /fetch-one

Source: https://www.fastforex.io/docs/api-reference/currency/fetch-one

Fetch a single currency exchange rate between a base currency and a target currency.

```APIDOC
## GET /fetch-one

### Description
Fetch a single currency exchange rate, from and to any supported physical or digital currency. Returns the midpoint spot rate.

### Method
GET

### Endpoint
/fetch-one

### Parameters
#### Query Parameters
- **from** (string) - Optional - Base currency symbol (physical or digital), defaults to USD
- **to** (string) - Required - Target currency symbol (physical or digital)

### Response
#### Success Response (200)
- **base** (string) - The base currency code
- **updated** (string) - The timestamp of the rate update
- **ms** (number) - Server response time in milliseconds
- **result** (object) - The exchange rate result

#### Response Example
{
  "base": "USD",
  "result": {
    "EUR": 0.82791
  },
  "updated": "2021-01-16T16:34:29Z",
  "ms": 4
}
```

--------------------------------

### GET /crypto/pairs

Source: https://www.fastforex.io/docs/api-reference/crypto/pairs

Fetches a list of 400+ supported cryptocurrency pairs available on the platform.

```APIDOC
## GET /crypto/pairs

### Description
Fetch a list of 400+ supported cryptocurrency pairs.

### Method
GET

### Endpoint
/crypto/pairs

### Response
#### Success Response (200)
- **ms** (number) - Server response time in milliseconds
- **pairs** (object) - A collection of currency pairs where each key is the pair name and the value is an object containing the base and quote currency.

#### Response Example
{
  "pairs": {
    "1INCH/BTC": {
      "base": "1INCH",
      "quote": "BTC"
    },
    "BTC/USD": {
      "base": "BTC",
      "quote": "USD"
    },
    "ETH/BTC": {
      "base": "ETH",
      "quote": "BTC"
    }
  },
  "ms": 8
}
```

--------------------------------

### GET /fx/pairs/quote-sizes

Source: https://www.fastforex.io/docs/api-reference/fx/quote-sizes

Retrieves a list of FX trading pairs along with their non-standard quote sizes. This endpoint is available on the Extra and Premium plans.

```APIDOC
## GET /fx/pairs/quote-sizes

### Description
List of FX trading pairs with non-standard quote sizes.

### Method
GET

### Endpoint
/fx/pairs/quote-sizes

### Parameters

### Request Body
None

### Request Example
None

### Response
#### Success Response (200)
- **ms** (integer) - Server response time in milliseconds
- **sizes** (object) - An object where keys are FX pair symbols and values are their corresponding integer quote sizes.
  - Additional Properties (number, integer) - Description of individual quote sizes.

#### Response Example
```json
{
  "sizes": {
    "IRRUSD": 100000,
    "VNDUSD": 10000,
    "LKRNZD": 1000,
    "DOPGBP": 100
  },
  "ms": 12
}
```

#### Error Responses
- **400** - Bad Request
- **401** - Not Authorized
- **429** - Rate limit exceeded
```

--------------------------------

### GET /fx/quote/time-series

Source: https://www.fastforex.io/docs/api-reference/fx/quote-time-series

Retrieves bid/ask time-series data for a specific FX trading pair over a defined interval.

```APIDOC
## GET /fx/quote/time-series

### Description
Retrieves bid/ask time-series data for a given FX trading pair and interval. Values represent the closing bid/ask for the specified interval.

### Method
GET

### Endpoint
/fx/quote/time-series

### Parameters
#### Query Parameters
- **pair** (string) - Required - Trading pair, such as EURUSD
- **start** (string) - Optional - Time-series start. Supported formats: YYYY-MM-DD (UTC), YYYY-MM-DD HH:MM:SS (UTC), ISO8601, or timestamp in milliseconds.
- **end** (string) - Optional - Time-series end. Supported formats: YYYY-MM-DD (UTC), YYYY-MM-DD HH:MM:SS (UTC), ISO8601, or timestamp in milliseconds.
- **dtmfmt** (string) - Optional - Desired datetime response format: [ISO], [TSP], or [UTCYMD].
- **interval** (string) - Optional - ISO8601 duration (e.g., P1D, PT1H, PT1M). Defaults to P1D.
- **limit** (number) - Optional - Maximum number of data points to return (1-100).

### Response
#### Success Response (200)
- **pair** (string) - The requested trading pair
- **interval** (string) - The duration interval used
- **limit** (number) - Number of data points returned
- **dtmfmt** (string) - Datetime format used
- **start** (string) - Start time of the series
- **end** (string) - End time of the series
- **tzOffset** (string) - Timezone offset
- **size** (number) - Size of the quote data
- **results** (array) - List of objects containing dtm, bid, and ask values
- **ms** (number) - Response time in milliseconds
```

--------------------------------

### GET /fetch-many-to-one

Source: https://www.fastforex.io/docs/api-reference/currency/fetch-many-to-one

Fetch a set of many source currency rates to a single target currency. This endpoint returns midpoint spot rates and costs one API call per pair returned.

```APIDOC
## GET /fetch-many-to-one

### Description
Fetch a set of many source currency rates to a single target currency (inverse of /fetch-multi). Midpoint spot rates. Costs one API call per pair returned.

### Method
GET

### Endpoint
/fetch-many-to-one

### Parameters
#### Query Parameters
- **from** (string) - Required - Source currencies, comma separated list of 3-letter symbols
- **to** (string) - Required - Target currency 3-letter symbol, defaults to USD

### Response
#### Success Response (200)
- **to** (string) - Target currency code
- **updated** (string) - Datetime of the rates
- **calls** (number) - The number of API calls consumed by this request
- **ms** (number) - Server response time in milliseconds
- **from** (object) - Object containing source currency codes as keys and their rates as float values

#### Response Example
{
  "to": "USD",
  "from": {
    "JPY": 0.00679,
    "CHF": 1.2539,
    "ZAR": 0.0578,
    "AUD": 0.65962,
    "AED": 0.27229
  },
  "updated": "2025-10-03T16:34:29Z",
  "calls": 5,
  "ms": 12
}
```

--------------------------------

### GET /convert - Currency Conversion

Source: https://www.fastforex.io/docs/api-reference/currency/convert

Convert an amount of one currency into another currency. Supports both physical and digital currencies.

```APIDOC
## GET /convert

### Description
Convert an amount of one currency into another currency (supports physical and digital currencies)

### Method
GET

### Endpoint
/convert

### Parameters
#### Query Parameters
- **from** (AnyCurrency) - Optional - Base currency symbol (physical or digital)
- **to** (AnyCurrency) - Required - Target currency symbol (physical or digital)
- **amount** (number) - Required - Amount of source currency to convert. Minimum value: 0.01
- **precision** (integer) - Optional - Rounding precision for converted amount, defaults to 2 decimal places. Minimum value: 0, Maximum value: 20

### Request Example
```json
{
  "example": "request body"
}
```

### Response
#### Success Response (200)
- **base** (AnyCurrency) - The base currency used for conversion.
- **ms** (ResponseTime) - Server response time in milliseconds.
- **amount** (number) - The original amount that was converted.
- **result** (object) - An object containing the converted amounts for target currencies. It will have exactly two properties: 'rate' (the exchange rate) and one additional property for the target currency symbol with its converted value.

#### Response Example
```json
{
  "base": "USD",
  "amount": 199.5,
  "result": {
    "EUR": 164.29,
    "rate": 0.82353
  },
  "ms": 7
}
```

#### Error Responses
- **400** - Bad Request
- **401** - Not Authorized
- **403** - Forbidden
- **429** - Rate limit exceeded
```

--------------------------------

### GET /fx/pairs/historical-limits

Source: https://www.fastforex.io/docs/api-reference/fx/historical-limits

Retrieves the earliest available historical data point for FX pairs based on the specified interval and price type.

```APIDOC
## GET /fx/pairs/historical-limits

### Description
FX pairs earliest available historical data point for the supplied interval (P1D default).

### Method
GET

### Endpoint
/fx/pairs/historical-limits

### Parameters
#### Query Parameters
- **interval** (string) - Optional - ISO8601 duration, such as P1D (daily). Defaults to P1D. Options are P1D, PT1H, PT1M.
- **price** (string) - Optional - bid or ask. Defaults to bid.

### Response
#### Success Response (200)
- **ms** (number) - Server response time in milliseconds
- **interval** (string) - The requested interval
- **price** (string) - The requested price type
- **pairs** (object) - A collection of FX pairs and their earliest available datetime

#### Response Example
{
  "interval": "P1D",
  "price": "bid",
  "pairs": {
    "EURUSD": "1976-01-02T00:00:00.000Z",
    "GBPUSD": "1970-01-02T00:00:00.000Z",
    "USDJPY": "1975-01-02T00:00:00.000Z"
  },
  "ms": 12
}
```

--------------------------------

### GET /fx/ohlc/time-series

Source: https://www.fastforex.io/docs/api-reference/fx/ohlc-time-series

Fetches OHLC (Open, High, Low, Close) time-series data for a specified FX trading pair and interval. Values are based on the BID price.

```APIDOC
## GET /fx/ohlc/time-series

### Description
Fetch a set of OHLC time-series data points for a given FX trading pair and interval. Values are based on the BID price. Supports a range of datetime formats and timezone offsets. Datetime format in the response will try to match your request - unless specified explicitly.

### Method
GET

### Endpoint
/fx/ohlc/time-series

### Parameters
#### Query Parameters
- **pair** (TradingPair) - Required - Trading pair, such as EURUSD
- **start** (DateOrDateTime) - Optional - Time-series start. Supported formats: YYYY-MM-DD (UTC). YYYY-MM-DD HH:MM:SS (UTC), ISO8601 with timezone offset. Timestamp in milliseconds. Supply this or end.
- **end** (DateOrDateTime) - Optional - Time-series end. Supported formats: YYYY-MM-DD (UTC). YYYY-MM-DD HH:MM:SS (UTC), ISO8601 with timezone offset. Timestamp in milliseconds. Supply this or start.
- **dtmfmt** (DateTimeFormat) - Optional - Desired datetime response format. Defaults to match your request. Can be [ISO] ISO8601 datetime including timezone offset, [TSP] UNIX Timestamp in milliseconds, or [UTCYMD] 'YYYY-MM-DD HH:MM:SS' (UTC).
- **interval** (Duration) - Optional - ISO8601 duration, such as P1D (daily). Defaults to P1D. Options are P1D, PT1H, PT1M.
- **limit** (number) - Optional - Maximum number of data points to return. Default varies upon duration. Minimum: 1, Maximum: 100

### Response
#### Success Response (200)
- **pair** (TradingPair) - Description
- **interval** (Duration) - Description
- **limit** (number) - Description
- **dtmfmt** (DateTimeFormat) - Description
- **start** (DateTimes) - Description
- **end** (DateTimes) - Description
- **tzOffset** (string) - Timezone offset. e.g. +00:00 or -05:00
- **size** (QuoteSize) - Description
- **results** (array) - Description
  - **dtm** (DateTimes) - Description
  - **o** (number) - Open price
  - **h** (number) - High price
  - **l** (number) - Low price

#### Response Example
{
  "example": "{\"pair\": \"EURUSD\", \"interval\": \"P1D\", \"limit\": 100, \"dtmfmt\": \"ISO\", \"start\": \"2023-01-01T00:00:00Z\", \"end\": \"2023-10-26T00:00:00Z\", \"tzOffset\": \"+00:00\", \"size\": 100, \"results\": [{\"dtm\": \"2023-01-01T00:00:00Z\", \"o\": 1.067, \"h\": 1.071, \"l\": 1.065}]}"
```

--------------------------------

### POST /docs/_mintlify/feedback/fastforexio/agent-feedback

Source: https://www.fastforex.io/docs/websockets

Submit feedback regarding incorrect, outdated, or confusing documentation.

```APIDOC
## POST /docs/_mintlify/feedback/fastforexio/agent-feedback

### Description
Submit feedback for specific documentation pages that are incorrect, outdated, or confusing.

### Method
POST

### Endpoint
https://www.fastforex.io/docs/_mintlify/feedback/fastforexio/agent-feedback

### Request Body
- **path** (string) - Required - The current page path.
- **feedback** (string) - Required - Description of the issue.

### Request Example
{
  "path": "/current-page-path",
  "feedback": "Description of the issue"
}
```

--------------------------------

### Perform API Request with cURL

Source: https://www.fastforex.io/docs

Use this command to authenticate and fetch all currency data from the API.

```bash
curl -H "X-API-Key: YOUR_API_KEY" https://api.fastforex.io/fetch-all
```

--------------------------------

### GET /historical-data

Source: https://www.fastforex.io/docs/api-reference/fx/quote-time-series

Retrieves historical price data for a specific currency pair over a defined interval.

```APIDOC
## GET /historical-data

### Description
Retrieves historical bid and ask prices for a specified currency pair, allowing for time-series analysis.

### Method
GET

### Endpoint
/historical-data

### Parameters
#### Query Parameters
- **pair** (string) - Required - The trading pair (e.g., GBPUSD)
- **interval** (string) - Required - ISO8601 Duration for the data interval (e.g., PT1M)
- **limit** (integer) - Optional - Number of records to return
- **dtmfmt** (string) - Optional - Date format (ISO, TSP, or UTCYMD)
- **end** (string) - Optional - End date/time for the data range
- **size** (integer) - Optional - Size of the quote in units of the base currency

### Response
#### Success Response (200)
- **pair** (string) - The requested trading pair
- **interval** (string) - The data interval used
- **results** (array) - List of historical price objects
- **ms** (integer) - Server response time in milliseconds

#### Response Example
{
  "pair": "GBPUSD",
  "interval": "PT1M",
  "results": [
    {
      "dtm": "2025-02-13T16:29:00Z",
      "bid": 1.25377,
      "ask": 1.25379
    }
  ],
  "ms": 16
}
```

--------------------------------

### Fetch All Currency Rates

Source: https://www.fastforex.io/docs/api-reference/currency/fetch-all

Retrieve all available currency exchange rates against a specified base currency. This endpoint provides midpoint spot rates.

```APIDOC
## GET /fetch-all

### Description
Fetch all available currency rates for the supplied source currency. Midpoint spot rates.

### Method
GET

### Endpoint
/fetch-all

### Parameters
#### Query Parameters
- **from** (Currency) - Optional - Base currency 3-letter symbol, defaults to USD

### Response
#### Success Response (200)
- **base** (Currency) - The base currency used for the rates.
- **updated** (DateTimes) - The timestamp when the rates were last updated.
- **ms** (ResponseTime) - The time taken to process the request in milliseconds.
- **results** (object) - An object containing currency symbols as keys and their corresponding exchange rates (float) as values.

#### Response Example
```json
{
  "base": "USD",
  "results": {
    "AED": 3.673,
    "AFN": 72.5642,
    "ALL": 88.59,
    "AMD": 391.07,
    "ANG": 1.788,
    "AOA": 912,
    "ARS": 1074.69,
    "AUD": 1.5892,
    "AWG": 1.81,
    "AZN": 1.7,
    "BAM": 1.7217,
    "BBD": 2,
    "BDT": 121.81,
    "BGN": 1.7219,
    "BHD": 0.37708,
    "BIF": 2923.15,
    "BMD": 1,
    "BND": 1.3194,
    "BOB": 6.94,
    "BRL": 5.8742,
    "BRX": 5.8734,
    "BSD": 1.003,
    "BWP": 14.0056,
    "BYN": 3.28,
    "BZD": 2.0178,
    "CAD": 1.38642,
    "CDF": 2859.46,
    "CHF": 0.81519,
    "CLF": 0.02495,
    "CLP": 971.76,
    "CNH": 7.28156,
    "CNY": 7.2916,
    "COP": 4277.27,
    "COU": 10.6753,
    "CRC": 508.43,
    "CUP": 24,
    "CVE": 96.88,
    "CZK": 22.1127,
    "DJF": 177.405,
    "DKK": 6.57264,
    "DOP": 61.33,
    "DZD": 131.969,
    "EGP": 51.3229,
    "ERN": 15.15,
    "ETB": 130.47,
    "EUR": 0.8799,
    "FJD": 2.283,
    "FKP": 0.7659,
    "GBP": 0.76423,
    "GEL": 2.7573,
    "GHS": 15.4527,
    "GIP": 0.7659,
    "GMD": 72,
    "GNF": 8664,
    "GTQ": 7.709,
    "GYD": 210.19,
    "HKD": 7.7537,
    "HNL": 25.7132,
    "HTG": 132.88,
    "HUF": 360.62,
    "HUX": 370.54,
    "IDR": 16794,
    "ILS": 3.704,
    "INR": 86.118,
    "IQD": 1310,
    "IRR": 42003,
    "ISK": 127.9,
    "JMD": 157.71,
    "JOD": 0.709,
    "JPY": 143.525,
    "KES": 129.78,
    "KGS": 87.45,
    "KHR": 4000,
    "KMF": 454.5,
    "KPW": 900,
    "KRW": 1421.365,
    "KWD": 0.307,
    "KYD": 0.82,
    "KZT": 518.06,
    "LAK": 21557,
    "LBP": 89600,
    "LKR": 298.1,
    "LRD": 199.926,
    "LSL": 19.37,
    "LYD": 5.5571,
    "MAD": 9.3176,
    "MDL": 17.7,
    "MGA": 4655
  },
  "updated": "2023-10-27T10:00:00Z",
  "ms": 150
}

```

--------------------------------

### List FX Pairs

Source: https://www.fastforex.io/docs/api-reference/fx/pairs

Retrieve a comprehensive list of supported FX pairs. This endpoint is available on the Extra and Premium plans.

```APIDOC
## GET /fx/pairs

### Description
List approx 2,300 supported FX pairs.

### Method
GET

### Endpoint
/fx/pairs

### Query Parameters
None

### Request Body
None

### Request Example
None

### Response
#### Success Response (200)
- **ms** (integer) - Server response time in milliseconds
- **pairs** (object) - An object containing FX trading pairs. Each pair includes base, quote, and alt identifiers.

#### Response Example
```json
{
  "pairs": {
    "EUR/USD": {
      "base": "EUR",
      "quote": "USD",
      "alt": "EURUSD"
    },
    "GBP/USD": {
      "base": "GBP",
      "quote": "USD",
      "alt": "GBPUSD"
    },
    "USD/GBP": {
      "base": "USD",
      "quote": "GBP",
      "alt": "USDGBP"
    }
  },
  "ms": 8
}
```

#### Error Responses
- **400**: Bad Request
- **401**: Not Authorized
- **429**: Rate limit exceeded
```

--------------------------------

### Currency List

Source: https://www.fastforex.io/docs/api-reference/fx/currencies

Retrieves a list of all supported currency codes and their corresponding names.

```APIDOC
## GET /currencies

### Description
Retrieves a list of all supported currency codes and their corresponding names.

### Method
GET

### Endpoint
/currencies

### Parameters
None

### Request Example
None

### Response
#### Success Response (200)
- **currency_code** (string) - The three-letter currency code.
- **currency_name** (string) - The full name of the currency.

#### Response Example
```json
{
  "KYD": "Caymanian Dollar",
  "KZT": "Kazakhstani Tenge",
  "LAK": "Laotian Kip",
  "LBP": "Lebanese Pound",
  "LKR": "Sri Lankan Rupee",
  "LRD": "Liberian Dollar",
  "LSL": "Lesotho Maloti",
  "LYD": "Libyan Dinar",
  "MAD": "Moroccan Dirham",
  "MDL": "Moldovan Leu",
  "MGA": "Malagasy Ariary",
  "MKD": "Macedonian Denar",
  "MMK": "Myanma Kyat",
  "MNT": "Mongolian Tugrik",
  "MOP": "Macanese Pataca",
  "MRU": "Mauritanian Ouguiya",
  "MUR": "Mauritian Rupee",
  "MVR": "Maldivian Rufiyaa",
  "MWK": "Malawian Kwacha",
  "MXN": "Mexican Peso",
  "MXV": "Mexican Unidad de Inversion",
  "MYR": "Malaysian Ringgit",
  "MZN": "Mozambican Metical",
  "NAD": "Namibian Dollar",
  "NGN": "Nigerian Naira",
  "NIO": "Nicaraguan Cordoba",
  "NOK": "Norwegian Krone",
  "NPR": "Nepalese Rupee",
  "NZD": "New Zealand Dollar",
  "OMR": "Omani Rial",
  "PAB": "Panamanian Balboa",
  "PEN": "Peruvian Nuevo Sol",
  "PGK": "Papua New Guinean Kina",
  "PHP": "Philippine Peso",
  "PKR": "Pakistani Rupee",
  "PLN": "Polish Zloty",
  "PYG": "Paraguayan Guarani",
  "QAR": "Qatari Rial",
  "RON": "Romanian Leu",
  "RSD": "Serbian Dinar",
  "RUB": "Russian Ruble",
  "RWF": "Rwandan Franc",
  "SAR": "Saudi Arabian Riyal",
  "SBD": "Solomon Islands Dollar",
  "SCR": "Seychellois Rupee",
  "SDG": "Sudanese Pound",
  "SEK": "Swedish Krona",
  "SGD": "Singapore Dollar",
  "SHP": "Saint Helena Pound",
  "SLL": "Sierra Leonean Leone",
  "SOS": "Somali Shilling",
  "SRD": "Surinamese Dollar",
  "SSP": "South Sudanese Pound",
  "STN": "Sao Tomean Dobra",
  "SVC": "Salvadoran Colon",
  "SYP": "Syrian Pound",
  "SZL": "Swazi Emalangeni",
  "THB": "Thai Baht",
  "TJS": "Tajikistani Somoni",
  "TMT": "Turkmenistani Manat",
  "TND": "Tunisian Dinar",
  "TOP": "Tongan Pa'anga",
  "TRY": "Turkish Lira",
  "TTD": "Trinidad and Tobago Dollar",
  "TWD": "Taiwan New Dollar",
  "TZS": "Tanzanian Shilling",
  "UAH": "Ukrainian Hryvnia",
  "UGX": "Ugandan Shilling",
  "USD": "United States Dollar",
  "UYU": "Uruguayan Peso",
  "UZS": "Uzbekistan Som",
  "VES": "Venezuelan Bolivar",
  "VND": "Vietnamese Dong",
  "VUV": "Ni-Vanuatu Vatu",
  "WST": "Samoan Tala",
  "XAF": "CFA Franc BEAC",
  "XCD": "East Caribbean Dollar",
  "XDR": "Special Drawing Rights",
  "XOF": "CFA Franc BCEAO",
  "XPF": "CFP Franc",
  "YER": "Yemeni Rial",
  "ZAR": "South African Rand",
  "ZMW": "Zambian Kwacha"
}
```
```