Skip to main content
GET
/
exchange-rates
Get exchange rate
curl --request GET \
  --url https://api.fernhq.com/exchange-rates \
  --header 'Authorization: Bearer <token>'
{
  "exchangeRate": "1000.00",
  "feeComponents": [
    {
      "feeType": "FLAT",
      "feeAmount": "5.45",
      "feeCurrency": {
        "label": "USDC",
        "chain": "ETHEREUM",
        "contractAddress": "0x123456789abcd123456789abcd123456789abcd",
        "currencyDecimals": 18
      }
    }
  ],
  "destinationAmount": "100",
  "fees": {
    "feeCurrency": {
      "label": "USDC",
      "chain": "ETHEREUM",
      "contractAddress": "0x123456789abcd123456789abcd123456789abcd",
      "currencyDecimals": 18
    },
    "fernFee": {
      "feeAmount": "5.45",
      "feeUSDAmount": "5.45"
    }
  }
}

Authorizations

​
Authorization
string
header
required

To authenticate server-side requests

Query Parameters

​
sourceCurrency
string
required

Currency label or contract address.

​
sourcePaymentMethod
required

The payment method for the source exchangeRate The payment method for the source funds (fiat)

Available options:
ACH,
WIRE,
SEPA,
AE_UAEFTS,
AR_TRANSFERS_3,
AU_BECS,
BD_BEFTN,
BO_RTGS,
BR_TED_DOC_PIX,
CA_INTERAC,
CL_TEF,
CN_CNAPS,
CO_ACH,
CR_SINPE,
CZ_CERTIS,
DK_NEMKONTO_FI,
DO_ACH,
EC_LOCAL,
EG_RTGS_IPN,
GB_BACS_CHAPS_FPS,
GH_GHIPSS,
GT_ACH,
HK_HKICL_CHATS_ECG,
HU_GIRO,
ID_SKN_RTGS,
IL_ZAHAV,
IN_NEFT_RTGS_IMPS,
JM_LOCAL,
JO_ACH,
JP_ZENGIN,
KE_KIBBS_PESALINK,
KR_LOCAL,
LK_LOCAL,
MX_SPEI,
MY_IBG_RENTAS,
NG_NIBSS_NEFT,
NO_NICS,
NP_LOCAL,
NZ_LOCAL,
PE_CCE,
PH_INSTAPAY_PESONET,
PK_RAAST_IBFT,
PL_ELIXIR_BLUE_CASH,
QA_QPS,
RO_RTGS,
SA_MADA,
SE_BANKGIROT,
SG_FAST_MEPS,
SV_LOCAL,
SWIFT,
TH_BAHTNET_PROMPTPAY,
TR_FAST_EFT,
TZ_RTGS,
VN_IBPS,
ZA_RTGS_EFT,
ACH_SAME_DAY
​
sourceAmount
string

The amount to be sent. If provided fern fees and destination amount will be returned

​
destinationPaymentMethod
required

The payment method for the destination exchangeRate The payment method for the source funds (fiat)

Available options:
ACH,
WIRE,
SEPA,
AE_UAEFTS,
AR_TRANSFERS_3,
AU_BECS,
BD_BEFTN,
BO_RTGS,
BR_TED_DOC_PIX,
CA_INTERAC,
CL_TEF,
CN_CNAPS,
CO_ACH,
CR_SINPE,
CZ_CERTIS,
DK_NEMKONTO_FI,
DO_ACH,
EC_LOCAL,
EG_RTGS_IPN,
GB_BACS_CHAPS_FPS,
GH_GHIPSS,
GT_ACH,
HK_HKICL_CHATS_ECG,
HU_GIRO,
ID_SKN_RTGS,
IL_ZAHAV,
IN_NEFT_RTGS_IMPS,
JM_LOCAL,
JO_ACH,
JP_ZENGIN,
KE_KIBBS_PESALINK,
KR_LOCAL,
LK_LOCAL,
MX_SPEI,
MY_IBG_RENTAS,
NG_NIBSS_NEFT,
NO_NICS,
NP_LOCAL,
NZ_LOCAL,
PE_CCE,
PH_INSTAPAY_PESONET,
PK_RAAST_IBFT,
PL_ELIXIR_BLUE_CASH,
QA_QPS,
RO_RTGS,
SA_MADA,
SE_BANKGIROT,
SG_FAST_MEPS,
SV_LOCAL,
SWIFT,
TH_BAHTNET_PROMPTPAY,
TR_FAST_EFT,
TZ_RTGS,
VN_IBPS,
ZA_RTGS_EFT,
ACH_SAME_DAY
​
destinationCurrency
string
required

Currency label or contract address.

Response

Response Schema for retrieving the exchangeRate of a payment account

Response Schema for retrieving the exchangeRate of a payment account

​
exchangeRate
string
required

The rate at which the source currency is multiplied to determine the equivalent amount in the destination currency

Example:

"1000.00"

​
feeComponents
Fees Component Schema · object[]
required
​
destinationAmount
string

The amount that will be received excluding fern fees. Equivalent to setting developer fee to 0

Example:

"100"

​
fees
Fees Schema · object

Fee structure for an exchange rate