Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

ExchangeRate-API Exchange Rates API

Real-time and historical currency exchange rate endpoints

ExchangeRate-API Exchange Rates API is one of 3 APIs that ExchangeRate-API publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

This API exposes 1 JSON Schema definition.

Tagged areas include Exchange Rates. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, authentication docs, pricing, rate-limit docs, and 1 JSON Schema.

This API exposes 5 operations across 5 paths, and defines 10 schemas. It is described by OpenAPI 3.0.3, at version 6.

Requests are made against 2 base URLs: https://v6.exchangerate-api.com/v6, https://v6.exchangerate-api.com/v6.

5 operations 5 paths 10 schemas 5 GET

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.3
API Version
6
Base URL
https://v6.exchangerate-api.com/v6
Authentication
HTTP Bearer
Terms of Service
Resource Areas
1

Authentication & Security 1

ExchangeRate-API Exchange Rates API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (BearerAuth). By default, every request must be authenticated.

  • BearerAuth — Pass API key as a Bearer token in the Authorization header (e.g. Authorization: Bearer YOUR-API-KEY). When using this method, omit the API key from the URL pat…

Paths & Operations 5

Across 5 paths, the API surfaces 5 operations — 5 GET. Each is listed below with its method, path, parameters, and response codes.

Exchange Rates 5

Real-time and historical currency exchange rate endpoints

GET
/{apiKey}/latest/{baseCurrency}
Get latest exchange rates
getLatestRates 2 params → 200400403404
GET
/latest/{baseCurrency}
Get latest exchange rates (Bearer token auth)
getLatestRatesBearer 1 param → 200403404
GET
/{apiKey}/pair/{baseCurrency}/{targetCurrency}
Get conversion rate for a currency pair
getPairRate 3 params → 200403404
GET
/{apiKey}/pair/{baseCurrency}/{targetCurrency}/{amount}
Convert an amount between a currency pair
getPairConversion 4 params → 200403404
GET
/{apiKey}/history/{baseCurrency}/{year}/{month}/{day}
Get historical exchange rates for a specific date
getHistoricalRates 5 params → 200403404

Schemas 10

The contract defines 10 schemas that model the data the API accepts and returns. The most detailed are TimestampFields (4 properties), BaseMetadata (3 properties), ErrorResponse (2 properties). Each schema is shown below with its type and property counts.

LatestRatesResponse
TimestampFields
object
Update timestamp fields included in rate responses
4 properties
PairConversionResponse
ErrorResponse
object
2 properties 2 required
BaseMetadata
object
Common metadata fields returned in all successful responses
3 properties
ResultError
string
Indicates the request failed
HistoricalRatesResponse
PairRateResponse
ConversionRates
object
Object mapping ISO 4217 currency codes to their exchange rate values relative to the base currency
ResultSuccess
string
Indicates the request was successful

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

exchangerate-exchange-rates-api-openapi.yml Raw ↑

Other APIs ExchangeRate-API publishes across the network.

ExchangeRate-API Account API
ExchangeRate-API Currencies API