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
Parameter | Type | Required | Description |
---|---|---|---|
base | string | Yes | Base currency (e.g., USD) |
target | string | Yes | Target currency (e.g., EUR) |
direction | string (buy/sell) | Yes | Transaction 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
Parameter | Type | Required | Description |
---|---|---|---|
base | string | Yes | The 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