---
canonical_url: "https://docs.composio.dev/toolkits/open_exchange_rates"
markdown_url: "https://docs.composio.dev/toolkits/open_exchange_rates.md"
product: "platform"
version: null
last_updated: null
---

# Open Exchange Rates

Open Exchange Rates provides current and historical foreign exchange rates, currency conversion, usage data, time series, and OHLC market data.

- **Category:** analytics
- **Auth:** API_KEY
- **Composio-managed OAuth available?** N/A
- **Tools:** 7
- **Triggers:** 0
- **Slug:** `OPEN_EXCHANGE_RATES`
- **Version:** 00000000_00

## Tools

### Convert Currency

**Slug:** `OPEN_EXCHANGE_RATES_CONVERT_CURRENCY`

Convert a monetary amount between two currencies at the latest available rate. This endpoint requires an Open Exchange Rates Unlimited plan; successful paid-tier behavior has not been live-verified.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `amount` | number | Yes | Monetary amount to convert, including decimal values. |
| `to_currency` | string | Yes | Destination currency symbol, for example EUR. |
| `from_currency` | string | Yes | Source currency symbol, for example USD. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Historical Rates

**Slug:** `OPEN_EXCHANGE_RATES_GET_HISTORICAL_RATES`

Get end-of-day midpoint exchange rates for one UTC date on or after 1999-01-01. Non-USD bases require a paid plan.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `date` | string | Yes | UTC date on or after 1999-01-01. Today's date returns the latest available rates. |
| `symbols` | string | No | Comma-separated currency symbols to return, for example EUR,GBP; omit to return all available rates. |
| `base_currency` | string | No | Three-letter base currency. Defaults to USD; non-USD bases require a Developer, Enterprise, or Unlimited plan. |
| `show_alternative` | boolean | No | Include alternative currency rates. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Latest Rates

**Slug:** `OPEN_EXCHANGE_RATES_GET_LATEST_RATES`

Get the latest midpoint exchange rates for a base currency, optionally limited to selected currency symbols. Non-USD bases require a paid plan.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `symbols` | string | No | Comma-separated currency symbols to return, for example EUR,GBP; omit to return all available rates. |
| `base_currency` | string | No | Three-letter base currency. Defaults to USD; non-USD bases require a paid Open Exchange Rates plan. |
| `show_alternative` | boolean | No | Include alternative currency rates. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get OHLC Rates

**Slug:** `OPEN_EXCHANGE_RATES_GET_OHLC_RATES`

Get open, high, low, close, and average exchange rates for one aggregation period. Requires VIP Platinum or equivalent select-client access with contact-based pricing. Successful paid behavior remains unverified.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `period` | string ("1m" | "5m" | "15m" | "30m" | "1h" | "12h" | "1d" | "1w" | "1mo") | Yes | Aggregation period for the OHLC window. |
| `symbols` | string | No | Comma-separated currency symbols to return, for example EUR,GBP; recommended to limit response size. |
| `start_time` | string | Yes | UTC ISO-8601 aggregation start with seconds set to 00. Allowed age and alignment depend on period. |
| `base_currency` | string | No | Three-letter base currency; defaults to USD. |
| `show_alternative` | boolean | No | Include alternative, digital, and black-market currency prices. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Time Series

**Slug:** `OPEN_EXCHANGE_RATES_GET_TIME_SERIES`

Get daily exchange rates for an inclusive UTC date range of at most one month. Requires an Enterprise or Unlimited plan, and each returned day consumes one quota request. Successful responses are documented but have not been verified against an entitled account.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `symbols` | string | No | Comma-separated currency symbols to return, for example EUR,GBP; strongly recommended to limit response size. |
| `end_date` | string | Yes | Final UTC date in the inclusive range. Must be on or after start_date and no more than one calendar month later. |
| `start_date` | string | Yes | First UTC date in the inclusive range. |
| `base_currency` | string | No | Three-letter base currency. Defaults to USD; a non-USD value also requires the account's base-currency entitlement. |
| `show_alternative` | boolean | No | Include alternative currency rates. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Usage

**Slug:** `OPEN_EXCHANGE_RATES_GET_USAGE`

Get the connected App ID's plan features, exchange-rate data refresh frequency, and current-month request usage.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Currencies

**Slug:** `OPEN_EXCHANGE_RATES_LIST_CURRENCIES`

List available currency symbols and display names, optionally including alternative or inactive currencies.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `show_inactive` | boolean | No | Include inactive currencies in the symbol map. |
| `show_alternative` | boolean | No | Include unofficial, black-market, and alternative digital currency symbols. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |
