API Documentation

Comprehensive guide for integrating with our Free Exchange Rates API.

Authentication

Currently, no authentication required. API key verification is planned for future updates.

1. Currency Conversion

POST /api/v1/free/convert

Request Parameters

ParameterTypeRequiredDescription
basestringYesBase currency (e.g., USD)
targetstringYesTarget currency (e.g., EUR)
directionstring (buy/sell)YesTransaction direction

Sample Response

{
  "base": "USD",
  "target": "NGN",
  "direction": "buy",
  "best_rate": 1536.76,
  "rate_type": "standard",
  "timestamp": "1743111042",
  "last_updated": "2025-03-27 18:30:42",
  "disclaimer": "Rates for informational purposes only"
}

2. International Rates (Full)

POST /api/v1/free/international/full

Request Parameters

ParameterTypeRequiredDescription
basestringYesThe base currency (e.g., SOL)

Sample Response

{
  "timestamp": 1743126377,
  "base": "SOL",
  "rates": {
    "USD": {
      "base_currency": "SOL",
      "target_currency": "USD",
      "pair_description": "Solana / US Dollar",
      "daily_high": "138.5",
      "daily_low": "136.73",
      "change_amount": "-0.909993",
      "change_percent": "-0.657367",
      "buy_rate": "137.52",
      "sell_rate": "137.53",
      "timestamp_unix": "1743124171",
      "last_updated_utc": "2025-03-27 22:09:31"
    }
    // additional rates omitted...
  }
}

3. Naira Parallel Rates

POST /api/v1/free/naira/parallel

Request Parameters

No parameters required.

Sample Response

{
  "status": "success",
  "message": "retrieved",
  "data": {
    "ticker": "usdngn",
    "provider": [
      {
        "code": "beans app",
        "buy": 1420,
        "sell": 1406,
        "last_updated": 1743128100324
      }
      // More providers...
    ]
  }
}

Available Currency Pairs

  • USD-BRL
  • USD-BRLT
  • CAD-BRL
  • EUR-BRL
  • GBP-BRL
  • ARS-BRL
  • BTC-BRL
  • LTC-BRL
  • JPY-BRL
  • CHF-BRL
  • AUD-BRL
  • CNY-BRL
  • ILS-BRL
  • ETH-BRL
  • XRP-BRL
  • EUR-USD
  • CAD-USD
  • GBP-USD
  • ARS-USD
  • JPY-USD
  • CHF-USD
  • AUD-USD
  • CNY-USD
  • ILS-USD
  • BTC-USD
  • LTC-USD
  • ETH-USD
  • XRP-USD
  • BRL-USD
  • BRL-EUR
  • USD-EUR
  • CAD-EUR
  • GBP-EUR
  • ARS-EUR
  • JPY-EUR
  • CHF-EUR
  • AUD-EUR
  • CNY-EUR
  • ILS-EUR
  • BTC-EUR
  • LTC-EUR
  • ETH-EUR
  • XRP-EUR
  • DOGE-BRL
  • DOGE-EUR
  • DOGE-USD
  • USD-JPY
  • USD-CHF
  • USD-CAD
  • NZD-USD
  • USD-ZAR
  • USD-TRY
  • USD-MXN
  • USD-PLN
  • USD-SEK
  • USD-SGD
  • USD-DKK
  • USD-NOK
  • USD-ILS
  • USD-HUF
  • USD-CZK
  • USD-THB
  • USD-AED
  • USD-JOD
  • USD-KWD
  • USD-HKD
  • USD-SAR
  • USD-INR
  • USD-KRW
  • FJD-USD
  • GHS-USD
  • KYD-USD
  • SGD-USD
  • USD-ALL
  • USD-AMD
  • USD-ANG
  • USD-ARS
  • USD-AUD
  • USD-BBD
  • USD-BDT
  • USD-BGN
  • USD-BHD
  • USD-BIF
  • USD-BND
  • USD-BOB
  • USD-BSD
  • USD-BWP
  • USD-BZD
  • USD-CLP
  • USD-CNY
  • USD-COP
  • USD-CRC
  • USD-CUP
  • USD-DJF
  • USD-DOP
  • USD-DZD
  • USD-EGP
  • USD-ETB
  • USD-FJD
  • USD-GBP
  • USD-GEL
  • USD-GHS
  • USD-GMD
  • USD-GNF
  • USD-GTQ
  • USD-HNL
  • USD-HRK
  • USD-HTG
  • USD-IDR
  • USD-IQD
  • USD-IRR
  • USD-ISK
  • USD-JMD
  • USD-KES
  • USD-KHR
  • USD-KMF
  • USD-KZT
  • USD-LAK
  • USD-LBP
  • USD-LKR
  • USD-LSL
  • USD-LYD
  • USD-MAD
  • USD-MDL
  • USD-MGA
  • USD-MKD
  • USD-MMK
  • USD-MOP
  • USD-MRO
  • USD-MUR
  • USD-MVR
  • USD-MWK
  • USD-MYR
  • USD-NAD
  • USD-NGN
  • USD-NIO
  • USD-NPR
  • USD-NZD
  • USD-OMR
  • USD-PAB
  • USD-PEN
  • USD-PGK
  • USD-PHP
  • USD-PKR
  • USD-PYG
  • USD-QAR
  • USD-RON
  • USD-RSD
  • USD-RWF
  • USD-SCR
  • USD-SDG
  • USD-SOS
  • USD-STD
  • USD-SVC
  • USD-SYP
  • USD-SZL
  • USD-TND
  • USD-TTD
  • USD-TWD
  • USD-TZS
  • USD-UAH
  • USD-UGX
  • USD-UYU
  • USD-UZS
  • USD-VEF
  • USD-VND
  • USD-VUV
  • USD-XAF
  • USD-XCD
  • USD-XOF
  • USD-XPF
  • USD-YER
  • USD-ZMK
  • AED-USD
  • DKK-USD
  • HKD-USD
  • MXN-USD
  • NOK-USD
  • PLN-USD
  • RUB-USD
  • SAR-USD
  • SEK-USD
  • TRY-USD
  • TWD-USD
  • VEF-USD
  • ZAR-USD
  • UYU-USD
  • PYG-USD
  • CLP-USD
  • COP-USD
  • PEN-USD
  • NIO-USD
  • BOB-USD
  • KRW-USD
  • EGP-USD
  • USD-BYN
  • USD-MZN
  • INR-USD
  • JOD-USD
  • KWD-USD
  • USD-AZN
  • USD-CNH
  • USD-KGS
  • USD-TJS
  • USD-RUB
  • MYR-USD
  • UAH-USD
  • HUF-USD
  • IDR-USD
  • USD-AOA
  • VND-USD
  • BYN-USD
  • XBR-USD
  • THB-USD
  • PHP-USD
  • USD-TMT
  • XAGG-USD
  • USD-MNT
  • USD-AFN
  • AFN-USD
  • SYP-USD
  • IRR-USD
  • IQD-USD
  • USD-NGNI
  • USD-ZWL
  • BRL-ARS
  • BRL-AUD
  • BRL-CAD
  • BRL-CHF
  • BRL-CLP
  • BRL-DKK
  • BRL-HKD
  • BRL-JPY
  • BRL-MXN
  • BRL-SGD
  • SGD-BRL
  • AED-BRL
  • BRL-AED
  • BRL-BBD
  • BRL-BHD
  • BRL-CNY
  • BRL-CZK
  • BRL-EGP
  • BRL-GBP
  • BRL-HUF
  • BRL-IDR
  • BRL-ILS
  • BRL-INR
  • BRL-ISK
  • BRL-JMD
  • BRL-JOD
  • BRL-KES
  • BRL-KRW
  • BRL-LBP
  • BRL-LKR
  • BRL-MAD
  • BRL-MYR
  • BRL-NAD
  • BRL-NOK
  • BRL-NPR
  • BRL-NZD
  • BRL-OMR
  • BRL-PAB
  • BRL-PHP
  • BRL-PKR
  • BRL-PLN
  • BRL-QAR
  • BRL-RON
  • BRL-RUB
  • BRL-SAR
  • BRL-SEK
  • BRL-THB
  • BRL-TRY
  • BRL-VEF
  • BRL-XAF
  • BRL-XCD
  • BRL-XOF
  • BRL-ZAR
  • BRL-TWD
  • DKK-BRL
  • HKD-BRL
  • MXN-BRL
  • NOK-BRL
  • NZD-BRL
  • PLN-BRL
  • SAR-BRL
  • SEK-BRL
  • THB-BRL
  • TRY-BRL
  • TWD-BRL
  • VEF-BRL
  • ZAR-BRL
  • BRL-PYG
  • BRL-UYU
  • BRL-COP
  • BRL-PEN
  • BRL-BOB
  • CLP-BRL
  • PYG-BRL
  • UYU-BRL
  • COP-BRL
  • PEN-BRL
  • BOB-BRL
  • RUB-BRL
  • INR-BRL
  • EUR-GBP
  • EUR-JPY
  • EUR-CHF
  • EUR-AUD
  • EUR-CAD
  • EUR-NOK
  • EUR-DKK
  • EUR-PLN
  • EUR-NZD
  • EUR-SEK
  • EUR-ILS
  • EUR-TRY
  • EUR-THB
  • EUR-ZAR
  • EUR-MXN
  • EUR-SGD
  • EUR-HUF
  • EUR-HKD
  • EUR-CZK
  • EUR-KRW
  • BHD-EUR
  • EUR-AED
  • EUR-AFN
  • EUR-ALL
  • EUR-ANG
  • EUR-ARS
  • EUR-BAM
  • EUR-BBD
  • EUR-BDT
  • EUR-BGN
  • EUR-BHD
  • EUR-BIF
  • EUR-BND
  • EUR-BOB
  • EUR-BSD
  • EUR-BWP
  • EUR-BYN
  • EUR-BZD
  • EUR-CLP
  • EUR-CNY
  • EUR-COP
  • EUR-CRC
  • EUR-CUP
  • EUR-CVE
  • EUR-DJF
  • EUR-DOP
  • EUR-DZD
  • EUR-EGP
  • EUR-ETB
  • EUR-FJD
  • EUR-GHS
  • EUR-GMD
  • EUR-GNF
  • EUR-GTQ
  • EUR-HNL
  • EUR-HRK
  • EUR-HTG
  • EUR-IDR
  • EUR-INR
  • EUR-IQD
  • EUR-IRR
  • EUR-ISK
  • EUR-JMD
  • EUR-JOD
  • EUR-KES
  • EUR-KHR
  • EUR-KWD
  • EUR-KYD
  • EUR-KZT
  • EUR-LAK
  • EUR-LBP
  • EUR-LKR
  • EUR-LSL
  • EUR-LYD
  • EUR-MAD
  • EUR-MDL
  • EUR-MGA
  • EUR-MKD
  • EUR-MMK
  • EUR-MOP
  • EUR-MRO
  • EUR-MUR
  • EUR-MWK
  • EUR-MYR
  • EUR-NAD
  • EUR-NGN
  • EUR-NIO
  • EUR-NPR
  • EUR-OMR
  • EUR-PAB
  • EUR-PEN
  • EUR-PGK
  • EUR-PHP
  • EUR-PKR
  • EUR-PYG
  • EUR-QAR
  • EUR-RON
  • EUR-RSD
  • EUR-RWF
  • EUR-SAR
  • EUR-SCR
  • EUR-SDG
  • EUR-SDR
  • EUR-SOS
  • EUR-STD
  • EUR-SVC
  • EUR-SYP
  • EUR-SZL
  • EUR-TND
  • EUR-TTD
  • EUR-TWD
  • EUR-TZS
  • EUR-UAH
  • EUR-UGX
  • EUR-UYU
  • EUR-UZS
  • EUR-VEF
  • EUR-VND
  • EUR-XAF
  • EUR-XOF
  • EUR-XPF
  • EUR-ZMK
  • GHS-EUR
  • NZD-EUR
  • SGD-EUR
  • AED-EUR
  • DKK-EUR
  • EUR-XCD
  • HKD-EUR
  • MXN-EUR
  • NOK-EUR
  • PLN-EUR
  • RUB-EUR
  • SAR-EUR
  • SEK-EUR
  • TRY-EUR
  • TWD-EUR
  • VEF-EUR
  • ZAR-EUR
  • MAD-EUR
  • KRW-EUR
  • EGP-EUR
  • EUR-MZN
  • INR-EUR
  • JOD-EUR
  • KWD-EUR
  • EUR-AZN
  • EUR-AMD
  • EUR-TJS
  • EUR-RUB
  • HUF-EUR
  • GEL-EUR
  • EUR-GEL
  • IDR-EUR
  • EUR-AOA
  • BYN-EUR
  • XAGG-EUR
  • PEN-EUR
  • XAU-USD
  • XAU-EUR
  • USD-BRLPTAX
  • NZD-JPY
  • GBP-JPY
  • GBP-CHF
  • XAU-BRL
  • CAD-JPY
  • CLP-EUR
  • CLP-BOB
  • XAG-EUR
  • XAG-USD
  • XAG-BRL
  • RSD-BRL
  • BRL-RSD
  • KRW-BRL
  • BRL-XAG
  • AUD-JPY
  • AUD-NZD
  • BRETT-USD
  • BRETT-BRL
  • BRETT-EUR
  • SOL-USD
  • SOL-BRL
  • SOL-EUR
  • BNB-USD
  • BNB-BRL
  • BNB-EUR
  • CHF-JPY
  • GBP-ZAR
  • AUD-CHF
  • GBP-AUD
  • ARS-CLP
  • ARS-PEN
  • CAD-UAH
  • EUR-BRLT
  • EUR-BRLPTAX
  • BRL-XAU
  • XCD-GBP
  • GBP-XCD
  • MXN-XCD
  • NZD-ILS
  • CRC-USD
  • CRC-BRL
  • PYG-ARS
  • RON-BRL
  • BRL-CRC
  • ILS-NZD
  • PYG-EUR
  • USD-KYD
  • XCD-USD
  • RON-USD
  • EGP-BRL
  • XOF-USD
  • KES-USD
  • KES-BRL
  • PHP-BRL
  • HUF-BRL
  • CZK-USD
  • CZK-BRL
  • SDG-USD
  • XPF-USD
  • XPF-EUR
  • ANG-USD
Disclaimer: Exchange rates are for informational purposes only and are subject to change without notice.