Skip to main content
GET
/
v1
/
fx-rate
Fetch Exchange Rates
curl --request GET \
  --url https://sandbox.api.fin.com/v1/fx-rate \
  --header 'Authorization: Bearer <token>'
{
  "data": {
    "from_currency": "USD",
    "to_currency": "BDT",
    "exchange_rate": 117.19,
    "valid_from": "2025-01-01T00:00:00Z",
    "valid_till": "2025-01-02T00:00:00Z"
  }
}
Provide either country_code or currency_code, but not both.

Authorizations

​
Authorization
string
header
required

Bearer token authentication. Obtain token from /v1/oauth/token endpoint

Query Parameters

​
country_code
enum<string>

ISO 3166-1 alpha-3 country code

Available options:
AFG,
ALB,
DZA,
ASM,
AND,
AGO,
AIA,
ATA,
ATG,
ARG,
ARM,
ABW,
AUS,
AUT,
AZE,
BHS,
BHR,
BGD,
BRB,
BLR,
BEL,
BLZ,
BEN,
BMU,
BTN,
BOL,
BES,
BIH,
BWA,
BVT,
BRA,
IOT,
BRN,
BGR,
BFA,
BDI,
CPV,
KHM,
CMR,
CAN,
CYM,
CAF,
TCD,
CHL,
CHN,
CXR,
CCK,
COL,
COM,
COD,
COG,
COK,
CRI,
HRV,
CUB,
CUW,
CYP,
CZE,
CIV,
DNK,
DJI,
DMA,
DOM,
ECU,
EGY,
SLV,
GNQ,
ERI,
EST,
SWZ,
ETH,
FLK,
FRO,
FJI,
FIN,
FRA,
GUF,
PYF,
ATF,
GAB,
GMB,
GEO,
DEU,
GHA,
GIB,
GRC,
GRL,
GRD,
GLP,
GUM,
GTM,
GGY,
GIN,
GNB,
GUY,
HTI,
HMD,
VAT,
HND,
HKG,
HUN,
ISL,
IND,
IDN,
IRN,
IRQ,
IRL,
IMN,
ISR,
ITA,
JAM,
JPN,
JEY,
JOR,
KAZ,
KEN,
KIR,
PRK,
KOR,
KWT,
KGZ,
LAO,
LVA,
LBN,
LSO,
LBR,
LBY,
LIE,
LTU,
LUX,
MAC,
MDG,
MWI,
MYS,
MDV,
MLI,
MLT,
MHL,
MTQ,
MRT,
MUS,
MYT,
MEX,
FSM,
MDA,
MCO,
MNG,
MNE,
MSR,
MAR,
MOZ,
MMR,
NAM,
NRU,
NPL,
NLD,
NCL,
NZL,
NIC,
NER,
NGA,
NIU,
NFK,
MNP,
NOR,
OMN,
PAK,
PLW,
PSE,
PAN,
PNG,
PRY,
PER,
PHL,
PCN,
POL,
PRT,
PRI,
QAT,
MKD,
ROU,
RUS,
RWA,
REU,
BLM,
SHN,
KNA,
LCA,
MAF,
SPM,
VCT,
WSM,
SMR,
STP,
SAU,
SEN,
SRB,
SYC,
SLE,
SGP,
SXM,
SVK,
SVN,
SLB,
SOM,
ZAF,
SGS,
SSD,
ESP,
LKA,
SDN,
SUR,
SJM,
SWE,
CHE,
SYR,
TWN,
TJK,
TZA,
THA,
TLS,
TGO,
TKL,
TON,
TTO,
TUN,
TUR,
TKM,
TCA,
TUV,
UGA,
UKR,
ARE,
GBR,
UMI,
USA,
URY,
UZB,
VUT,
VEN,
VNM,
VGB,
VIR,
WLF,
ESH,
YEM,
ZMB,
ZWE,
ALA
​
currency_code
string

ISO 4217 currency code (provide either this or country_code)

Response

Exchange rates retrieved successfully

​
data
object