# CurrencyFreaks — Full Reference

> CurrencyFreaks (currencyfreaks.com) is a first-party REST API for live and historical foreign exchange rates, currency conversion and currency metadata. It covers 166 fiat currencies, 873 cryptocurrencies and 4 precious metals (1,000+ currencies in total) in JSON or XML from one base URL, https://api.currencyfreaks.com/v2.0. The free Developer plan gives 1,000 API calls a month with daily refresh, USD base and SSL, no credit card required. Paid plans from $9.99 a month refresh hourly, every 10 minutes or every 60 seconds and unlock any base currency, conversion, historical rates back to 1984-11-28, time series, fluctuation and IP-to-currency. The official @currencyfreaks/mcp MCP server (MIT) exposes 7 tools to Claude, Cursor, VS Code and any MCP client.

---

## Platform overview

CurrencyFreaks is built and operated by JFreaks Software Solutions (Lahore, Pakistan), the team behind ipgeolocation.io, WhoisFreaks and APIFreaks. It is a first-party data provider: rates are collected from forex exchanges and banks in real time, processed, and served through one REST API.

- Coverage: 166 fiat currencies, 873 cryptocurrencies and 4 precious metals (XAU gold, XAG silver, XPT platinum, XPD palladium). 1,000+ currencies in total. Deprecated codes are kept in the catalogue with status DEPRECATED and an availableUntil date.
- Refresh cadence by plan: every 24 hours at 00:00 UTC (Developer), hourly (Starter), every 10 minutes (Growth), every 60 seconds (Professional and Enterprise).
- History: daily rates back to 1984-11-28 for major fiat currencies. Newer currencies and crypto start from their own listing date (BTC from 2013-01-07, XPT from 2020-09-02). Per-currency ranges come from /historical-data-limits.
- Formats: JSON by default, XML with format=xml. All rates and amounts are returned as strings.
- Transport: HTTPS on every plan, including free. 134 ms average global latency. Public status page at https://status.currencyfreaks.com/.
- Scale: 33,555+ registered developers. Customers include HP, Gartner, University of Georgia, Equiti, Timify, Exigo and Savart. Rated on Trustpilot.
- Dashboard: https://billing.currencyfreaks.com (API key, plan changes, usage).

### Authentication and formats

- Base URL: `https://api.currencyfreaks.com/v2.0/` + endpoint path (for example `/rates/latest`, `/convert/latest`).
- Auth: `?apikey=YOUR_APIKEY` query parameter on every request. Keys come from the dashboard after a free signup (no credit card). Do not embed the key in client-side JavaScript; call the API from a server or proxy.
- Method: HTTP GET. Currency codes are case-insensitive. `symbols` takes a comma-separated list such as `EUR,GBP,PKR`.
- Response format: JSON by default; `format=xml` for XML. In XML, currency codes that start with a digit are prefixed with an underscore (for example `<_1INCH>`).
- Error envelope: every 4xx response is JSON with `timestamp`, `status`, `error`, `message` and `path` fields. Branch on `status`, log `message`.
- Support: support@currencyfreaks.com and https://currencyfreaks.com/contact. Postman collection: https://documenter.getpostman.com/view/57124893/2sBY4TryiX.

### Quotas and rate limits

- The only limit is the plan quota (monthly, or yearly on annual billing). There is no per-second, hourly or daily throttle; a whole month's quota can be used in one day.
- Paid plans get email notifications at 80%, 90% and 100% of usage, then a further 10% of the plan limit is served before requests stop until the next billing cycle or an upgrade.
- The free plan gets one notification at 100% and then stops until the next month.
- Exceeding the quota returns HTTP 429. Calling an endpoint above your plan returns HTTP 402 with the plan name that unlocks it.

---

## Plans and pricing

Human-readable page: https://currencyfreaks.com/pricing. Sign up: https://currencyfreaks.com/signup. VAT is not included. Plans can be upgraded or downgraded at any time from the dashboard. Payment by credit or debit card and PayPal, processed by FastSpring and Paddle. GDPR compliant, with a DPA available on request.

| Plan | Price | API calls | Refresh | Base currency | Endpoints | Support |
| --- | --- | --- | --- | --- | --- | --- |
| Developer | Free | 1,000 / month | Every 24 hours (00:00 UTC) | USD only | Latest rates, symbols filter, key-free metadata endpoints | Limited |
| Starter | $9.99 / month or $99.99 / year | 15,000 / month (180,000 / year) | Hourly | Any | Developer + any base currency, latest conversion, historical rates, historical conversion | Basic |
| Growth | $49.99 / month or $499.99 / year | 150,000 / month (1.8 million / year) | Every 10 minutes | Any | Starter + IP to Currency; free trial available | Premium |
| Professional | $99.99 / month or $999.99 / year | 550,000 / month (6.6 million / year) | Every 60 seconds | Any | Growth + Time Series and Fluctuation | Premium |
| Enterprise | Custom | Custom volume | Every 60 seconds | Any | Everything, custom SLA, tailored solutions | Dedicated |

- Annual billing is priced at 10 months (Starter $99.99, Growth $499.99, Professional $999.99 a year) and pools 12 months of quota.
- Growth offers a free trial via https://currencyfreaks.com/signup?trial=true.
- Enterprise: custom volume, custom SLA, dedicated support and tailored solutions; contact sales through https://currencyfreaks.com/contact.
- Every plan includes SSL, JSON and XML output, and the three key-free metadata endpoints.

---

## API endpoints

All paths are relative to `https://api.currencyfreaks.com/v2.0`. Full documentation with code samples in cURL, Node.js, Java, Python, PHP, Ruby, JavaScript, C#, Go, C and Swift: https://currencyfreaks.com/documentation.

| Endpoint | Path | Plan | Required | Optional |
| --- | --- | --- | --- | --- |
| Latest Rates | `/rates/latest` | All plans (base needs a paid plan) | apikey | symbols, base, format |
| Latest Conversion | `/convert/latest` | Starter and above | apikey, from, to | amount, format |
| Historical Rates | `/rates/historical` | Starter and above | apikey, date | base, symbols, format |
| Time Series | `/timeseries` | Professional and above | apikey, startDate | endDate, base, symbols, format |
| Fluctuation | `/fluctuation` | Professional and above | apikey, startDate | endDate, base, symbols, format |
| Historical Conversion | `/convert/historical` | Starter and above | apikey, date, from, to | amount, format |
| IP to Currency | `/iptocurrency` | Growth and above | apikey, from | ip, amount, format |

| Metadata endpoint | Path | Auth | Returns |
| --- | --- | --- | --- |
| Supported Currencies | `/supported-currencies` | No key | supportedCurrenciesMap keyed by code: currencyCode, currencyName, countryCode, countryName, status (AVAILABLE or DEPRECATED), availableFrom, availableUntil, icon URL. Crypto entries have countryCode "Crypto", metals "Metal", both with countryName "Global". |
| Currency Symbols | `/currency-symbols` | No key | currencySymbols map of code to full name, e.g. "EUR": "Euro", "BTC": "Bitcoin". |
| Historical Data Limits | `/historical-data-limits` | No key | availabilityPeriod map of code to "YYYY-MM-DD to YYYY-MM-DD", the date range historical rates exist for each currency. |

### Latest Rates — `/rates/latest`

Latest exchange rates for every supported currency, USD base by default. Available on: All plans (base needs a paid plan).

```
GET /v2.0/rates/latest?apikey=YOUR_APIKEY&symbols=PKR,GBP,EUR,USD
```

```json
{
  "date": "2026-08-25 13:26:00+00",
  "base": "USD",
  "rates": {
    "EUR": "0.9278605451274349",
    "GBP": "0.8172754173817152",
    "PKR": "281.6212943333344",
    "USD": "1.0"
  }
}
```

| Parameter | Required | Description |
| --- | --- | --- |
| apikey | required | Account API key. |
| symbols | optional | Comma-separated currency codes. Omit for all 1,000+ currencies. |
| base | optional | Base currency code (default USD). Paid plans only; on the free plan it returns a 402. |
| format | optional | json (default) or xml. |

- Omitting symbols returns every currency; pass symbols to cut response size and latency.
- Rates are strings, not numbers, to avoid floating-point rounding. Convert with parseFloat or Decimal in your code.
- Refresh cadence follows the plan: daily, hourly, 10 minutes or 60 seconds.

### Latest Conversion — `/convert/latest`

Convert an amount between two currencies at the latest rate. Available on: Starter and above.

```
GET /v2.0/convert/latest?apikey=YOUR_APIKEY&from=USD&to=PKR&amount=500
```

```json
{
  "date": "2026-08-25 15:22:00+00",
  "from": "USD",
  "to": "PKR",
  "rate": "281.683",
  "givenAmount": "500.0",
  "convertedAmount": "140841.475"
}
```

| Parameter | Required | Description |
| --- | --- | --- |
| apikey | required | Account API key. |
| from | required | Source currency code. |
| to | required | Target currency code. |
| amount | optional | Amount to convert (default 1.0). |

### Historical Rates — `/rates/historical`

Exchange rates for a past date. Major fiat currencies go back to 1984-11-28; newer currencies and crypto start from their own listing date. Available on: Starter and above.

```
GET /v2.0/rates/historical?apikey=YOUR_APIKEY&date=2026-08-20&base=GBP&symbols=USD,EUR,PKR,CAD
```

```json
{
  "date": "2026-08-20",
  "base": "GBP",
  "rates": { "USD": "...", "EUR": "...", "PKR": "...", "CAD": "..." }
}
```

| Parameter | Required | Description |
| --- | --- | --- |
| apikey | required | Account API key. |
| date | required | Date in YYYY-MM-DD format. |
| base | optional | Base currency code (default USD). |
| symbols | optional | Comma-separated currency codes. |

- Check per-currency coverage with /historical-data-limits before requesting old dates; a date outside the range returns a 404 with the available range in the message.

### Time Series — `/timeseries`

Daily historical rates between two dates, one entry per day. Available on: Professional and above.

```
GET /v2.0/timeseries?apikey=YOUR_APIKEY&startDate=2026-07-01&endDate=2026-07-07&base=EUR&symbols=PKR,USD
```

```json
{
  "startDate": "2026-07-01",
  "endDate": "2026-07-07",
  "base": "EUR",
  "historicalRatesList": [
    { "date": "2026-07-01", "rates": { "PKR": "...", "USD": "..." } },
    { "date": "2026-07-02", "rates": { "PKR": "...", "USD": "..." } }
  ]
}
```

| Parameter | Required | Description |
| --- | --- | --- |
| apikey | required | Account API key. |
| startDate | required | Start of the range, YYYY-MM-DD. |
| endDate | optional | End of the range, YYYY-MM-DD (default: the day before today). |
| base | optional | Base currency code (default USD). |
| symbols | optional | Comma-separated currency codes. |

- One request returns the whole range, so a year of daily rates costs one call instead of 365.
- startDate after today or after endDate returns a 400.

### Fluctuation — `/fluctuation`

Start rate, end rate, absolute change and percent change for each currency between two dates. Available on: Professional and above.

```
GET /v2.0/fluctuation?apikey=YOUR_APIKEY&startDate=2026-06-01&endDate=2026-06-15&symbols=PKR&base=GBP
```

```json
{
  "startDate": "2026-06-01",
  "endDate": "2026-06-15",
  "base": "GBP",
  "rateFluctuations": {
    "PKR": {
      "startRate": "254.331",
      "endRate": "243.874",
      "change": "10.457",
      "percentChange": "4.11"
    }
  }
}
```

| Parameter | Required | Description |
| --- | --- | --- |
| apikey | required | Account API key. |
| startDate | required | Start of the range, YYYY-MM-DD. |
| endDate | optional | End of the range, YYYY-MM-DD (default: the day before today). |
| base | optional | Base currency code (default USD). |
| symbols | optional | Comma-separated currency codes. |

### Historical Conversion — `/convert/historical`

Convert an amount using the rate on a past date. Available on: Starter and above.

```
GET /v2.0/convert/historical?apikey=YOUR_APIKEY&date=2026-08-15&from=USD&to=PKR&amount=500
```

```json
{
  "date": "2026-08-15",
  "from": "USD",
  "to": "PKR",
  "rate": "...",
  "givenAmount": "500.0",
  "convertedAmount": "..."
}
```

| Parameter | Required | Description |
| --- | --- | --- |
| apikey | required | Account API key. |
| date | required | Date in YYYY-MM-DD format. |
| from | required | Source currency code. |
| to | required | Target currency code. |
| amount | optional | Amount to convert (default 1.0). |

### IP to Currency — `/iptocurrency`

Resolve the local currency of an IPv4 or IPv6 address and convert an amount into it. There is no `to` parameter; the API returns the resolved currency as the `to` field. Available on: Growth and above.

```
GET /v2.0/iptocurrency?apikey=YOUR_APIKEY&from=GBP&ip=182.186.18.91&amount=500
```

```json
{
  "date": "2026-08-25 08:03:00+00",
  "from": "GBP",
  "to": "PKR",
  "rate": "346.232",
  "ipAddress": "182.186.18.91",
  "givenAmount": "500.0",
  "convertedAmount": "173115.892"
}
```

| Parameter | Required | Description |
| --- | --- | --- |
| apikey | required | Account API key. |
| from | required | Source currency code. |
| ip | optional | IPv4 or IPv6 address. If omitted, the calling client's IP is used. |
| amount | optional | Amount to convert (default 1.0). |

- Invalid IP returns a 400; an IP with unknown geolocation returns a 404.

### Metadata endpoints (no API key)

```
GET https://api.currencyfreaks.com/v2.0/supported-currencies
GET https://api.currencyfreaks.com/v2.0/currency-symbols
GET https://api.currencyfreaks.com/v2.0/historical-data-limits
```

```json
{
  "supportedCurrenciesMap": {
    "PKR": {
      "currencyCode": "PKR",
      "currencyName": "Pakistan Rupee",
      "countryCode": "PK",
      "countryName": "Pakistan",
      "status": "AVAILABLE",
      "availableFrom": "1985-10-02",
      "availableUntil": "2026-09-07",
      "icon": "https://currencyfreaks.com/photos/flags/pkr.png?v=0.1"
    },
    "BTC": { "currencyCode": "BTC", "currencyName": "Bitcoin", "countryCode": "Crypto", "countryName": "Global", "status": "AVAILABLE", "availableFrom": "2013-01-07", "...": "..." },
    "GBX": { "currencyCode": "GBX", "currencyName": "Penny Sterling", "countryCode": "UK", "status": "DEPRECATED", "availableFrom": "2021-04-05", "availableUntil": "2023-03-15", "...": "..." }
  }
}
```

### HTTP status and error codes

| HTTP | Message |
| --- | --- |
| 200 | Successful request. |
| 206 | Partial Response. |
| 400 | Please provide API Key to use CurrencyFreaks API. |
| 400 | Invalid URL Parameters / You have provided invalid parameters for this endpoint. |
| 400 | Invalid format (Available formats: json, xml). |
| 400 | Invalid Amount. Please provide amount in decimal format and greater than 0! |
| 400 | From Currency is invalid. It cannot be empty or null! |
| 400 | Provided Date {DATE} is in invalid format. It should be like YYYY-MM-DD! |
| 400 | Starting date cannot be after current date or ending date. |
| 400 | Provided IP Address {IP_ADDRESS} is invalid. |
| 401 | Provided API key is invalid / inactive. |
| 402 | This feature is available on {PLAN_NAME} plan and onwards! |
| 404 | Required URL is not found. |
| 404 | Rates of provided date {DATE} are not available in our database. |
| 404 | Rates of provided base and symbols are not found for given intervals. |
| 404 | Geolocation of provided IP {IP_ADDRESS} is unknown. |
| 404 | Rates of provided currency {CURRENCY} are available from {AVAILABLE_FROM} to {AVAILABLE_UNTIL} in our database! |
| 404 | Rates of provided currency {CURRENCY} / Symbols are not available in our database! |
| 429 | You have exceeded the limit of {ALLOWED_REQUESTS} requests for your subscribed plan {PLAN_NAME}. |

```json
{
  "timestamp": 1788425488646,
  "status": 401,
  "error": "Invalid Api Access Exception",
  "message": "Provided API key is invalid. [Contact tech. support for assistance at support@currencyfreaks.com]",
  "path": "/v2.0/rates/latest"
}
```

---

## MCP server — agent readiness

The official CurrencyFreaks MCP (Model Context Protocol) server is a thin, typed layer over the v2.0 REST API. It runs locally over stdio, validates input before spending a request, returns structured JSON to the model, and turns upstream errors into results with a `guidance` field so the assistant can explain what to fix.

- Package: `@currencyfreaks/mcp` (npm), MIT license, Node.js 18+ with npx on PATH.
- Start command: `npx -y @currencyfreaks/mcp`
- Environment variable: `CURRENCYFREAKS_API_KEY` (required for every tool except list_currencies). The key stays in the local client config and is sent only to api.currencyfreaks.com.
- Page: https://currencyfreaks.com/mcp-server. Source and issues: https://github.com/CurrencyFreaks/currencyfreaks-mcp
- Supported clients: Claude Desktop, Claude Code, Cursor, Windsurf, VS Code with GitHub Copilot, Cline, Codex CLI, and any client that runs MCP servers over stdio.
- Cost: the server is free; each tool call is one API request against the plan quota. One prompt can trigger several tool calls. list_currencies reads key-free endpoints and costs nothing.
- Free plan: get_latest_rates (USD base) and list_currencies work. convert_currency, get_historical_rates, ip_to_currency, get_time_series and get_fluctuation need the plans listed below. The `base` parameter needs Starter or above on every tool. A call above the plan returns a 402 result with guidance instead of failing silently.
- Response size: without `symbols` the rate tools return all 1,000+ currencies; the full detailed catalogue from list_currencies is about 270 KB. Pass `symbols` or `search` to keep results small.

### Setup

1. Get a free API key at https://currencyfreaks.com/signup (1,000 requests a month, no card).
2. Add the server to the client config (table below).
3. Restart the client; MCP clients read their server list at startup.
4. Ask a question such as "What's the current EUR to USD exchange rate?"; the client calls get_latest_rates.

| Client | Where | What to add |
| --- | --- | --- |
| Claude Desktop | claude_desktop_config.json (Settings > Developer > Edit Config) | JSON block below |
| Claude Code | terminal | claude mcp add currencyfreaks --env CURRENCYFREAKS_API_KEY=<YOUR_API_KEY> -- npx -y @currencyfreaks/mcp |
| Cursor | .cursor/mcp.json (or one-click install) | JSON block below |
| Windsurf | ~/.codeium/windsurf/mcp_config.json | JSON block below |
| VS Code (GitHub Copilot) | settings.json under the mcp.servers key | Same server object under "mcp": { "servers": { ... } } |
| Cline | cline_mcp_settings.json (MCP Servers > Configure > Advanced MCP Settings) | JSON block below |
| Codex CLI | terminal | codex mcp add currencyfreaks --env CURRENCYFREAKS_API_KEY=<YOUR_API_KEY> -- npx -y @currencyfreaks/mcp |
| Any stdio MCP client | client config | command npx, args ["-y", "@currencyfreaks/mcp"], env CURRENCYFREAKS_API_KEY |

```json
{
  "mcpServers": {
    "currencyfreaks": {
      "command": "npx",
      "args": ["-y", "@currencyfreaks/mcp"],
      "env": {
        "CURRENCYFREAKS_API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}
```

```bash
claude mcp add currencyfreaks --env CURRENCYFREAKS_API_KEY=<YOUR_API_KEY> -- npx -y @currencyfreaks/mcp
codex mcp add currencyfreaks --env CURRENCYFREAKS_API_KEY=<YOUR_API_KEY> -- npx -y @currencyfreaks/mcp
```

### The 7 tools

Describe what you need in plain language; the client picks the tool. Currency codes are case-insensitive and `symbols` takes a comma-separated list.

| Tool | Parameters | Calls | Plan |
| --- | --- | --- | --- |
| get_latest_rates | symbols, base | GET /v2.0/rates/latest | Free (USD base); base needs Starter+ |
| list_currencies | search, detailed | GET /v2.0/currency-symbols, /supported-currencies, /historical-data-limits | No key needed |
| convert_currency | from, to, amount, date | GET /v2.0/convert/latest or /convert/historical when date is passed | Starter+ |
| get_historical_rates | date, symbols, base | GET /v2.0/rates/historical | Starter+ |
| ip_to_currency | from, ip, amount | GET /v2.0/iptocurrency | Growth+ |
| get_time_series | startDate, endDate, symbols, base | GET /v2.0/timeseries | Professional+ |
| get_fluctuation | startDate, endDate, symbols, base | GET /v2.0/fluctuation | Professional+ |

- list_currencies searches the catalogue by code, name or country; `detailed=true` adds status, flag and the historical date range per currency.
- convert_currency uses the latest rate, or the rate on `date` when one is passed.
- Error results carry `error`, `code`, `message` and `guidance`: 400 bad input, 401 invalid or inactive key, 402 plan upgrade needed, 404 no rates for that currency, date or range, 429 quota used up, 499 upstream timeout.

---

## Integrations

Every integration calls the same endpoints with the same key and works on the free Developer plan. Index page: https://currencyfreaks.com/integrations.

### Programming languages

| Integration | What the guide covers | Guide |
| --- | --- | --- |
| Python | requests; pip install, first call, conversion, historical lookups | https://currencyfreaks.com/blog/Python-Currency-Converter-API |
| JavaScript | fetch with async/await for browser and server, TypeScript types, embeddable widget | https://currencyfreaks.com/blog/Building-a-Currency-Exchange-Widget-With-JS |
| Node.js | Express proxy route with Axios, caching, key kept server-side | https://currencyfreaks.com/blog/Integration-of-Free-Currency-Converter-API-with-Node-JS |
| PHP | cURL, file_get_contents and a Laravel service class with caching | https://currencyfreaks.com/blog/Laravel-Currency-API-Integration |
| Go | net/http with struct-based JSON parsing, timeouts, in-memory cache | https://currencyfreaks.com/blog/Mastering-Golang-Currency |
| Ruby | Ruby on Rails with HTTParty, service object, caching, background job | https://currencyfreaks.com/blog/Exchange-Rate-API-Integration-With-Ruby-On-Rails |
| Java | HttpClient and OkHttp examples for Spring and Android (guide coming soon; OkHttp snippet in the documentation) | Coming soon |
| C# / .NET | HttpClient integration for ASP.NET and console apps (guide coming soon; RestSharp snippet in the documentation) | Coming soon |
| Swift | URLSession examples for iOS and macOS (guide coming soon; snippet in the documentation) | Coming soon |
| Kotlin | Retrofit and OkHttp for Android (coming soon) | Coming soon |

### Web frameworks

| Integration | What the guide covers | Guide |
| --- | --- | --- |
| React | Live currency converter component with hooks | https://currencyfreaks.com/blog/Integration-of-Free-Currency-Converter-API-with-React-JS |
| Vue.js | Reactive conversion with the Composition API | https://currencyfreaks.com/blog/Currency-Converter-API-Integration-With-Vue-JS |
| Svelte | Standalone component and SvelteKit server-side fetching | https://currencyfreaks.com/blog/Exchange-Rate-API-Integration-With-Svelte-JS |
| Django | Views, Redis caching, DRF endpoint, Celery refresh | https://currencyfreaks.com/blog/CurrencyFreaks-API-Integration-With-Django |
| Angular | Service-based integration with RxJS observables (coming soon) | Coming soon |

### AI assistants and agents

| Integration | What the guide covers | Guide |
| --- | --- | --- |
| Claude Desktop and Claude Code | One config block or one terminal command | https://currencyfreaks.com/mcp-server |
| Cursor | One-click install or .cursor/mcp.json | https://currencyfreaks.com/mcp-server |
| VS Code (GitHub Copilot) | Server under the mcp key in settings.json | https://currencyfreaks.com/mcp-server |
| Windsurf, Cline and Codex CLI | Same npx command in any MCP client | https://currencyfreaks.com/mcp-server |
| ChatGPT and Gemini | OpenAI function calling and Gemini function declarations with full code | https://currencyfreaks.com/blog/API-For-Exchange-Rates-With-ChatGPT |

### E-commerce platforms

| Integration | What the guide covers | Guide |
| --- | --- | --- |
| WordPress | Plugin, or a [currency_converter] shortcode in PHP | https://currencyfreaks.com/blog/WordPress-Currency-Converter |
| Shopify | Liquid template and JavaScript integration, or an app | https://currencyfreaks.com/blog/Shopify-Currency-Converter |
| WooCommerce | Live rates in product pages and cart totals (coming soon) | Coming soon |
| Magento | Module-based integration (coming soon) | Coming soon |

### Productivity and data tools

| Integration | What the guide covers | Guide |
| --- | --- | --- |
| Google Sheets | Custom Apps Script functions with automatic refresh | https://currencyfreaks.com/blog/Integrating-Currency-API-with-Google-Sheets |
| Excel | WEBSERVICE() and Power Query formulas | https://currencyfreaks.com/blog/Calculate-Exchange-Rate-In-Excel |
| Power BI | Live conversion in dashboards (coming soon) | Coming soon |
| Airtable | Automation script for currency fields (coming soon) | Coming soon |
| Notion | Live rates in databases via API automation (coming soon) | Coming soon |

### No-code and automation

| Integration | What the guide covers | Guide |
| --- | --- | --- |
| Postman | Official collection with a pre-built request for every endpoint and variables for apikey, base and symbols | https://documenter.getpostman.com/view/57124893/2sBY4TryiX |
| Zapier | Trigger workflows on exchange-rate changes (coming soon) | Coming soon |

---

## Supported currencies and reference pages

- Supported Currencies page: https://currencyfreaks.com/supported-currencies. Tables of fiat, crypto and metal currencies with code, name, first available date and last available date, plus deprecated codes. Each code links to https://currencyfreaks.com/available-rates/{CODE}.
- Same data by API: `/supported-currencies`, `/currency-symbols`, `/historical-data-limits` (no key).
- Metals: XAU (gold), XAG (silver), XPT (platinum), XPD (palladium).
- Examples of fiat start dates: AUD 1984-11-28, ANG 1985-10-02, AED 1989-08-18, ARS 1992-01-02, ALL 1998-07-31, AMD 2009-09-28, AZN 2011-07-15.

- [Currency Abbreviations](https://currencyfreaks.com/currency-abbreviations): Every ISO 4217 three-letter currency code in one table with the full currency name and the countries that use it, plus precious metal and cryptocurrency codes.
- [Currency Symbols](https://currencyfreaks.com/currency-symbols): Complete list of currency symbols with ISO 4217 code, countries, Unicode codepoint, HTML entity and typing shortcuts. Dollar ($), euro (€), pound (£), yen (¥), rupee (₹) and 20+ more.
- [World Currency List by Country](https://currencyfreaks.com/currency-symbols/all-countries): 214+ countries with their official currency name, ISO 4217 code and symbol in one reference table.
- [The Dollar Sign ($)](https://currencyfreaks.com/currency-symbols/dollar): History and meaning of the dollar sign, the 20+ currencies that use it (USD, CAD, AUD, NZD, SGD, HKD, MXN and more) and how ISO 4217 codes tell them apart.
- [Types of Currency](https://currencyfreaks.com/currency-symbols/types): Fiat money, cryptocurrencies, commodity-backed currencies and digital money: how they differ, what ISO 4217 covers and where each supported currency fits.

---

## Blog

Index: https://currencyfreaks.com/blog. Markdown copy of any post: its URL with ".md" appended.

### Integration tutorials

- [Currency Converter API in Python: Tutorial with Full Code (2026)](https://currencyfreaks.com/blog/Python-Currency-Converter-API): Fetch live rates, convert currencies and read historical data in Python with the requests library. Free plan, full working code.
- [Node.js Currency API: Full Express Converter Code (2026)](https://currencyfreaks.com/blog/Integration-of-Free-Currency-Converter-API-with-Node-JS): Complete Express and Axios code for a Node.js currency converter, with rate caching, the string-rate NaN fix and what the free plan returns.
- [React Exchange Rate API Integration: Currency Converter Tutorial (2026)](https://currencyfreaks.com/blog/Integration-of-Free-Currency-Converter-API-with-React-JS): Integrate live exchange rates into React with useState, useEffect, a custom hook and error handling. Full code.
- [Vue.js Currency Converter with Live Exchange Rates API (2026)](https://currencyfreaks.com/blog/Currency-Converter-API-Integration-With-Vue-JS): Build a Vue.js currency converter that fetches live rates with axios and shows conversions reactively. Free plan.
- [Exchange Rate API Integration with Svelte JS: Tutorial with Code (2026)](https://currencyfreaks.com/blog/Exchange-Rate-API-Integration-With-Svelte-JS): Live exchange rates in Svelte and SvelteKit: reactive stores, onMount fetching, server-side key protection and error handling.
- [Currency API in JavaScript & TypeScript: Live Rate Widget](https://currencyfreaks.com/blog/Building-a-Currency-Exchange-Widget-With-JS): Call the API with async/await, type the response in TypeScript, reuse it in a useCurrencyRate React hook and embed a dark-mode rate widget.
- [PHP & Laravel Currency API Integration (with Code Examples)](https://currencyfreaks.com/blog/Laravel-Currency-API-Integration): Call the API from plain PHP with cURL or file_get_contents, then in Laravel with a service class, caching, Blade views and a scheduled command.
- [Golang Currency API Integration: Exchange Rates Tutorial (2026)](https://currencyfreaks.com/blog/Mastering-Golang-Currency): Fetch real-time rates in Go with net/http, parse JSON into structs, add context timeouts, cache in memory and handle errors idiomatically.
- [Exchange Rate API Integration with Ruby on Rails (2026)](https://currencyfreaks.com/blog/Exchange-Rate-API-Integration-With-Ruby-On-Rails): Rails integration with HTTParty, a service object, Rails caching, a background job for scheduled updates and error handling.
- [Django Currency API Integration - Real-Time Tutorial (2026)](https://currencyfreaks.com/blog/CurrencyFreaks-API-Integration-With-Django): Fetch real-time rates in Django with Redis caching, Django REST Framework endpoints, Celery background tasks and error handling.
- [Free Currency Converter API in Python - Step-by-Step](https://currencyfreaks.com/blog/Integration-Of-Free-Currency-Converter-API-In-Python): Beginner guide to fetching real-time exchange rates in Python: setup, API key, endpoints and live code. Free plan.
- [Integration of CF Real Time Converter API in Python](https://currencyfreaks.com/blog/Integration-Of-CurrencyFreaks-Real-Time-Currency-Converter-API-In-Python): Guide to every CurrencyFreaks endpoint from Python, from supported currencies to historical rates.
- [Using a Currency Exchange Rate API with AI - ChatGPT, Gemini, and MCP (2026)](https://currencyfreaks.com/blog/API-For-Exchange-Rates-With-ChatGPT): Connect live exchange rates to ChatGPT, Claude and Gemini: OpenAI function calling, the MCP server for Claude, Gemini function declarations. Full code.
- [Global Exchange Rates API Integration with Google Gemini](https://currencyfreaks.com/blog/Global-Exchange-Rates-API-With-Gemini): Integrate live exchange rates into Google Gemini with Python for SaaS and fintech workflows.
- [How to Use a Currency API in Google Sheets (Apps Script Tutorial)](https://currencyfreaks.com/blog/Integrating-Currency-API-with-Google-Sheets): Pull live and historical rates into Google Sheets with Apps Script: custom cell functions, copy-paste code and auto-refresh.
- [Google Sheets Currency Conversion: GOOGLEFINANCE + Live Exchange Rate API](https://currencyfreaks.com/blog/Add-Real-Time-Currency-Converter-In-Google-Sheets): Two ways to convert currency in Google Sheets: the GOOGLEFINANCE formula or a live API for 60-second rates, crypto, metals and history.
- [Mastering How to Calculate Exchange Rate in Excel: A Simple Guide](https://currencyfreaks.com/blog/Calculate-Exchange-Rate-In-Excel): Exchange rate formulas in Excel, then live rates with the API via WEBSERVICE() and Power Query, with automation steps.
- [WordPress Currency Converter: Live Rates (Plugin/Shortcode)](https://currencyfreaks.com/blog/WordPress-Currency-Converter): Add a WordPress currency converter with a plugin or a custom [currency_converter] shortcode in copy-paste PHP. Free API key.
- [Shopify Currency Converter API: Add Live Exchange Rates to Your Store (2026)](https://currencyfreaks.com/blog/Shopify-Currency-Converter): Add live exchange rates to Shopify with Liquid templates, JavaScript and the Markets API, or a Shopify app. Free plan.
- [Migrate from Fixer API to CurrencyFreaks (2026 Guide)](https://currencyfreaks.com/blog/Migrate-From-Fixer-API-To-CurrencyFreaks): Endpoint mapping, auth changes and before-and-after code in Python, JavaScript and PHP to move from Fixer in under an hour.

### Provider comparisons and alternatives

- [10 Best Currency Exchange APIs in 2026: Free & Paid Compared](https://currencyfreaks.com/blog/10-Best-Currency-Exchange-API): Ten providers compared on free calls, commercial use, crypto, metals, history start and update speed.
- [How Many Currencies Does Each Currency API Support? Verified 2026 Comparison](https://currencyfreaks.com/blog/Currency-API-Supported-Currencies-Comparison): Every major provider's live currency list pulled and counted. Advertised totals include abolished codes, territories and metals; the verified fiat counts are lower.
- [Fixer API Pricing and Free Plan Limits Compared (2026)](https://currencyfreaks.com/blog/Fixer-Api-Pricing-Alternative): Fixer: 100 free calls, EUR base, non-commercial only, paid from $14.99. CurrencyFreaks: 1,000 free calls, commercial use, paid from $9.99.
- [ExchangeRate-API Pricing (2026) & Best Alternative](https://currencyfreaks.com/blog/ExchangeRate-Api-Pricing-Alternative): ExchangeRate-API: 1,500 free calls, 165 currencies, history from 1990, paid from $10. CurrencyFreaks: 1,000 free calls, 1,000+ currencies, history from 1984, paid from $9.99.
- [Open Exchange Rates API Pricing & Best Alternative (2026)](https://currencyfreaks.com/blog/Open-Exchange-Rates-Api-Pricing-Alternative): Both free plans give 1,000 calls with USD base. Paid from $9.99 vs $12; conversion endpoint included on every CurrencyFreaks paid plan vs the $97 Unlimited plan on Open Exchange Rates.
- [Currencylayer API Pricing & Best Alternative: 1,000 Free Calls vs 100 (2026)](https://currencyfreaks.com/blog/Currencylayer-Api-Pricing-Alternative): Currencylayer: 100 free calls, non-commercial, USD base, paid from $14.99. CurrencyFreaks: 1,000 free calls, 1,000+ currencies, paid from $9.99.
- [XE Currency API Pricing & Free Alternative (2026): Honest Comparison](https://currencyfreaks.com/blog/Xe-Api-Pricing-Alternative): XE has no free plan and starts at $799 a year after a 7-day trial. CurrencyFreaks starts free and at $99.99 a year; history to 1984 vs 1995.
- [OANDA API Pricing, Limits & Best Currency Conversion API Alternatives in 2026](https://currencyfreaks.com/blog/Currency-Conversion-Api-Oanda-Pricing): OANDA Exchange Rates API: 7-day trial then from $4,850 a year. CurrencyFreaks: 1,000 free calls a month, paid from $9.99.
- [Google Has No Currency Exchange Rate API: What Developers Use Instead (2026)](https://currencyfreaks.com/blog/Google-Currency-Exchange-Rate-API-Alternative): GOOGLEFINANCE is a Sheets function, not a REST API. Compares CurrencyFreaks, Frankfurter, ExchangeRate-API and Alpha Vantage as real alternatives.
- [Better Alternatives to Google Currency API](https://currencyfreaks.com/blog/Why-Businesses-Are-Switching-From-the-Google-Currency-Exchange-Rate-API-to-Better-APIs): Limits of relying on Google for forex data and why teams move to APIs with real-time updates, more endpoints and historical data.
- [Best Financial API Picks for Real-Time Data in 2026](https://currencyfreaks.com/blog/Best-Financial-API-Picks-For-Real-Time-Data-in-2026): Twelve financial API providers for stocks, forex, crypto and banking compared on latency, coverage and pricing.
- [Reliable Exchange Rates Data Sources (2026)](https://currencyfreaks.com/blog/Reliable-Exchange-Rates-Data-Sources-2026): Spot versus official rates, categories of exchange rate data, top sources and APIs, and how to pick a provider.
- [Most Reliable Historical Rate APIs in 2024](https://currencyfreaks.com/blog/Most-Reliable-Historical-Rate-APIs-In-2024): Historical currency rate APIs compared, including CurrencyFreaks, Fixer and Exchange Rates API, for analysis and reporting.
- [Top 10 Best Currency Conversion APIs in 2024 for Accurate Exchange Rates](https://currencyfreaks.com/blog/Top-10-Conversion-API-in-2024): Ten currency conversion APIs reviewed for real-time data, historical insight and integration ease.
- [Currency Conversion Web Service: What Replaced the Old SOAP and WSDL Endpoints](https://currencyfreaks.com/blog/Migrate-SOAP-Currency-Web-Service-To-REST): Legacy SOAP currency web services are offline. SOAP versus REST, what to check in a provider, and a four-step WSDL-to-JSON migration.

### Guides and use cases

- [How to Build a Multi-Currency Invoice System with a Currency API (2026)](https://currencyfreaks.com/blog/Automated-Multi-Currency-Invoice-System-Using-Exchange-API): Rate fetching with caching, line-item conversion, rate locking, historical lookup for audit, IP-based currency detection and a cron pre-fetch. Node.js and Python.
- [Build a Real-Time Currency Dashboard With Python and Flask (2026)](https://currencyfreaks.com/blog/Building-a-Forex-Dashboard): Browser-based live currency dashboard with Python and Flask using the free API. Full working code.
- [Visualize Exchange Rate Data with Python and Plotly (2026)](https://currencyfreaks.com/blog/Visualize-Exchange-Rate-Data-Python-Plotly): Interactive exchange rate charts in Python with Plotly: live rates, 90-day history, multi-currency comparison and an optional Dash dashboard.
- [Forex Heatmap Guide: Build a Clear Market View With CurrencyFreaks & D3.js](https://currencyfreaks.com/blog/Creating-Forex-Heatmap-With-CF-And-D3-js): Build a forex strength heatmap with the API and D3.js: fetching data, rendering, interactivity, CSV export and complete code.
- [Analyze Volatility With a Foreign Exchange Rates API | Guide](https://currencyfreaks.com/blog/Analyze-Volatility-With-Foreign-Exchange-Rates-API): Measure currency volatility with the Fluctuation endpoint: usage with code, reading results, visualisation and team use cases.
- [Historical Forex Data: Batch Download to CSV & Excel](https://currencyfreaks.com/blog/Historical-Forex-Data-for-Scalable-Data-Science-Workflows): Batch download daily rates back to 1984 for 1,000+ currencies to CSV or Excel with Python, with quota and plan notes.
- [Building ML Datasets With a Reliable Currency Exchange Rate API](https://currencyfreaks.com/blog/Building-Financial-ML-Datasets-Using-Currency-Exchange-Rate-API): Build clean FX datasets for machine learning: pipeline design, labelled training sets, a Python implementation and maintenance practices.
- [Forex Alerts Automation With CurrencyFreaks And Node.js](https://currencyfreaks.com/blog/Forex-Alerts-Automation): Automate forex price alerts with Node.js and node-cron: architecture, alert engine code, a market analysis dashboard and scaling tips.
- [Build a Currency Exchange Bot for WhatsApp Using Live Rates](https://currencyfreaks.com/blog/Building-a-Currency-Exchange-Bot-For-Whatsapp): Architecture and implementation of a WhatsApp bot that answers currency questions with live rates.
- [Currency Localization: Detect User Currency From IP Automatically via IP](https://currencyfreaks.com/blog/Dynamic-Currency-Conversion): Resolve a visitor's IP to a currency and show localised prices with the IP-to-currency endpoint. cURL, JavaScript and Node.js code.
- [Optimize API Usage: Reduce Calls & Save Costs](https://currencyfreaks.com/blog/Optimize-API-Usage-With-CurrencyFreaks): Cut API calls with the symbols and base parameters, caching, fewer conversion calls, historical features and usage monitoring.
- [Currency Rate API Caching and Latency Guide](https://currencyfreaks.com/blog/Currency-Rate-API-Caching-Latency-Guide): Caching strategies, fallback design and latency control for currency rate APIs in production apps.
- [CurrencyFreaks API Error Handling](https://currencyfreaks.com/blog/CurrencyFreaks-Error-Handling): Common integration errors (connection failures, quota exceeded, unexpected responses) and strategies for handling them gracefully.
- [Free Currency API Security Risks Developers Ignore](https://currencyfreaks.com/blog/Free-Currency-API-Security-Risks): Client-side key exposure, missing SSL, hidden rate limits, untrusted data sources and sensitive historical data, and when to move to a paid plan.
- [Currency Converter Integration with Data Visualization](https://currencyfreaks.com/blog/Currency-Converter-Integration-With-Data-Visualization): Integrate a free currency converter with interactive forex charts in Python.
- [Build Crypto Arbitrage Checker Using RESTful Exchange API](https://currencyfreaks.com/blog/RESTful-API-For-Currency-Exchange): Normalise crypto prices across exchanges with a REST forex API to spot real arbitrage gaps and avoid false signals.
- [Real Salary Value Calculator With API Integration](https://currencyfreaks.com/blog/Real-Salary-Value-Calculator-With-API-Integration): Build a calculator that converts a freelance rate with live and historical exchange rates, then applies fees and taxes. Node.js code.
- [Currency Exchange API Use Cases: 6 Industries With Code Examples (2026)](https://currencyfreaks.com/blog/CurrencyFreaks-Best-Forex-API): How healthcare, gaming, real estate, e-commerce, travel and financial management apps integrate a currency API, each with working code.
- [12 Industries Using A Currency Conversion Rate API](https://currencyfreaks.com/blog/Industries-Using-Currency-Conversion-Rate-API): Twelve industry use cases for real-time currency conversion, a plan comparison and a JavaScript conversion example.
- [Top 10 Exchange Rates API Applications in 2026](https://currencyfreaks.com/blog/Exchange-Rates-Api-Applications-2026): Ten application areas for exchange rate APIs, pricing plan comparison, a technical usage guide and advanced features.
- [Convert Currency API: How Does It Improve UX Within Global Apps (2026)](https://currencyfreaks.com/blog/Convert-Currency-API-Global-UX): Show real-time local prices to cut cart abandonment: features, provider selection, integration steps, IP localisation and historical data.
- [Best Currency Converter API Features For Global Growth](https://currencyfreaks.com/blog/Best-Currency-Converter-API-Features): Twelve features every currency converter API should offer, with a technical implementation example.
- [Real-Time Currency API for Global Business Growth](https://currencyfreaks.com/blog/Real-Time-Currency-API-Business): Ten reasons a business needs a real-time currency API, how to choose one and common challenges with solutions.
- [Best Currency API for Your SaaS Application (Guide)](https://currencyfreaks.com/blog/Choosing-Best-Currency-API-For-Your-Saas-App): How to evaluate a currency API for SaaS: features, performance, security, documentation, pricing and a provider comparison.
- [Choosing Right API for Currency Exchange](https://currencyfreaks.com/blog/Choosing-Right-API-for-Currency-Exchange): Compare accuracy, speed, security, pricing and features when choosing a currency exchange API, plus top free options.
- [Essential Guide to Choosing the Best Forex API for Your Needs](https://currencyfreaks.com/blog/Building-E-commerce-System-Using-a-Forex-API): Multi-currency support in e-commerce: benefits of a forex API, real-life applications, how to build multi-currency checkout and its challenges.

---

## Company / support / links

- Home: https://currencyfreaks.com
- Documentation: https://currencyfreaks.com/documentation
- Pricing: https://currencyfreaks.com/pricing
- Sign up (free, no card): https://currencyfreaks.com/signup
- Login and dashboard: https://billing.currencyfreaks.com/login
- FAQs: https://currencyfreaks.com/faqs
- Integrations: https://currencyfreaks.com/integrations
- MCP server: https://currencyfreaks.com/mcp-server
- Supported currencies: https://currencyfreaks.com/supported-currencies
- About: https://currencyfreaks.com/about-us (JFreaks Software Solutions, Lahore, Pakistan; sibling products ipgeolocation.io, whoisfreaks.com, apifreaks.com)
- Contact and support: https://currencyfreaks.com/contact, support@currencyfreaks.com
- Status: https://status.currencyfreaks.com/
- GitHub: https://github.com/CurrencyFreaks
- X/Twitter: https://twitter.com/currencyfreaks
- Trustpilot: https://www.trustpilot.com/review/currencyfreaks.com
- Terms: https://currencyfreaks.com/tos
- Privacy: https://currencyfreaks.com/privacy
- Page index for AI assistants: https://currencyfreaks.com/llms.txt
- Sitemap: https://currencyfreaks.com/sitemap.xml

_Generated: 2026-10-29T08:30:26.975Z_