Documentation
Documentation
https://www.fastforex.io/docs
RateLimits
https://raw.githubusercontent.com/api-evangelist/fastforex/refs/heads/main/rate-limits/fastforex-rate-limits.yml
OpenAPI Specification
openapi: 3.0.3
info:
title: fastFOREX.io admin plan-premium API
version: 2.3.2
description: Foreign & cryptocurrency exchange rate API
termsOfService: https://www.fastforex.io/terms-of-sale
contact:
email: support@fastforex.io
license:
name: Apache 2.0
url: https://www.apache.org/licenses/LICENSE-2.0.html
servers:
- url: https://api.fastforex.io
description: Production
- url: https://api.beta.fastforex.io
description: Beta
security:
- api_key: []
- apiKeyHeader: []
- bearerAuth: []
- basicAuth: []
tags:
- name: plan-premium
description: Available on The Premium Plan
paths:
/fetch-one:
get:
tags:
- plan-premium
description: Fetch a single currency exchange rate, from and to any supported physical or digital currency. Midpoint spot rate.
parameters:
- name: from
in: query
description: Base currency symbol (physical or digital), defaults to USD
required: false
allowEmptyValue: true
schema:
$ref: '#/components/schemas/AnyCurrency'
- name: to
in: query
description: Target currency symbol (physical or digital), defaults to USD
required: true
schema:
$ref: '#/components/schemas/AnyCurrency'
responses:
'200':
description: Success
content:
application/json:
schema:
type: object
properties:
base:
$ref: '#/components/schemas/AnyCurrency'
updated:
$ref: '#/components/schemas/DateTimes'
ms:
$ref: '#/components/schemas/ResponseTime'
result:
type: object
minProperties: 1
maxProperties: 1
additionalProperties:
type: number
format: float
example:
base: USD
result:
EUR: 0.82791
updated: '2021-01-16T16:34:29Z'
ms: 4
'400':
description: Bad Request
'401':
description: Not Authorized
'403':
description: Forbidden
'429':
description: Rate limit exceeded
/fetch-multi:
get:
tags:
- plan-premium
description: Fetch multiple target exchange rates from a single source currency. Midpoint spot rates.
parameters:
- name: from
in: query
description: Base currency 3-letter symbol, defaults to USD
required: false
allowEmptyValue: true
schema:
$ref: '#/components/schemas/Currency'
- name: to
in: query
description: Target currencies, comma separated list of 3-letter symbols
required: true
schema:
$ref: '#/components/schemas/CurrencyList'
responses:
'200':
description: Success
content:
application/json:
schema:
type: object
properties:
base:
$ref: '#/components/schemas/Currency'
updated:
$ref: '#/components/schemas/DateTimes'
ms:
$ref: '#/components/schemas/ResponseTime'
results:
type: object
minProperties: 1
additionalProperties:
type: number
format: float
example:
base: USD
results:
EUR: 0.82791
GBP: 0.73605
updated: '2021-01-16T16:34:29Z'
ms: 8
'400':
description: Bad Request
'401':
description: Not Authorized
'403':
description: Forbidden
'429':
description: Rate limit exceeded
/fetch-all:
get:
tags:
- plan-premium
description: Fetch all available currency rates for the supplied source currency. Midpoint spot rates.
parameters:
- name: from
in: query
description: Base currency 3-letter symbol, defaults to USD
required: false
allowEmptyValue: true
schema:
$ref: '#/components/schemas/Currency'
responses:
'200':
description: Success
content:
application/json:
schema:
type: object
properties:
base:
$ref: '#/components/schemas/Currency'
updated:
$ref: '#/components/schemas/DateTimes'
ms:
$ref: '#/components/schemas/ResponseTime'
results:
type: object
minProperties: 130
additionalProperties:
type: number
format: float
example:
base: USD
results:
AED: 3.673
AFN: 72.5642
ALL: 88.59
AMD: 391.07
ANG: 1.788
AOA: 912
ARS: 1074.69
AUD: 1.5892
AWG: 1.81
AZN: 1.7
BAM: 1.7217
BBD: 2
BDT: 121.81
BGN: 1.7219
BHD: 0.37708
BIF: 2923.15
BMD: 1
BND: 1.3194
BOB: 6.94
BRL: 5.8742
BRX: 5.8734
BSD: 1.003
BWP: 14.0056
BYN: 3.28
BZD: 2.0178
CAD: 1.38642
CDF: 2859.46
CHF: 0.81519
CLF: 0.02495
CLP: 971.76
CNH: 7.28156
CNY: 7.2916
COP: 4277.27
COU: 10.6753
CRC: 508.43
CUP: 24
CVE: 96.88
CZK: 22.1127
DJF: 177.405
DKK: 6.57264
DOP: 61.33
DZD: 131.969
EGP: 51.3229
ERN: 15.15
ETB: 130.47
EUR: 0.8799
FJD: 2.283
FKP: 0.7659
GBP: 0.76423
GEL: 2.7573
GHS: 15.4527
GIP: 0.7659
GMD: 72
GNF: 8664
GTQ: 7.709
GYD: 210.19
HKD: 7.7537
HNL: 25.7132
HTG: 132.88
HUF: 360.62
HUX: 370.54
IDR: 16794
ILS: 3.704
INR: 86.118
IQD: 1310
IRR: 42003
ISK: 127.9
JMD: 157.71
JOD: 0.709
JPY: 143.525
KES: 129.78
KGS: 87.45
KHR: 4000
KMF: 454.5
KPW: 900
KRW: 1421.365
KWD: 0.307
KYD: 0.82
KZT: 518.06
LAK: 21557
LBP: 89600
LKR: 298.1
LRD: 199.926
LSL: 19.37
LYD: 5.5571
MAD: 9.3176
MDL: 17.7
MGA: 4655
MKD: 54.257
MMK: 2098.68
MNT: 3537.2
MOP: 7.9863
MRU: 39.9
MUR: 43.7
MVR: 15.46
MWK: 1733.673
MXN: 20.321
MXV: 2.42005
MYR: 4.423
MZN: 63.56
NAD: 19.1599
NGN: 1597.115
NIO: 36.6243
NOK: 10.65512
NPR: 137.673
NZD: 1.7164
OMR: 0.3851
PAB: 1
PEN: 3.7286
PGK: 4.1144
PHP: 57.241
PKR: 280.34
PLN: 3.7742
PYG: 8027.64
QAR: 3.641
RON: 4.38927
RSD: 103.229
RUB: 83.3
RWF: 1410.28
SAR: 3.7542
SBD: 8.3542
SCR: 14.8351
SDG: 598.993
SEK: 9.77129
SGD: 1.31896
SHP: 0.7659
SLL: 22663.6
SOS: 566.75
SRD: 36.72
SSP: 4471.077
STN: 21.6
SVC: 8.75
SYP: 13002
SZL: 19.1043
THB: 33.515
TJS: 10.894
TMT: 3.5
TND: 2.9815
TOP: 2.401
TRY: 38.0582
TTD: 6.8191
TWD: 32.409
TZS: 2660
UAH: 41.5281
UGX: 3675.3
UYU: 42.984
UZS: 12980.33
VES: 77.0767
VND: 25720
VUV: 122.93
WST: 2.6969
XAF: 577.42
XCD: 2.7
XDR: 0.73954
XOF: 577.42
XPF: 104.95
YER: 245.27
ZAR: 19.1345
ZMW: 28.3
updated: '2025-04-11T23:59:53Z'
ms: 77
'400':
description: Bad Request
'401':
description: Not Authorized
'403':
description: Forbidden
'429':
description: Rate limit exceeded
/fetch-many-to-one:
get:
tags:
- plan-premium
description: Fetch a set of many source currency rates to a single target currency (inverse of /fetch-multi). Midpoint spot rates. Costs one API call per pair returned.
parameters:
- name: from
in: query
description: Source currencies, comma separated list of 3-letter symbols
required: true
schema:
$ref: '#/components/schemas/CurrencyList'
- name: to
in: query
description: Target currency 3-letter symbol, defaults to USD
required: true
schema:
$ref: '#/components/schemas/Currency'
responses:
'200':
description: Success
content:
application/json:
schema:
type: object
properties:
to:
$ref: '#/components/schemas/Currency'
updated:
$ref: '#/components/schemas/DateTimes'
calls:
$ref: '#/components/schemas/ApiUsage'
ms:
$ref: '#/components/schemas/ResponseTime'
from:
type: object
minProperties: 1
additionalProperties:
type: number
format: float
example:
to: USD
from:
JPY: 0.00679,
CHF: 1.2539,
ZAR: 0.0578,
AUD: 0.65962,
AED: 0.27229,
updated: '2025-10-03T16:34:29Z'
calls: 5
ms: 12
'400':
description: Bad Request
'401':
description: Not Authorized
'403':
description: Forbidden
'429':
description: Rate limit exceeded
/fetch-matrix:
get:
tags:
- plan-premium
description: Fetch a matrix of multiple from/to currency pairs. Midpoint spot rates. Costs one API call per pair returned.
parameters:
- name: from
in: query
description: Source currencies, comma separated list of 3-letter symbols
required: true
schema:
$ref: '#/components/schemas/CurrencyList'
- name: to
in: query
description: Target currencies, comma separated list of 3-letter symbols
required: true
schema:
$ref: '#/components/schemas/CurrencyList'
responses:
'200':
description: Success
content:
application/json:
schema:
type: object
properties:
from:
type: array
items:
$ref: '#/components/schemas/Currency'
to:
type: array
items:
$ref: '#/components/schemas/Currency'
matrix:
type: object
minProperties: 1
additionalProperties:
type: object
minProperties: 1
additionalProperties:
type: number
format: float
updated:
$ref: '#/components/schemas/DateTimes'
calls:
$ref: '#/components/schemas/ApiUsage'
ms:
$ref: '#/components/schemas/ResponseTime'
example:
from:
- USD
- CHF
- ZAR
- AED
to:
- USD
- GBP
- JPY
- CNY
matrix:
USD:
GBP: 0.74196
JPY: 147.488
CNY: 7.119
USD: 1
CHF:
USD: 1.2573
GBP: 0.93291
JPY: 185.444
CNY: 8.9504
ZAR:
USD: 0.0581
GBP: 0.04308
JPY: 8.56229
CNY: 0.41342
AED:
USD: 0.27223
GBP: 0.20196
JPY: 40.1552
CNY: 1.938
updated: '2025-10-03T16:52:05Z'
calls: 16
ms: 8
'400':
description: Bad Request
'401':
description: Not Authorized
'403':
description: Forbidden
'429':
description: Rate limit exceeded
/convert:
get:
tags:
- plan-premium
description: Convert an amount of one currency into another currency (supports physical and digital currencies)
parameters:
- name: from
in: query
description: Base currency symbol (physical or digital)
required: false
allowEmptyValue: true
schema:
$ref: '#/components/schemas/AnyCurrency'
- name: to
in: query
description: Target currency symbol (physical or digital)
required: true
schema:
$ref: '#/components/schemas/AnyCurrency'
- name: amount
in: query
description: Amount of source currency to convert
required: true
schema:
type: number
format: float
minimum: 0.01
- name: precision
in: query
description: Rounding precision for converted amount, defaults to 2 decimal places
required: false
schema:
type: integer
minimum: 0
maximum: 20
responses:
'200':
description: Success
content:
application/json:
schema:
type: object
properties:
base:
$ref: '#/components/schemas/AnyCurrency'
ms:
$ref: '#/components/schemas/ResponseTime'
amount:
type: number
format: float
result:
type: object
minProperties: 2
maxProperties: 2
properties:
rate:
type: number
format: float
additionalProperties:
type: number
format: float
example:
base: USD
amount: 199.5
result:
EUR: 164.29
rate: 0.82353
ms: 7
'400':
description: Bad Request
'401':
description: Not Authorized
'403':
description: Forbidden
'429':
description: Rate limit exceeded
/historical:
get:
tags:
- plan-premium
description: Fetch midpoint currency exchange rates for a date in the past
parameters:
- name: date
in: query
description: UTC date in YYYY-MM-DD format. As far back as Jan 1970, depending on the currency pair.
required: true
schema:
$ref: '#/components/schemas/Date'
- name: from
in: query
description: Base currency 3-letter symbol, defaults to USD
required: false
allowEmptyValue: true
schema:
$ref: '#/components/schemas/Currency'
- name: to
in: query
description: Target currencies, comma separated list of 3-letter symbols. Defaults to all currencies if omitted
required: false
allowEmptyValue: true
schema:
$ref: '#/components/schemas/CurrencyList'
responses:
'200':
description: Success
content:
application/json:
schema:
type: object
properties:
base:
$ref: '#/components/schemas/Currency'
date:
$ref: '#/components/schemas/Date'
ms:
$ref: '#/components/schemas/ResponseTime'
results:
type: object
minProperties: 130
additionalProperties:
type: number
format: float
example:
date: '2021-01-16'
base: USD
results:
AED: 3.67297
AFN: 77.11468
ALL: 101.78125
AMD: 523.67143
ANG: 1.78691
AOA: 653.45356
ARS: 85.74709
AUD: 1.29806
AWG: 1.79943
AZN: 1.70727
BAM: 1.62182
BBD: 1.99941
BDT: 84.84175
BGN: 1.61063
BHD: 0.37612
BIF: 1943.32401
BMD: 0.99926
BND: 1.32953
BOB: 6.88532
BRL: 5.29479
BSD: 1.00177
BTN: 73.22317
BWP: 10.98351
BZD: 2.01472
CAD: 1.27357
CDF: 1977.04254
CHF: 0.8912
CLF: 0.02491
CLP: 734.84469
CNH: 6.47453
CNY: 6.48079
COP: 3461.79891
CUP: 24.99558
CVE: 90.9024
CZK: 21.65759
DJF: 177.94053
DKK: 6.15612
DOP: 58.27175
DZD: 133.63021
EGP: 15.64449
ERN: 15.1347
ETB: 39.35227
EUR: 0.82791
FJD: 2.05329
FKP: 0.73605
GBP: 0.73605
GEL: 3.30208
GHS: 5.78235
GIP: 0.73605
GMD: 51.76064
GNF: 10080.74488
GTQ: 7.78301
GYD: 210.42985
HKD: 7.75357
HNL: 24.12042
HRK: 6.19682
HTG: 75.90461
HUF: 298.21139
IDR: 14054.17341
ILS: 3.2719
INR: 73.16164
IQD: 1458.41307
IRR: 42031.79744
ISK: 129.4936
JMD: 144.24702
JOD: 0.70779
JPY: 103.87016
KES: 109.70116
KGS: 75.50493
KHR: 4047.84337
KMF: 406.08715
KPW: 900.13249
KRW: 1102.13455
KWD: 0.30318
KYD: 0.81923
KZT: 418.85765
LAK: 9308.2585
LBP: 1509.38466
LKR: 194.62682
LRD: 167.93022
LSL: 15.21787
LYD: 4.45341
MAD: 8.91064
MDL: 17.18902
MGA: 3762.10805
MKD: 51.00986
MMK: 1331.8784
MNT: 2853.84955
MOP: 8.01634
MRU: 36.41764
MUR: 39.84837
MVR: 15.66392
MWK: 773.70087
MXN: 19.79604
MYR: 4.03732
MZN: 74.77698
NAD: 15.18769
NGN: 380.3327
NOK: 8.56904
NPR: 117.3193
NZD: 1.40232
OMR: 0.38422
PAB: 0.99926
PEN: 3.60165
PGK: 3.52819
PHP: 48.06492
PKR: 160.16046
PLN: 3.7535
PYG: 6890.343
QAR: 3.64022
RON: 4.02672
RSD: 96.9947
RUB: 73.59569
RWF: 972.40542
SAR: 3.74834
SCR: 21.7415
SDG: 55.12079
SEK: 8.39445
SGD: 1.33084
SHP: 0.73605
SLL: 10117.25305
SOS: 585.66171
SRD: 14.0817
SYP: 1257.58133
SZL: 15.23848
THB: 30.10158
TJS: 11.37737
TMT: 3.49448
TND: 2.7086
TOP: 2.27536
TRY: 7.45083
TTD: 6.74407
TWD: 28.03621
TZS: 2317.83454
UAH: 28.17938
UGX: 3704.99043
USD: 1
UYU: 42.4356
UZS: 10493.30193
VND: 23216.10481
VUV: 107.05138
WST: 2.54085
XAF: 542.97807
XCD: 2.69954
XDR: 0.69699
XOF: 542.97807
XPF: 98.70455
YER: 246.27558
ZAR: 15.20595
ZMW: 21.37472
ms: 13
'400':
description: Bad Request
'401':
description: Not Authorized
'403':
description: Forbidden
'404':
description: Not Found - We do not have historical rates for the requested date and currency pair
'429':
description: Rate limit exceeded
/time-series:
get:
tags:
- plan-premium
description: Fetch a time-series dataset of daily currency exchange rates for the specified interval (only daily supported currently). See our FX quote & OHLC time-series endpoints for more granular data.
parameters:
- name: from
in: query
description: Base currency 3-letter symbol, defaults to USD
required: false
allowEmptyValue: true
schema:
$ref: '#/components/schemas/Currency'
- name: to
in: query
description: Target currency 3-letter symbol
required: true
schema:
$ref: '#/components/schemas/Currency'
- name: start
in: query
description: UTC start date in YYYY-MM-DD format. As far back as Jan 1970, depending on the currency pair.
required: true
schema:
$ref: '#/components/schemas/Date'
- name: end
in: query
description: UTC end date in YYYY-MM-DD format. As far back as Jan 1970, depending on the currency pair.
required: true
schema:
$ref: '#/components/schemas/Date'
- name: interval
in: query
description: ISO8601 duration, such as P1D (daily). Defaults to P1D. Currently only supports daily.
required: false
schema:
$ref: '#/components/schemas/Duration'
responses:
'200':
description: Success
content:
application/json:
schema:
type: object
properties:
start:
$ref: '#/components/schemas/Date'
end:
$ref: '#/components/schemas/Date'
interval:
$ref: '#/components/schemas/Duration'
base:
$ref: '#/components/schemas/Currency'
ms:
$ref: '#/components/schemas/ResponseTime'
results:
type: object
minProperties: 1
additionalProperties:
type: number
format: float
example:
start: '2021-01-24'
end: '2021-01-30'
interval: P1D
base: USD
results:
GBP:
'2021-01-24': 1.14
'2021-01-25': 1.14
'2021-01-26': 1.15
'2021-01-27': 1.16
'2021-01-28': 1.14
'2021-01-29': 1.13
'2021-01-30': 1.14
'400':
description: Bad Request
'401':
description: Not Authorized
'403':
description: Forbidden
'429':
description: Rate limit exceeded
/currencies:
get:
tags:
- plan-premium
description: Fetch a list of 160+ supported currencies with symbols. Also see /crypto/currencies
responses:
'200':
description: Success
content:
application/json:
schema:
type: object
properties:
ms:
$ref: '#/components/schemas/ResponseTime'
currencies:
type: object
minProperties: 130
additionalProperties:
type: string
example:
currencies:
AED: United Arab Emirates Dirham
AFN: Afghan Afghani
ALL: Albanian Lek
AMD: Armenian Dram
ANG: Dutch Guilders
AOA: Angolan Kwanza
ARS: Argentine Peso
AUD: Australian Dollar
AWG: Aruban Florin
AZN: Azerbaijani Manat
BAM: Bosnia-Herzegovina Convertible Mark
BBD: Barbadian Dollar
BDT: Bangladeshi Taka
BGN: Bulgarian Lev
BHD: Bahraini Dinar
BIF: Burundian Franc
BMD: Bermudian Dollar
BND: Bruneian Dollar
BOB: Bolivian Boliviano
BRL: Brazilian Real
BRX: Brazilian PTAX
BSD: Bahamian Dollar
BTN: Bhutanese Ngultrum
BWP: Botswanan Pula
BYN: Belarusian Ruble
BZD: Belizean Dollar
CAD: Canadian Dollar
CDF: Congolese Franc
CHF: Swiss Franc
CLF: Chilean Unit of Account UF
CLP: Chilean Peso
CNH: Chinese Yuan Offshore
CNY: Chinese Yuan
COP: Colombian Peso
COU: Unidad de Valor Real (Colombia)
CRC: Costa Rican Colon
CUP: Cuban Peso
CVE: Cape Verdean Escudo
CZK: Czech Republic Koruna
DJF: Djiboutian Franc
DKK: Danish Krone
DOP: Dominican Peso
DZD: Algerian Dinar
EGP: Egyptian Pound
ERN: Eritrean Nakfa
ETB: Ethiopian Birr
EUR: Euro
FJD: Fijian Dollar
FKP: Falkland Islands Pound
GBP: British Pound Sterling
GEL: Georgian Lari
GHS: Ghanaian Cedi
GIP: Gibraltar Pound
GMD: Gambian Dalasi
GNF: Guinean Franc
GTQ: Guatemalan Quetzal
GYD: Guyanaese Dollar
HKD: Hong Kong Dollar
HNL: Honduran Lempira
HRK: Croatian Kuna
HTG: Haitian Gourde
HUF: Hungarian Forint
HUX: Hungarian Forint Official Rate
IDR: Indonesian Rupiah
ILS: Israeli New Sheqel
INR: Indian Rupee
IQD: Iraqi Dinar
IRR: Iranian Rial
ISK: Icelandic Krona
JMD: Jamaican Dollar
JOD: Jordanian Dinar
JPY: Japanese Yen
KES: Kenyan Shilling
KGS: Kyrgystani Som
KHR: Cambodian Riel
KMF: Comorian Franc
KPW: North Korean Won
KRW: South Korean Won
KWD: Kuwaiti Dinar
KYD: Caymanian Dollar
KZT: Kazakhstani Tenge
LAK: Laotian Kip
LBP: Lebanese Pound
LKR: Sri Lankan Rupee
LRD: Liberian Dollar
LSL: Lesotho Maloti
LYD: Libyan Dinar
MAD: Moroccan Dirham
MDL: Moldovan Leu
MGA: Malagasy Ariary
MKD: Macedonian Denar
MMK: Myanma Kyat
MNT: Mongolian Tugrik
MOP: Macanese Pataca
MRU: Mauritanian Ouguiya
MUR: Mauritian Rupee
MVR: Maldivian Rufiyaa
MWK: Malawian Kwacha
MXN: Mexican Peso
MXV: Mexican Unidad de Inversion
MYR: Malaysian Ringgit
MZN: Mozambican Metical
NAD: Namibian Dollar
NGN: Nigerian Naira
NIO: Nicaraguan Cordoba
NOK: Norwegian Krone
NPR: Nepalese Rupee
NZD: New Zealand Dollar
OMR: Omani Rial
PAB: Panamanian Balboa
PEN: Peruvian Nuevo Sol
PGK: Papua New Guinean Kina
PHP: Philippine Peso
PKR: Pakistani Rupee
PLN: Polish Zloty
PYG: Paraguayan Guarani
QAR: Qatari Rial
RON: Romanian Leu
RSD: Serbian Dinar
RUB: Russian Ruble
RWF: Rwandan Franc
SAR: Saudi Arabian Riyal
SBD: Solomon Islands Dollar
SCR: Seychellois Rupee
SDG: Sudanese Pound
SEK: Swedish Krona
SGD: Singapore Dollar
SHP: Saint Helena Pound
SLL: Sierra Leonean Leone
SOS: Somali Shilling
SRD: Surinamese Dollar
SSP: Sou
# --- truncated at 32 KB (65 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/fastforex/refs/heads/main/openapi/fastforex-plan-premium-api-openapi.yml