Research Type: API Discovery Status: ✅ Confirmed Date: 2026-04-27 Related: RS041 Cross-Corridor Exchange Rates, 1_rate_apis.md
DolarAPI provides Venezuelan exchange rates including “dólar paralelo” (black market rate) - exactly what we need for MVP!
Venezuela has the same official vs parallel market dynamic as Argentina (dólar blue), and DolarAPI covers it.
URL: https://ve.dolarapi.com (Venezuelan version) Parent API: https://dolarapi.com (covers all Latin America)
What it provides:
MVP requirement: EUR → VES corridor for Venezuelan beta testers
Question: Does Venezuela have official vs black market disconnect like Argentina?
Answer: YES!
Just like Argentina:
We need the parallel rate because that’s what merchants actually use for cash exchanges.
From https://dolarapi.com:
| Country | Currency | Parallel Market? | URL |
|---|---|---|---|
| 🇦🇷 Argentina | ARS | ✅ Dólar Blue | dolarapi.com |
| 🇻🇪 Venezuela | VES | ✅ Dólar Paralelo | ve.dolarapi.com |
| 🇨🇱 Chile | CLP | ? | cl.dolarapi.com (?) |
| 🇺🇾 Uruguay | UYU | ? | - |
| 🇲🇽 México | MXN | ? | - |
| 🇧🇴 Bolivia | BOB | ? | - |
| 🇧🇷 Brasil | BRL | ? | - |
| 🇨🇴 Colombia | COP | ? | - |
For Asgaya MVP:
Based on Argentina API structure (RS043), Venezuelan API likely follows same pattern:
GET https://ve.dolarapi.com/v1/dolares
Expected Response:
[
{
"casa": "oficial",
"nombre": "Oficial",
"compra": 36.5,
"venta": 36.5,
"fechaActualizacion": "2026-04-27T10:30:00Z"
},
{
"casa": "paralelo",
"nombre": "Dólar Paralelo",
"compra": 57.2,
"venta": 57.8,
"fechaActualizacion": "2026-04-27T10:30:00Z"
}
]
We use: paralelo.venta (sell rate) - this is what merchants charge when converting EUR → VES
Action: Verify ve.dolarapi.com works as expected
import requests
response = requests.get('https://ve.dolarapi.com/v1/dolares')
data = response.json()
# Find paralelo rate
paralelo = next(d for d in data if d['casa'] == 'paralelo')
ves_per_usd = paralelo['venta']
print(f"1 USD = {ves_per_usd} VES (parallel market)")
DolarAPI gives: USD → VES We need: EUR → VES
Solution: Two-step conversion
Example:
1 EUR = 1.08 USD (from Kraken EUR/USD pair)
1 USD = 57.5 VES (from DolarAPI paralelo)
→ 1 EUR = 1.08 × 57.5 = 62.1 VES
Alternative: Check if DolarAPI provides EUR → VES directly (some APIs do)
Update /api/v1/estimate endpoint:
def get_eur_ves_rate() -> float:
"""
Get EUR → VES exchange rate (parallel market)
Returns:
VES per EUR
"""
# Get USD → VES from DolarAPI
response = requests.get('https://ve.dolarapi.com/v1/dolares')
data = response.json()
paralelo = next(d for d in data if d['casa'] == 'paralelo')
ves_per_usd = paralelo['venta']
# Get EUR → USD from Kraken (or use fixed 1.08 for MVP)
eur_per_usd = 1.08 # TODO: Get live rate from Kraken
# Calculate EUR → VES
ves_per_eur = eur_per_usd * ves_per_usd
return ves_per_eur
Use DolarAPI for both Argentina AND Venezuela:
✅ Benefits:
✅ Corridors supported:
⏳ Future expansion:
If ve.dolarapi.com down:
If persistent issues:
Before MVP:
Verify DolarAPI accuracy by comparing with:
If rates differ >5%: Flag for investigation, might indicate API issue
Discovered: April 27, 2026 Source: https://dolarapi.com (covers Venezuela + 7 other countries) Status: Ready to integrate into MVP Next: Test endpoint and implement in backend
“Venezuela has the same official vs black market disconnect as Argentina. DolarAPI covers both. We can use a single API provider for our two main MVP corridors!”
This simplifies our MVP significantly - one API integration instead of researching multiple sources per country.