---
title: Exchange Rate API - Real-Time Forex & Crypto Rates for 1,000+ Assets
version: 1.0.0
description: Get the latest exchange rates for any base currency. Returns rates for all available currencies or a filtered set of symbols. Supports fiat, crypto, and metals. Accepts an optional updates parameter for rate freshness (1m, 10m, 1h, 1d). Returns a 400 error for invalid parameters and a 404 error for unsupported currencies or symbols.
openapi: 3.1.1
servers:
  - https://api.apifreaks.com/v1.0
paths: 1
operations: 1
schemas: 2
---

## Table of Contents

- [Exchange Rate API - Real-Time Forex & Crypto Rates for 1,000+ Assets v1.0.0](#exchange-rate-api-real-time-forex-crypto-rates-for-1000-assets-v100)
  - [Authentication](#authentication)
  - [Currency APIs](#currency-apis)
    - [getLatestExchangeRates](#getlatestexchangerates)
      - [Parameters](#parameters)
      - [Responses](#responses)
  - [Schemas](#schemas)
    - [LatestExchangeRatesResponse](#latestexchangeratesresponse)
    - [ErrorResponse](#errorresponse)



# Exchange Rate API - Real-Time Forex & Crypto Rates for 1,000+ Assets v1.0.0

Get the latest exchange rates for any base currency. Returns rates for all available currencies or a filtered set of symbols. Supports fiat, crypto, and metals. Accepts an optional updates parameter for rate freshness (1m, 10m, 1h, 1d). Returns a 400 error for invalid parameters and a 404 error for unsupported currencies or symbols.

Base URLs:

* [https://api.apifreaks.com/v1.0](https://api.apifreaks.com/v1.0)

## Authentication

* API Key (ApiKeyAuthHeader)
    - Parameter Name: **X-apiKey**, in: header. Pass your API key via the X-apiKey request header.

* API Key (ApiKeyAuthQuery)
    - Parameter Name: **apiKey**, in: query. Pass your API key via the apiKey query parameter.

## Currency APIs

### getLatestExchangeRates

`GET /currency/rates/latest`

*Get the latest exchange rates*

Returns the latest exchange rates for the requested base currency and symbols.

#### Parameters

|Name|In|Type|Required|Description|
|---|---|---|---|---|
|format|query|string|false|Response format: `json` (default) or `xml`.|
|base|query|string|false|Base currency code. Defaults to `USD`. Supports fiat, crypto, and metals.|
|symbols|query|string|false|Comma-separated currency codes. Omit to get all available rates.|
|updates|query|string|false|Update frequency: `1m` (default), `10m`, `1h`, or `1d`.|

##### Enumerated Values

|Parameter|Value|
|---|---|
|format|json|
|format|xml|
|updates|1m|
|updates|10m|
|updates|1h|
|updates|1d|

> Example responses

> Successful operation

```json
{
  "date": "2026-07-27 12:01:00+00",
  "base": "USD",
  "rates": {
    "EUR": "0.878156",
    "PKR": "277.863"
  }
}
```

> Bad request - Invalid parameters

```json
{
  "timestamp": 1785153665906,
  "status": 400,
  "error": "Invalid Param Exception",
  "message": "Please provide valid updates parameter (1d,1h,10m,1m)",
  "path": "/v2.0/rates/latest"
}
```

> Not found - Currency or symbol not available

```json
{
  "timestamp": 1785153666449,
  "status": 404,
  "error": "Not Found Exception",
  "message": "Rates of provided currency ZZZ are not available in our database!",
  "path": "/v2.0/rates/latest"
}
```

```json
{
  "timestamp": 1785153666998,
  "status": 404,
  "error": "Not Found Exception",
  "message": "Rates of provided Symbols are not available in our database!",
  "path": "/v2.0/rates/latest"
}
```

#### Responses

|Status|Meaning|Description|Schema|
|---|---|---|---|
|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|Successful operation|[LatestExchangeRatesResponse](#latestexchangeratesresponse)|
|400|[Bad Request](https://tools.ietf.org/html/rfc7231#section-6.5.1)|Bad request - Invalid parameters|[ErrorResponse](#errorresponse)|
|404|[Not Found](https://tools.ietf.org/html/rfc7231#section-6.5.4)|Not found - Currency or symbol not available|[ErrorResponse](#errorresponse)|

#### Response Headers

|Status|Header|Type|Format|Description|
|---|---|---|---|---|
|200|X-AF-Credits-Cost|integer||Specifies the number of credits consumed by the current request.|
|400|X-AF-Credits-Cost|integer||Specifies the number of credits consumed by the current request.|
|404|X-AF-Credits-Cost|integer||Specifies the number of credits consumed by the current request.|

To perform this operation, you must be authenticated by means of one of the following methods:
ApiKeyAuthHeader, ApiKeyAuthQuery

## Schemas

### LatestExchangeRatesResponse

Exchange rate response containing date, base currency, and rates map.

#### Properties

|Name|Type|Required|Restrictions|Description|
|---|---|---|---|---|
|date|string|true|none|Date and time with timezone (UTC) when the rates were recorded.|
|base|string|true|none|Base currency used for calculating exchange rates.|
|rates|object|true|none|Map of currency codes to their exchange rate against the base currency. Each key is a currency code and the value is an exchange rate string.|
|» ExchangeRateString|string|false|none|Exchange rate value as a string for this currency code.|

### ErrorResponse

Standard error envelope returned by the API on failed requests.

#### Properties

|Name|Type|Required|Restrictions|Description|
|---|---|---|---|---|
|timestamp|integer(int64)|true|none|Unix timestamp in milliseconds when the error occurred.|
|status|integer|true|none|HTTP status code returned with the error.|
|error|string|true|none|Specific error type (e.g., `Invalid Param Exception`, `Not Found Exception`).|
|message|string|true|none|Human-readable error message describing the failure.|
|path|string|true|none|API endpoint path that produced the error.|