API курсов валют State Bank of Vietnam
Официальные курсы State Bank of Vietnam на 5 сент. 2026 г.: 1 USD = 24375.00 VND, 1 EUR = 28286.00 VND. Все публикуемые валюты: 28 валют, история с 2009 года. Бесплатный JSON API для отчётности, аудита и счетов.
О банке State Bank of Vietnam
Государственный банк Вьетнама ежедневно объявляет центральный курс USD/VND — каждое объявление имеет собственный номер постановления, — вокруг которого банки могут торговать в пределах коридора, а также справочные курсы покупки и продажи по семи валютам и еженедельную таблицу кросс-курсов по 27 валютам для таможенной и налоговой оценки. Ряд центрального курса ведётся с 2009 года.
- Официальный сайт: www.sbv.gov.vn
- Официальная публикация курсов: Central exchange rate
Быстрый старт
Один запрос для нужной пары — USD к VND по официальному курсу State Bank of Vietnam:
curl "https://allratestoday.com/api/v1/central-bank/sbv/latest?source=USD&target=VND" \
-H "Authorization: Bearer art_live_your_key" Или полная опубликованная таблица банка:
curl "https://allratestoday.com/api/v1/central-bank/sbv/latest" \
-H "Authorization: Bearer art_live_your_key" На платных тарифах — любая историческая дата или временной ряд:
curl "https://allratestoday.com/api/v1/central-bank/sbv/history?source=USD&target=VND&from=2025-01-01" \
-H "Authorization: Bearer art_live_your_key" Последние опубликованные курсы (2026-09-05)
Самая свежая таблица, опубликованная State Bank of Vietnam, — ровно то, что сейчас возвращает эндпоинт /latest. Значения указаны в VND за 1 единицу каждой валюты:
Скачать таблицу: Excel (.xlsx) CSV (требуется платный тариф)
По одной строке на валюту за каждую дату публикации. До одного года за загрузку. Тарифицируется как один API-запрос за каждую валюту за каждый месяц данных.
| База | Котировка | Тип | Курс |
|---|---|---|---|
AED | VND | reference | 6973.45 |
AUD | VND | buy | 17525 |
AUD | VND | reference | 18293.22 |
AUD | VND | sell | 19369 |
BRL | VND | reference | 4969.92 |
CAD | VND | buy | 17639 |
CAD | VND | reference | 18405.92 |
CAD | VND | sell | 19495 |
CHF | VND | buy | 30114 |
CHF | VND | reference | 31512.24 |
CHF | VND | sell | 33284 |
CNY | VND | reference | 3809.54 |
DKK | VND | reference | 3966.73 |
EUR | VND | buy | 28286 |
EUR | VND | reference | 29648.7 |
EUR | VND | sell | 31264 |
GBP | VND | buy | 32914 |
GBP | VND | reference | 34573.5 |
GBP | VND | sell | 36378 |
HKD | VND | reference | 3266.21 |
IDR | VND | reference | 1.44 |
INR | VND | reference | 269.67 |
JPY | VND | buy | 156 |
JPY | VND | reference | 160.47 |
JPY | VND | sell | 173 |
KHR | VND | reference | 6.33 |
KRW | VND | reference | 18.72 |
LAK | VND | reference | 1.15 |
MOP | VND | reference | 3171.12 |
MYR | VND | reference | 6339.11 |
NOK | VND | reference | 2746.76 |
NZD | VND | reference | 14969.05 |
PLN | VND | reference | 6837.72 |
RUB | VND | reference | 294.71 |
SEK | VND | reference | 2659.34 |
SGD | VND | reference | 20116.25 |
THB | VND | reference | 769.53 |
TRY | VND | reference | 530.31 |
TWD | VND | reference | 806.74 |
USD | VND | buy | 24375 |
USD | VND | reference | 25605 |
USD | VND | sell | 26835 |
Клиент для Node.js / TypeScript
Отдельный npm-пакет без зависимостей оборачивает эти эндпоинты — sbv-exchange-rate:
npm install sbv-exchange-rate import { getRate } from 'sbv-exchange-rate';
const pair = await getRate('USD', 'VND', { apiKey: 'art_live_...' });
console.log(pair.rate, pair.rate_date); Ноль зависимостей, типы TypeScript в комплекте; работает везде, где есть fetch — Node 18+, Bun, Deno и edge-среды.
Полная документация — установка, все четыре функции, формат ответов, коды ошибок: sbv-exchange-rate (на английском).
Зачем нужен официальный курс State Bank of Vietnam?
Рыночные курсы меняются непрерывно, но налоговая отчётность, таможенные декларации, аудит и бухгалтерский учёт (Vietnam и не только) обычно требуют официальный курс, опубликованный State Bank of Vietnam на конкретную дату — фиксированное число, на которое можно ссылаться и которое не меняется после публикации. Этот API отдаёт именно такие таблицы с датой публикации банка (rate_date) в каждом ответе; в выходные и праздники возвращается последняя опубликованная дата — именно этот курс требуют применять правила комплаенса.
Пары, которые банк не публикует напрямую, вычисляются из его таблицы (обратный или кросс-курс через VND) и явно помечаются "derived": true — опубликованное банком и вычисленное никогда не смешиваются.
Эндпоинты
GET /api/v1/central-bank/sbv/latest— последняя таблица или одна пара (все тарифы)GET /api/v1/central-bank/sbv/{YYYY-MM-DD}— таблица на любую дату (платные тарифы)GET /api/v1/central-bank/sbv/history— временной ряд, до 5 000 строк (платные тарифы)GET /api/v1/central-bank/sbv/availability— календарь публикаций: даты, на которые банк реально публиковал таблицу (все тарифы)
Полное описание параметров — в документации API. Каждый запрос учитывается в месячной квоте тарифа; курсы меняются раз в рабочий день, поэтому локальное кеширование опубликованной таблицы сильно экономит даже небольшую квоту.
Часто задаваемые вопросы
Есть ли API для курсов валют State Bank of Vietnam?
Да — этот. Официальные ежедневные курсы VND в чистом JSON; последняя таблица на любом тарифе, включая бесплатный.
Как часто обновляются курсы?
State Bank of Vietnam публикует курсы один раз в рабочий день; API загружает каждую новую таблицу вскоре после публикации (последняя: 2026-09-05).
Это официальные курсы?
Да — данные берутся из публикаций самого State Bank of Vietnam и отдаются без изменений с датой публикации банка. Всё вычисленное, а не опубликованное, помечается флагом derived.
Курсы State Bank of Vietnam — один API-ключ
Последняя таблица на любом тарифе. История с 2009 года на платных тарифах. Кредитная карта не нужна.
Получить бесплатный API-ключ Документация