#What the Currency API does
The Currency API provides 5 endpoints for production-ready currency data: list 170+ currencies (fiat, crypto & metals), fetch live exchange rates from multiple verified sources, convert amounts with platform fee comparison, browse platform markups, and query historical daily rates for up to one year.
#Endpoints at a glance
| Endpoint | What it does | Credits |
|---|---|---|
currencies |
List all supported currencies with code, name, symbol, type (fiat/crypto/metal) | 0.001 |
rates |
Get live exchange rates for one or more currency pairs (max 20) | 0.005 |
convert |
Convert an amount & compare what you’d receive on 8 platforms | 0.009 |
platforms |
List platforms with their markup percentages and fee structures | 0.001 |
historical |
Daily historical rates for a pair (up to 365 days) | 0.02 |
#Convert & Platform Comparison
The convert endpoint is the most popular. It returns the mid-market rate
plus what you’d actually receive on each platform after their markup and fees.
curl -X POST https://api.yeb.to/v1/currency/convert \
-H "Content-Type: application/json" \
-d '{
"api_key": "YOUR_KEY",
"from": "EUR",
"to": "BGN",
"amount": 1000,
"include_platforms": true
}'The response includes the mid-market conversion and a breakdown per platform:
- rate — the effective rate after platform markup
- result — what you actually receive
- fee — the platform’s transfer fee
- total_cost — total hidden cost vs mid-market (markup + fee)
- markup — the platform’s markup percentage
#Supported platforms
We compare rates across 8 popular money transfer platforms:
| Platform | Markup | Fee | Notes |
|---|---|---|---|
| Wise | 0.50% | Variable | Transparent mid-market based |
| Revolut | 0.25% | None (free plan) | +0.75% on weekends |
| XE | 0.50% | None | Close to mid-market |
| OFX | 0.50% | None | Good for large amounts |
| Remitly | 1.50% | Variable | Popular for remittances |
| Western Union | 2.00% | Flat fee | Wide physical network |
| Skrill | 3.99% | 1.45% | Digital wallet |
| PayPal | 4.00% | 2.90% | Highest total cost |
#Currency coverage
The API supports 170+ currencies across three categories:
- Fiat — USD, EUR, GBP, BGN, JPY, CHF, AUD, CAD, and 150+ more
- Crypto — BTC, ETH, SOL, ADA, BNB, USDT, USDC, XRP, DOGE, DOT
- Precious metals — XAU (gold), XAG (silver), XPT (platinum), XPD (palladium)
Use the currencies endpoint to fetch the full list with symbols and decimal precision.
#Historical rates
The historical endpoint returns daily rate snapshots for any pair.
Useful for building charts, calculating averages, or backtesting strategies.
- Default range: last 30 days
- Maximum range: 365 days
- Dates in
YYYY-MM-DDformat
#How rates are sourced
Reliability is built in through multi-source aggregation:
- Primary — fawazahmed0 exchange API (CDN-backed, 200+ currencies, no rate limit, updated every 15 min)
- Secondary — fxratesapi.com (real-time verification every 30 min)
- Fallback — European Central Bank (ECB) daily reference rates
- Cache — last known rate if all sources are temporarily unavailable (< 24h)
If the primary and secondary sources diverge by more than 1%, the system logs a deviation warning and uses the primary rate.
#Common use cases
- E-commerce — display prices in the visitor’s local currency
- Fintech apps — show users how much they’d save on each platform
- Travel apps — quick multi-currency converter
- Accounting — historical rates for end-of-month reconciliation
- Crypto dashboards — live BTC/ETH prices alongside fiat