State Bank of Vietnam Exchange Rate API: Official VND Rates as JSON

The State Bank of Vietnam publishes the official exchange rates that accounting, tax, and customs practice in Vietnam reference — published official rates, not moving market prices. This guide shows how to pull them as JSON: via a REST endpoint or the zero-dependency sbv-exchange-rate npm package.

Three official series, one endpoint

The SBV publishes a daily USD/VND central rate — each announcement carrying its own decree number, and commercial banks may trade within a band around it — plus reference buying and selling rates for seven currencies, and a weekly 27-currency cross-rate table that Vietnamese customs and tax valuation use. The API serves all three: the central rate and crosses as reference, the intervention quotes as buy/sell.

Why official rates, not market rates

A live mid-market feed answers "what is USD/VND trading at right now?" — the right tool for checkouts and dashboards. But accountants, auditors, and tax authorities ask a different question: "which rate were you required to use for this date?" That answer comes from the State Bank of Vietnam’s published rates, and it never changes after publication.

Get the latest rates (REST)

curl "https://allratestoday.com/api/v1/central-bank/sbv/latest" \
  -H "Authorization: Bearer YOUR_API_KEY"

The response is the bank's most recent published table — every rate and the publication date. The latest rates are available on every plan, including the free tier (300 requests/month, no credit card).

The npm SDK

npm install sbv-exchange-rate

import { getRate, getLatestRates } from 'sbv-exchange-rate';

// One pair at the official rate
const pair = await getRate('USD', 'VND', { apiKey: 'art_live_...' });
console.log(pair.rate, pair.rate_date);

// The bank's full published table
const table = await getLatestRates({ apiKey: 'art_live_...' });
console.log(table.rate_date, table.rates.length);

Zero dependencies, TypeScript types included, and it runs anywhere fetch exists — Node 18+, Bun, Deno, and edge runtimes.

Historical rates for an invoice date

import { getRatesForDate, getHistory } from 'sbv-exchange-rate';

const day = await getRatesForDate('2026-08-18', { apiKey: 'art_live_...' });

const series = await getHistory(
  { source: 'USD', target: 'VND', from: '2026-01-01' },
  { apiKey: 'art_live_...' }
);

Historical dates and time series need a paid plan; the latest rates stay free.

Published vs derived pairs

If the State Bank of Vietnam does not print a pair directly, the API resolves it from the bank's published rates — an inverse, or a cross via VND — and flags it derived: true with the method used. Official and computed values are never silently mixed, which is exactly the distinction an auditor will ask about.

The archive

The central-rate series reaches back to 2009 (the pre-2016 years being the old interbank average rate it replaced), the customs cross table to 2020, and the reference buy/sell quotes to 2022.

FAQ

Does the State Bank of Vietnam have an official exchange rate API?

The bank publishes its official rates on its own site, and AllRatesToday serves the same published rates as clean JSON via REST or the sbv-exchange-rate npm package. The latest table is free.

How do I get the official Vietnam exchange rate for a past date?

The rates-for-date endpoint returns the official table for any archived date; non-publication days resolve to the most recent published date and are flagged, so audit trails stay honest. Historical dates require a paid plan; latest rates are free.

Which SBV rate applies to customs and tax valuation?

The weekly cross-rate table (tỷ giá tính chéo) is the official series for determining taxable and customs value in non-USD currencies; the daily central rate anchors USD/VND. Both are served with their official validity dates.