Service metadata

Extraits de code

curl "https://api.oanor.com/venezuela-api/v1/meta" \
  -H "x-oanor-key: oanor_test_..."

await fetch("https://api.oanor.com/venezuela-api/v1/meta", {
  headers: { "x-oanor-key": "oanor_test_..." }
});

$ch = curl_init("https://api.oanor.com/venezuela-api/v1/meta");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["x-oanor-key: oanor_test_..."]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$out = curl_exec($ch);

import requests
requests.get(
    "https://api.oanor.com/venezuela-api/v1/meta",
    headers={"x-oanor-key": "oanor_test_..."}
)

Exemple de réponse

Une réponse réelle de ce endpoint, capturée lors du dernier contrôle de santé.

{
    "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
}