allratestoday-com Reference Rate API
The Reference Rate API from allratestoday-com — 4 operation(s) for reference rate.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
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.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/allratestoday-com:allratestoday-com-reference-rate-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API 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 Specification
openapi: 3.2.0
info:
title: AllRatesToday Exchange Rate & Central Bank Rates Reference…
description: 'Live mid-market exchange rates for 160+ currencies plus official rates from 122 central banks and 4 tax authorities (ECB, the Fed, Bank of Canada, CBSL, Banxico, HMRC, US Treasury and more).
## Data
- **Market rates** (`/api/rate`, `/api/v1/rates`, `/api/historical-rates`): live mid-market rates, refreshed roughly every 60 seconds.
- **Central-bank rates** (`/api/v1/central-bank/*`, `/api/open/central-bank/*`): the official tables exactly as published by each institution, one table per publication date. History reaches back to 2000 and earlier for major sources (ECB from 1999, Bank of Canada from 1950s-era series where published).
- **Daily Reference Rate** (`/api/open/reference-rate`, `/api/v1/reference-rate/*`): one immutable mid-market USD table per business day, fixed at 16:00 London (median of a five-minute sampling window). For index calculation, research and reporting; not a registered benchmark. Methodology: https://allratestoday.com/reference-rate/
## Authentication
Most endpoints require an API key sent as `Authorization: Bearer art_live_...`. Get a free key at https://allratestoday.com/register, or self-issue a 100-call trial key with no account via `POST /api/agent/keys` (built for AI agents). Logged-in dashboard users can also authenticate with their session cookie.
Keyless endpoints: `/api/v1/symbols` and `/api/open/central-bank/{bank}` (attribution required), plus JSON reads of `/api/public/central-bank/{bank}`.
## Output formats
Endpoints that return tabular data accept `?format=json|csv|xml|xlsx` (CSV is UTF-8 with BOM; XLSX is a real Excel workbook; default json).
## Plans
Free plan: latest central-bank tables included. Historical central-bank dates and time series require a paid plan. See https://allratestoday.com/pricing.'
version: 2.2.0
contact:
name: AllRatesToday Support
url: https://allratestoday.com
email: support@allratestoday.com
servers:
- url: https://allratestoday.com
description: Production
tags:
- name: Reference Rate
paths:
/api/open/reference-rate:
get:
tags:
- Reference Rate
operationId: getOpenReferenceRate
summary: Latest Daily Reference Rate (16:00 London) — keyless
description: 'AllRatesToday Daily Reference Rate: one immutable mid-market USD table per business day, fixed at 16:00 Europe/London as the per-currency median of five once-a-minute samples (15:57:30–16:02:30). Never revised. Not the WM/Refinitiv fix and not a registered benchmark; for index calculation, research and reporting. Methodology: https://allratestoday.com/reference-rate/ Keyless with attribution; dated tables and history need a key.'
parameters:
- name: source
in: query
schema:
type: string
example: SAR
description: 'With target: one pair, cross-computed via USD and flagged derived.'
- name: target
in: query
schema:
type: string
example: USD
- name: format
in: query
schema:
type: string
enum:
- json
- csv
- xml
- xlsx
description: Output format (default json).
responses:
'200':
description: Latest table or one pair
content:
application/json:
schema:
type: object
properties:
rate_date:
type: string
format: date
time:
type: string
example: 16:00 London
base:
type: string
example: USD
window_start:
type: string
format: date-time
window_end:
type: string
format: date-time
samples:
type: integer
published_at:
type: string
format: date-time
method:
type: string
rates:
type: array
items:
type: object
properties:
base:
type: string
quote:
type: string
value:
type: number
low:
type: number
high:
type: number
samples:
type: integer
attribution:
type: object
disclaimer:
type: string
'404':
description: Not published yet (next_publication says when)
/api/v1/reference-rate/latest:
get:
tags:
- Reference Rate
operationId: getReferenceRateLatest
summary: Latest Daily Reference Rate with window low/high and sample counts
description: 'AllRatesToday Daily Reference Rate: one immutable mid-market USD table per business day, fixed at 16:00 Europe/London as the per-currency median of five once-a-minute samples (15:57:30–16:02:30). Never revised. Not the WM/Refinitiv fix and not a registered benchmark; for index calculation, research and reporting. Methodology: https://allratestoday.com/reference-rate/ Any plan.'
security:
- bearerAuth: []
parameters:
- name: symbols
in: query
schema:
type: string
example: EUR,GBP,SAR
description: Comma-separated quote currencies to keep.
- name: source
in: query
schema:
type: string
example: SAR
description: 'With target: one pair, cross-computed via USD and flagged derived.'
- name: target
in: query
schema:
type: string
example: USD
- name: format
in: query
schema:
type: string
enum:
- json
- csv
- xml
- xlsx
description: Output format (default json).
responses:
'200':
description: Latest table
content:
application/json:
schema:
type: object
properties:
rate_date:
type: string
format: date
time:
type: string
example: 16:00 London
base:
type: string
example: USD
window_start:
type: string
format: date-time
window_end:
type: string
format: date-time
samples:
type: integer
published_at:
type: string
format: date-time
method:
type: string
rates:
type: array
items:
type: object
properties:
base:
type: string
quote:
type: string
value:
type: number
low:
type: number
high:
type: number
samples:
type: integer
attribution:
type: object
disclaimer:
type: string
'401':
description: Missing or invalid API key
'404':
description: Not published yet
/api/v1/reference-rate/{date}:
get:
tags:
- Reference Rate
operationId: getReferenceRateByDate
summary: Daily Reference Rate table for a date — paid plans
description: 'AllRatesToday Daily Reference Rate: one immutable mid-market USD table per business day, fixed at 16:00 Europe/London as the per-currency median of five once-a-minute samples (15:57:30–16:02:30). Never revised. Not the WM/Refinitiv fix and not a registered benchmark; for index calculation, research and reporting. Methodology: https://allratestoday.com/reference-rate/ Weekends/holidays return the previous business day (rate_date says which).'
security:
- bearerAuth: []
parameters:
- name: date
in: path
required: true
schema:
type: string
format: date
- name: symbols
in: query
schema:
type: string
example: EUR,GBP,SAR
description: Comma-separated quote currencies to keep.
- name: source
in: query
schema:
type: string
example: SAR
description: 'With target: one pair, cross-computed via USD and flagged derived.'
- name: target
in: query
schema:
type: string
example: USD
- name: format
in: query
schema:
type: string
enum:
- json
- csv
- xml
- xlsx
description: Output format (default json).
responses:
'200':
description: Table
content:
application/json:
schema:
type: object
properties:
rate_date:
type: string
format: date
time:
type: string
example: 16:00 London
base:
type: string
example: USD
window_start:
type: string
format: date-time
window_end:
type: string
format: date-time
samples:
type: integer
published_at:
type: string
format: date-time
method:
type: string
rates:
type: array
items:
type: object
properties:
base:
type: string
quote:
type: string
value:
type: number
low:
type: number
high:
type: number
samples:
type: integer
attribution:
type: object
disclaimer:
type: string
'403':
description: Paid plan required
'404':
description: No table on or before the date
/api/v1/reference-rate/history:
get:
tags:
- Reference Rate
operationId: getReferenceRateHistory
summary: Daily Reference Rate series — paid plans, billed per month of range
description: 'AllRatesToday Daily Reference Rate: one immutable mid-market USD table per business day, fixed at 16:00 Europe/London as the per-currency median of five once-a-minute samples (15:57:30–16:02:30). Never revised. Not the WM/Refinitiv fix and not a registered benchmark; for index calculation, research and reporting. Methodology: https://allratestoday.com/reference-rate/ One point per published business day. Billed one API call per month of range.'
security:
- bearerAuth: []
parameters:
- name: symbol
in: query
schema:
type: string
example: EGP
description: Quote currency per 1 USD (or give source+target).
- name: source
in: query
schema:
type: string
example: SAR
description: 'With target: one pair, cross-computed via USD and flagged derived.'
- name: target
in: query
schema:
type: string
example: USD
- name: from
in: query
schema:
type: string
format: date
- name: to
in: query
schema:
type: string
format: date
- name: format
in: query
schema:
type: string
enum:
- json
- csv
- xml
- xlsx
description: Output format (default json).
responses:
'200':
description: Series
content:
application/json:
schema:
type: object
properties:
base:
type: string
quote:
type: string
from:
type: string
to:
type: string
count:
type: integer
points:
type: array
items:
type: object
properties:
rate_date:
type: string
format: date
value:
type: number
'403':
description: Paid plan required
components:
securitySchemes:
bearerAuth:
type: http
scheme: bearer
description: 'API key from your AllRatesToday dashboard. Example: `Authorization: Bearer art_live_xxxxx`. Free keys at https://allratestoday.com/register. Agents without an account: `POST /api/agent/keys` issues a 100-call trial key instantly.'
apiKeyQuery:
type: apiKey
in: query
name: key
description: API key as a query parameter (accepted on /api/rate only; `apiKey` is an alias)
sessionCookie:
type: apiKey
in: cookie
name: art_session
description: Session cookie for logged-in dashboard users