Service metadata

Code snippets

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

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

$ch = curl_init("https://api.oanor.com/vietnam-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/vietnam-api/v1/meta",
    headers={"x-oanor-key": "oanor_test_..."}
)

Example response

A real response from this endpoint, captured by the latest health check.

{
    "data": {
        "note": "Rates are VND per 1 unit of foreign currency. cash = buy banknotes, transfer = buy by wire, sell = bank sells FX.",
        "source": "Vietcombank (www.vietcombank.com.vn, live)",
        "service": "vietnam-api",
        "endpoints": {
            "GET /v1/meta": "This document.",
            "GET /v1/rate": "One currency by code (currency=USD).",
            "GET /v1/rates": "Every quoted currency vs the đồng with cash/transfer/sell and spread.",
            "GET /v1/convert": "Convert between a currency and the đồng (amount=100, from=USD, to=VND, rate=sell)."
        },
        "currencies": 20,
        "description": "Live Vietnamese đồng (VND) bank counter exchange rates from Vietcombank, Vietnam's largest commercial bank. Unlike a central-bank reference or a parallel-market rate, these are the rates a customer actually transacts at, quoted in three forms: the cash rate (buying banknotes), the transfer rate (buying via wire) and the sell rate (the bank selling foreign currency). The rates endpoint returns every quoted currency against the đồng with all three rates and the spread; the rate endpoint returns one currency; the convert endpoint converts any amount between a currency and the đồng at the chosen rate. Live, no key, nothing stored. Distinct from central-bank reference feeds and from parallel-market APIs — this is Vietnam's own commercial-bank counter-rate layer.",
        "usd_sell_vnd": 26410,
        "upstream_status": "ok"
    },
    "meta": {
        "timestamp": "2026-06-10T22:57:09.300Z",
        "request_id": "ba4c1b81-0213-4c1e-9be1-be49bc72b212"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}