Oanda Exchange Rates API Documentation: What Developers Need to Know (And a Simpler Alternative)

If you have ever searched for reliable foreign exchange data, you have almost certainly come across Oanda. The company has been a fixture in the FX industry since the late 1990s, and its Oanda exchange rates API documentation is one of the most referenced resources in the currency data space.

But here is the thing many developers discover only after spending hours reading through those docs: Oanda actually operates two distinct APIs, and the one you probably want is not the one you will find first. This guide breaks down what you need to know about navigating the Oanda exchange rates API documentation, what it costs, who it is designed for, and when a simpler alternative might be the better fit.

Understanding Oanda's Two APIs

This is the first point of confusion for most developers. Oanda maintains two separate API products that serve very different purposes.

The v20 Trading API

When you Google "Oanda API," the first result is typically the v20 REST API documentation for their trading platform. This API is designed for algorithmic traders who want to place orders, manage positions, and stream live bid/ask prices through an Oanda brokerage account.

Key characteristics of the v20 Trading API:

• Requires an Oanda trading account (practice or live)
• Provides bid/ask spreads, not mid-market rates
• Streams real-time pricing via WebSocket connections
• Includes order management, account info, and trade execution
• Free to use if you have a trading account

If you are building a trading bot, this is the right API. If you need exchange rate data for your application, it is not.

The Exchange Rates Data API

The second product, and the one most developers actually need, is the Oanda Exchange Rates Data API. This is a separate service with its own documentation, pricing, and access requirements. It provides mid-market exchange rates sourced from Oanda's proprietary data pipeline.

Key characteristics of the Exchange Rates Data API:

• Delivers mid-market rates (not trading spreads)
• Covers 200+ currencies including precious metals
• Provides historical data going back to 1990
• Offers daily and intra-day rates
• Requires a separate subscription, independent of any trading account

Navigating the Documentation Structure

The Pricing Question

This is where many developers hit a wall. Oanda does not publish pricing for their Exchange Rates Data API.

What Oanda Does Well

Data lineage and auditability. Oanda has been collecting FX data for over two decades. Their rates are trusted by tax authorities, accounting firms, and central banks.

Granular historical data. Access to intra-day historical rates going back years is valuable for backtesting, research, and compliance.

Customizable decimal precision. For financial applications that need rates to six or more decimal places.

Institutional support. Dedicated account managers, SLAs, and custom data delivery formats.

Where Developers Run Into Friction

No self-service access. You cannot sign up, get an API key, and start making requests.

Opaque pricing. Without knowing the cost, it is difficult to include in project budgets.

Complex authentication. The API uses a custom authentication scheme rather than standard Bearer token authentication.

Two-API confusion. New developers frequently spend time reading the v20 trading API docs before realizing they need the separate Exchange Rates product.

Exchange Rate API: A Developer-First Alternative

If you need reliable exchange rate data without the enterprise procurement process, Exchange Rate API is built specifically for development teams that want to move fast.

Getting Started in Under 5 Minutes

Step 1: Sign up at exchange-rateapi.com and get your API key.

Step 2: Make your first request:

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://exchange-rateapi.com/api/v1/rates?source=USD"

Step 3: That is it. You get back rates for 160+ currencies, updated every 60 seconds.

Need a direct conversion?

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://exchange-rateapi.com/api/v1/convert?from=USD&to=EUR&amount=100"

When to Choose Oanda vs. Exchange Rate API

Choose Oanda if:

• You need rates that are specifically accepted by tax authorities or auditors who require Oanda as a source
• You need intra-day historical data going back decades
• You have an enterprise budget and procurement process in place
• You are already an Oanda trading client

Choose Exchange Rate API if:

• You need an API key today, not next quarter
• You want transparent, published pricing you can include in your budget
• You are building an e-commerce store, SaaS product, or mobile app that needs reliable rates
• You want 60-second update frequency without enterprise pricing
• You prefer standard REST conventions and Bearer token auth
• You need a free tier for development and testing

Making the Switch

If you have already integrated with Oanda and are considering a switch, the migration is straightforward:

Conclusion

The Oanda exchange rates API documentation reflects a mature, enterprise-grade product built for institutional clients. If that is your profile, Oanda remains a strong choice.

But if you are a developer who wants to start building now, with clear pricing, instant access, and a modern REST API, Exchange Rate API was designed for exactly that workflow.

Sign up for free at exchange-rateapi.com and make your first API call in under five minutes. The free tier includes 1,500 requests per month.

Need help choosing the right plan or integrating Exchange Rate API into your project? Check out the developer documentation or explore pricing options.

npm install @exchangerateapi/sdk