{"openapi":"3.1.0","info":{"title":"Venezuela Bolívar API","version":"1.0.0","description":"Live exchange rates for the Venezuelan bolívar (VES), one of the world's most-watched hyperinflation currencies. Venezuela runs a two-tier system: the BCV (central bank) official rate and the paralelo (parallel/street) rate, and the gap between them — the brecha — is the headline indicator of the bolívar's stress. The dollar endpoint returns the USD official and parallel rate with the brecha; the euro endpoint does the same for EUR; the rates endpoint returns both currencies at once; the convert endpoint converts any amount between USD, EUR and VES at the official or parallel rate. Read live, nothing stored. This is Venezuela's own official-vs-parallel bolívar layer with a built-in converter — distinct from single-rate central-bank feeds and from other countries' parallel-dollar APIs.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/venezuela-api","description":"oanor gateway"}],"tags":[{"name":"Rates"},{"name":"Convert"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/dollar":{"get":{"operationId":"get_v1_dollar","tags":["Rates"],"summary":"USD official and parallel rate with the brecha","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"quote":"VES","source":"ve.dolarapi.com","updated":"2026-06-10T00:00:00-04:00","currency":"USD","official":572.6784,"parallel":802.0745,"brecha_pct":40.0567},"meta":{"timestamp":"2026-06-10T22:57:29.475Z","request_id":"522c6b79-51a8-4a78-a8ea-83a952a0e237"},"status":"ok","message":"Dollar retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/euro":{"get":{"operationId":"get_v1_euro","tags":["Rates"],"summary":"EUR official and parallel rate with the brecha","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"quote":"VES","source":"ve.dolarapi.com","updated":"2026-06-10T00:00:00-04:00","currency":"EUR","official":662.2453,"parallel":925.3667,"brecha_pct":39.7317},"meta":{"timestamp":"2026-06-10T22:57:29.606Z","request_id":"bf0ae774-e1a7-4b12-9c90-850fb8261fc3"},"status":"ok","message":"Euro retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/rates":{"get":{"operationId":"get_v1_rates","tags":["Rates"],"summary":"Both currencies (USD, EUR) at once","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"quote":"VES","rates":[{"quote":"VES","updated":"2026-06-10T00:00:00-04:00","currency":"USD","official":572.6784,"parallel":802.0745,"brecha_pct":40.0567},{"quote":"VES","updated":"2026-06-10T00:00:00-04:00","currency":"EUR","official":662.2453,"parallel":925.3667,"brecha_pct":39.7317}],"source":"ve.dolarapi.com"},"meta":{"timestamp":"2026-06-10T22:57:29.776Z","request_id":"04b12dfd-04db-4476-954c-fee2e8b41729"},"status":"ok","message":"Rates retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/convert":{"get":{"operationId":"get_v1_convert","tags":["Convert"],"summary":"Convert between USD, EUR and VES","description":"","parameters":[{"name":"amount","in":"query","required":true,"description":"Amount to convert","schema":{"type":"string"},"example":"100"},{"name":"from","in":"query","required":false,"description":"From currency (usd, eur, ves)","schema":{"type":"string"},"example":"usd"},{"name":"to","in":"query","required":false,"description":"To currency (usd, eur, ves)","schema":{"type":"string"},"example":"ves"},{"name":"rate","in":"query","required":false,"description":"official or parallel","schema":{"type":"string"},"example":"parallel"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"to":"VES","from":"USD","amount":100,"result":80207.45,"source":"ve.dolarapi.com","rate_type":"parallel","ves_per_to":1,"ves_per_from":802.0745},"meta":{"timestamp":"2026-06-10T22:57:29.892Z","request_id":"b40e74c2-526e-411c-9a6a-f88866a88ac5"},"status":"ok","message":"Conversion completed","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Service metadata","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Rates are VES per 1 unit of foreign currency. brecha_pct = (parallel - official) / official * 100.","source":"ve.dolarapi.com (Venezuelan FX aggregator, live)","service":"venezuela-api","endpoints":{"GET /v1/euro":"EUR official and parallel rate with the brecha.","GET /v1/meta":"This document.","GET /v1/rates":"Both currencies (USD, EUR) at once.","GET /v1/dollar":"USD official and parallel rate with the brecha.","GET /v1/convert":"Convert an amount between USD, EUR and VES (amount=100, from=usd, to=ves, rate=parallel)."},"description":"Live exchange rates for the Venezuelan bolívar (VES), one of the world's most-watched hyperinflation currencies. Venezuela runs a two-tier system: the BCV (central bank) official rate and the paralelo (parallel/street) rate; the gap between them — the brecha — is the headline indicator of the bolívar's stress. The dollar endpoint returns the USD official and parallel rate with the brecha; the euro endpoint does the same for EUR; the rates endpoint returns both currencies at once; the convert endpoint converts any amount between USD, EUR and VES at the official or parallel rate. Live, no key, nothing stored. Distinct from single-rate central-bank feeds and from other countries' parallel-dollar APIs — this is Venezuela's own official-vs-parallel bolívar layer with a built-in converter.","usd_brecha_pct":40.0567,"upstream_status":"ok","usd_parallel_ves":802.0745},"meta":{"timestamp":"2026-06-10T22:57:29.992Z","request_id":"776da40d-017f-4a7c-a3fe-97c62d7181ff"},"status":"ok","message":"Meta","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":2500,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":600,"monthly_call_quota":70000,"rps_limit":10,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":1900,"monthly_call_quota":350000,"rps_limit":30,"hard_limit":true},{"slug":"scale","name":"Scale","price_cents_month":4600,"monthly_call_quota":2200000,"rps_limit":100,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/venezuela-api"}