# Fixer.io

Fixer.io is a simple and lightweight API for current and historical foreign exchange rates and currency conversion.

- **Category:** developer tools
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 5
- **Triggers:** 0
- **Slug:** `FIXER_IO`
- **Version:** 20260403_00

## Tools

### Convert Currency

**Slug:** `FIXER_IO_CONVERT_CURRENCY`

Tool to convert an amount from one currency to another. Use when you need current or historical exchange rates. Specify `date` for historical rates.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `date` | string | No | Optional historical date in YYYY-MM-DD format |
| `amount` | number | Yes | Amount to convert; must be non-negative |
| `to_currency` | string | Yes | Three-letter currency code to convert to |
| `from_currency` | string | Yes | Three-letter currency code to convert from |

#### 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 Currency Fluctuations

**Slug:** `FIXER_IO_GET_FLUCTUATION`

Tool to fetch exchange rate fluctuations between two dates. Use when you need day-to-day currency rate changes.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `base` | string | No | Optional 3-letter base currency code (default: EUR). |
| `symbols` | string | No | Optional comma-separated list of 3-letter currency codes to limit output. |
| `end_date` | string | Yes | End date in YYYY-MM-DD format (inclusive). |
| `start_date` | string | Yes | Start date in YYYY-MM-DD format (inclusive). |

#### 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:** `FIXER_IO_GET_HISTORICAL_RATES`

Fetch historical exchange rates for a specific date. Returns end-of-day (EOD) exchange rates for any date back to January 1, 1999. Use this when you need past currency conversion rates or historical financial data.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `base` | string | No | 3-letter ISO currency code to use as base currency (default is EUR). Note: Changing base currency requires a paid subscription plan. |
| `date` | string | Yes | Historical date to query in YYYY-MM-DD format |
| `symbols` | string | No | Comma-separated list of currency codes to limit output |

#### 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 Supported Symbols

**Slug:** `FIXER_IO_GET_SUPPORTED_SYMBOLS`

Tool to retrieve the list of all available currency symbols and their corresponding names. Use when you need to fetch and display supported currency codes.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `callback` | string | No | Optional JSONP callback function name; wraps response in a JS function call |

#### 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:** `FIXER_IO_GET_TIME_SERIES`

Retrieves daily foreign exchange rates for a date range. Returns a time series of exchange rates for each day between start_date and end_date (inclusive, max 365 days). The rates show how much of each currency equals one unit of the base currency.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `base` | string | No | Three-letter base currency code (default: EUR). Note: Free plan only supports EUR as base. |
| `symbols` | string | No | Comma-separated list of currency codes to limit output (e.g. 'USD,GBP,JPY'). |
| `end_date` | string | Yes | End date of the requested period (YYYY-MM-DD). |
| `start_date` | string | Yes | Start date of the requested period (YYYY-MM-DD). |

#### 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 |