exchangerate-dev Range API
The Range API from exchangerate-dev — 1 operation(s) for range.
The Range API from exchangerate-dev — 1 operation(s) for range.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/exchangerate-dev:exchangerate-dev-range-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: exchangerate.dev Range API
description: 'Live indicative foreign-exchange rates for developers. Explicit `source` and `market_session` labels on every response — live intraday (~60s) on trading days for all currencies, with ECB daily fallback in the 144-currency catalog (10296 unique pairs). Free tier: 5,000 calls/month, no card. Live rates 15 minutes delayed. MCP server: https://api.exchangerate.dev/v1/mcp/ · Docs: https://exchangerate.dev/docs'
contact:
url: https://exchangerate.dev/docs
version: '1.0'
tags:
- name: Range
paths:
/v1/range:
get:
summary: Range Endpoint
operationId: range_endpoint_v1_range_get
parameters:
- name: symbols
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Symbols
- name: start_date
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Start Date
- name: end_date
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: End Date
- name: base
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Base
- name: cursor
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Cursor
- name: format
in: query
required: false
schema:
enum:
- json
- csv
- parquet
type: string
default: json
title: Format
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/RangeResponse'
text/csv: {}
application/vnd.apache.parquet: {}
'400':
description: Bad request. Codes include invalid_pair, unsupported_base, bad_date, invalid_amount, invalid_request, missing_parameter, unsupported_interval, unsupported_pair_interval and unsupported_index_interval.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'401':
description: 'Authentication failed: invalid_api_key (or invalid_session_token on dashboard routes).'
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'403':
description: 'plan_gated: the caller''s plan does not include this interval or history depth; forbidden: the request did not pass through the public origin.'
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'404':
description: Not found, e.g. unknown_index or no_data_for_date.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'422':
description: Request validation failed.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'429':
description: 'Rate limit or quota exceeded: rate_limited (per-minute limit, X-RateLimit-Scope tier-rate-minute), ip_rate_limited (keyless per-IP hourly cap, anon-ip-hour) or quota_exceeded (monthly quota, tier-quota-month). Wait Retry-After seconds; do not retry a monthly quota error automatically. quota_unavailable means the quota store could not be read; retry after Retry-After.'
headers:
X-RateLimit-Limit:
description: Limit for the window named by X-RateLimit-Scope.
schema:
type: integer
X-RateLimit-Remaining:
description: Requests left in that window (0 on a 429).
schema:
type: integer
X-RateLimit-Reset:
description: Unix time (seconds) when the window resets.
schema:
type: integer
X-RateLimit-Scope:
description: 'Which limit applied: anon-ip-hour, tier-rate-minute or tier-quota-month.'
schema:
type: string
Retry-After:
description: Seconds to wait before retrying.
schema:
type: integer
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'500':
description: The operation failed internally.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'503':
description: A required data source or feature is temporarily unavailable, e.g. data_unavailable, live_unavailable, source_unavailable or service_unavailable.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
tags:
- Range
components:
schemas:
ErrorResponse:
properties:
result:
type: string
title: Result
default: error
code:
type: string
title: Code
message:
type: string
title: Message
type: object
required:
- code
- message
title: ErrorResponse
Source:
type: string
enum:
- live
- ecb_daily
- market_daily
title: Source
description: 'Public `source` enum — wire contract (D2). NO `cached` value (cache lives in X-Cache).
`ecb_daily` is the only reference source (October 2026).
`market_daily` labels the stored daily close of the live market feed, for the currencies with
no reference fix, in date history and 1d time series; it is never a live rate.'
RangeResponse:
properties:
result:
type: string
title: Result
default: success
base:
type: string
title: Base
start_date:
type: string
title: Start Date
end_date:
type: string
title: End Date
data:
items:
$ref: '#/components/schemas/RangeRow'
type: array
title: Data
next_cursor:
anyOf:
- type: string
- type: 'null'
title: Next Cursor
has_more:
type: boolean
title: Has More
default: false
notice:
type: string
title: Notice
type: object
required:
- base
- start_date
- end_date
- data
- notice
title: RangeResponse
RangeRow:
properties:
date:
type: string
title: Date
rates:
additionalProperties:
type: number
type: object
title: Rates
source:
$ref: '#/components/schemas/Source'
is_forward_filled:
type: boolean
title: Is Forward Filled
derived_symbols:
items:
type: string
type: array
title: Derived Symbols
type: object
required:
- date
- rates
- source
- is_forward_filled
- derived_symbols
title: RangeRow