exchangerate-dev Indices API
The Indices API from exchangerate-dev — 2 operation(s) for indices.
The Indices API from exchangerate-dev — 2 operation(s) for indices.
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-indices-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 Indices 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: Indices
paths:
/v1/indices/{index_slug}:
get:
summary: Index Snapshot
operationId: index_snapshot_v1_indices__index_slug__get
parameters:
- name: index_slug
in: path
required: true
schema:
type: string
title: Index Slug
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/IndexSnapshotResponse'
'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:
- Indices
/v1/indices/{index_slug}/timeseries:
get:
summary: Index Timeseries
operationId: index_timeseries_v1_indices__index_slug__timeseries_get
parameters:
- name: index_slug
in: path
required: true
schema:
type: string
title: Index Slug
- name: interval
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Interval
- name: from
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: From
- name: to
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: To
- name: cursor
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Cursor
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/IndexTimeseriesResponse'
'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:
- Indices
components:
schemas:
MarketSession:
type: string
enum:
- open
- weekend
- interbank_closed
title: MarketSession
description: 'Computed from a clock, no feed (D9). `interbank_closed` = a known non-weekend closure
(e.g. an ECB/TARGET2 holiday detected via an empty Tier-C response — INGESTION §4).'
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.'
IndexTimeseriesRow:
properties:
timestamp:
type: string
title: Timestamp
value:
type: number
title: Value
data_updated_at:
type: string
title: Data Updated At
source:
$ref: '#/components/schemas/Source'
source_type:
type: string
enum:
- market
- reference
title: Source Type
market_session:
$ref: '#/components/schemas/MarketSession'
type: object
required:
- timestamp
- value
- data_updated_at
- source
- source_type
- market_session
title: IndexTimeseriesRow
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
IndexConstituent:
properties:
currency:
type: string
title: Currency
weight:
type: number
title: Weight
rate:
type: number
title: Rate
effective_at:
type: string
title: Effective At
contribution:
type: number
title: Contribution
type: object
required:
- currency
- weight
- rate
- effective_at
- contribution
title: IndexConstituent
IndexTimeseriesResponse:
properties:
result:
type: string
title: Result
default: success
index:
type: string
title: Index
name:
type: string
title: Name
methodology_version:
type: string
title: Methodology Version
interval:
type: string
enum:
- 1m
- 5m
- 15m
- 1h
- 4h
- 1d
title: Interval
from:
type: string
title: From
to:
type: string
title: To
base_date:
anyOf:
- type: string
- type: 'null'
title: Base Date
weights:
additionalProperties:
type: number
type: object
title: Weights
data:
items:
$ref: '#/components/schemas/IndexTimeseriesRow'
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:
- index
- name
- methodology_version
- interval
- from
- to
- base_date
- weights
- data
- notice
title: IndexTimeseriesResponse
IndexSnapshotResponse:
properties:
result:
type: string
title: Result
default: success
index:
type: string
title: Index
name:
type: string
title: Name
methodology_version:
type: string
title: Methodology Version
value:
type: number
title: Value
timestamp:
type: string
title: Timestamp
data_updated_at:
type: string
title: Data Updated At
source:
$ref: '#/components/schemas/Source'
source_type:
type: string
enum:
- market
- reference
title: Source Type
market_session:
$ref: '#/components/schemas/MarketSession'
stale:
type: boolean
title: Stale
base_date:
anyOf:
- type: string
- type: 'null'
title: Base Date
weights:
additionalProperties:
type: number
type: object
title: Weights
constituents:
items:
$ref: '#/components/schemas/IndexConstituent'
type: array
title: Constituents
notice:
type: string
title: Notice
type: object
required:
- index
- name
- methodology_version
- value
- timestamp
- data_updated_at
- source
- source_type
- market_session
- stale
- base_date
- weights
- constituents
- notice
title: IndexSnapshotResponse