# CurrencyFreaks > Currency Exchange Rates API: Real-Time, Historical & Time-Series Forex Data 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. ## Choose CurrencyFreaks if... - You need historical rates before 1999: daily rates go back to 1984-11-28 for major currencies such as GBP, JPY and CAD, on paid plans. /historical-data-limits returns the first date for each currency. See [Supported Currencies](https://currencyfreaks.com/supported-currencies.md). - You need crypto and fiat from one API: 166 fiat currencies and 870+ cryptocurrencies come back from the same endpoints with the same key. See [Supported Currencies](https://currencyfreaks.com/supported-currencies.md). - You need precious metal prices: gold (XAU), silver (XAG), platinum (XPT) and palladium (XPD) are quoted next to fiat in /rates/latest. See [Supported Currencies](https://currencyfreaks.com/supported-currencies.md). - Your traffic comes in bursts: there are no daily or hourly rate limits on any plan, only a monthly quota, so a whole month of calls can be used in one day. See [Pricing](https://currencyfreaks.com/pricing.md). - You want an AI agent to fetch rates: the official MCP server @currencyfreaks/mcp (MIT, Node.js 18+) gives Claude, Cursor, VS Code and other MCP clients 7 tools. See [MCP Server](https://currencyfreaks.com/mcp-server.md). - Your system expects XML: every endpoint returns JSON by default and XML with format=xml. See [API Documentation](https://currencyfreaks.com/documentation.md). - You chart or report rate movement: /timeseries returns daily rates between two dates and /fluctuation returns the change over the range, on the Professional plan ($99.99 a month) and above. See [API Documentation](https://currencyfreaks.com/documentation.md). - You price in the visitor's local currency: /iptocurrency maps an IPv4 or IPv6 address to its local currency and converts an amount into it, on the Growth plan and above. See [API Documentation](https://currencyfreaks.com/documentation.md). ## Quick start - Add the MCP server to Claude Code: `claude mcp add currencyfreaks --env CURRENCYFREAKS_API_KEY= -- npx -y @currencyfreaks/mcp` - MCP server source (MIT): https://github.com/CurrencyFreaks/currencyfreaks-mcp - Key-free endpoints: `https://api.currencyfreaks.com/v2.0/supported-currencies`, `/currency-symbols` and `/historical-data-limits` work without an API key. Every rate endpoint needs one. Every page on this site has a Markdown copy at the same URL with ".md" appended (the home page is /index.md). ## Product - [Home](https://currencyfreaks.com/index.md): Main landing page. One REST API for latest exchange rates, currency conversion, historical rates, time series and fluctuation across 166 fiat currencies, 873 cryptocurrencies and 4 precious metals. Free plan: 1,000 calls a month, daily refresh, no credit card. - [Pricing](https://currencyfreaks.com/pricing.md): Developer: free, 1,000 calls a month, 24-hour updates, USD base only. Starter: $9.99 a month, 15,000 calls, hourly updates. Growth: $49.99 a month, 150,000 calls, 10-minute updates. Professional: $99.99 a month, 550,000 calls, 60-second updates. Enterprise: custom. No daily or hourly rate limits on any plan. - [Sign Up](https://currencyfreaks.com/signup.md): Create a free account: 1,000 API calls a month, SSL on every request, no credit card. Sign in with Google or GitHub. Existing accounts log in at https://billing.currencyfreaks.com/login. - [FAQs](https://currencyfreaks.com/faqs.md): Plans and billing, payment methods, GDPR, data sources, update frequency, historical coverage from 1984-11-28, quota behaviour, base currency and output currency selection. ## Developer Docs - [API Documentation](https://currencyfreaks.com/documentation.md): Endpoint reference for https://api.currencyfreaks.com/v2.0: authentication with the apikey parameter, JSON and XML formats, /rates/latest, /convert/latest, /rates/historical, /timeseries, /fluctuation, /convert/historical, /iptocurrency, key-free /supported-currencies, /currency-symbols and /historical-data-limits, HTTP error codes and a Postman collection. - [Integrations](https://currencyfreaks.com/integrations.md): Guides for Python, JavaScript, Node.js, PHP, Go, Ruby, React, Vue.js, Svelte, Django, Claude, Cursor, VS Code, Windsurf, Cline, Codex, WordPress, Shopify, Google Sheets, Excel and Postman, with Java, C#, Swift, Kotlin, Angular, WooCommerce, Magento, Power BI, Airtable, Notion and Zapier marked coming soon. - [MCP Server](https://currencyfreaks.com/mcp-server.md): Official MCP server (`npx -y @currencyfreaks/mcp`, MIT, Node.js 18+). Seven tools: get_latest_rates, list_currencies, convert_currency, get_historical_rates, ip_to_currency, get_time_series, get_fluctuation. Setup for Claude Desktop, Claude Code, Cursor, Windsurf, VS Code, Cline and Codex CLI. - [Supported Currencies](https://currencyfreaks.com/supported-currencies.md): Full table of every currency the API returns: 166 fiat currencies, 873 cryptocurrencies and 4 precious metals (XAU, XAG, XPT, XPD), each with code, name, country and first available historical date, plus deprecated codes. ## Currency Reference - [Currency Abbreviations](https://currencyfreaks.com/currency-abbreviations.md): 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.md): 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.md): 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.md): 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.md): Fiat money, cryptocurrencies, commodity-backed currencies and digital money: how they differ, what ISO 4217 covers and where each supported currency fits. ## Blog - [Blog](https://currencyfreaks.com/blog.md): Integration tutorials, provider comparisons and how-to guides from the CurrencyFreaks team. Individual posts are listed below. ### Integration Tutorials - [Currency Converter API in Python: Tutorial with Full Code (2026)](https://currencyfreaks.com/blog/Python-Currency-Converter-API.md): 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.md): 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.md): 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.md): 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.md): 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.md): 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.md): 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.md): 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.md): 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.md): 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.md): 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.md): 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.md): 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.md): 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.md): 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.md): 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.md): 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.md): 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.md): 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.md): Endpoint mapping, auth changes and before-and-after code in Python, JavaScript and PHP to move from Fixer in under an hour. ### Provider Comparisons & Alternatives - [10 Best Currency Exchange APIs in 2026: Free & Paid Compared](https://currencyfreaks.com/blog/10-Best-Currency-Exchange-API.md): 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.md): 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.md): 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.md): 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.md): 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.md): 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.md): 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.md): 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.md): 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.md): 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.md): 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.md): 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.md): 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.md): 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.md): 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 & 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.md): 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.md): 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.md): 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.md): 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.md): 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.md): 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.md): 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.md): 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.md): 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.md): 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.md): 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.md): 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.md): 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.md): 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.md): 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.md): 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.md): 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.md): 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.md): 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.md): 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.md): 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.md): 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.md): 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.md): 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.md): 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.md): Multi-currency support in e-commerce: benefits of a forex API, real-life applications, how to build multi-currency checkout and its challenges. ## Company - [About Us](https://currencyfreaks.com/about-us.md): CurrencyFreaks is built by JFreaks Software Solutions in Lahore, Pakistan, which also runs ipgeolocation.io and WhoisFreaks. - [Contact](https://currencyfreaks.com/contact.md): Contact form for support, sales, suggestions and feedback about the CurrencyFreaks API. - [Privacy Policy](https://currencyfreaks.com/privacy.md): Privacy policy and data handling disclosures for CurrencyFreaks API customers. - [Terms of Service](https://currencyfreaks.com/tos.md): Terms of service and acceptable-use guidelines for the CurrencyFreaks API and its exchange rate data. ## Social & Status - [GitHub](https://github.com/CurrencyFreaks): MCP server source and developer resources. - [X](https://twitter.com/currencyfreaks): Official updates and announcements. - [Status page](https://status.currencyfreaks.com/): Live and historical API uptime. - [Trustpilot](https://www.trustpilot.com/review/currencyfreaks.com): Verified customer reviews. ## Optional - [Full reference](https://currencyfreaks.com/llms-full.txt): Platform overview, plans, every endpoint with parameters and responses, error codes, MCP server setup, integrations and all page links in one file