API курсов валют Hong Kong Monetary Authority
Официальные ежедневные курсы Hong Kong Monetary Authority (Hong Kong) в формате JSON: 17 валют, история с 1981 года. Публикуемые курсы HKD для налоговой отчётности, аудита и выставления счетов.
О банке Hong Kong Monetary Authority
Гонконгское денежно-кредитное управление — центральный банковский институт Гонконга и оператор системы привязки гонконгского доллара к доллару США. Его открытый API публикует ежедневные курсы гонконгского доллара примерно к 19 валютам.
- Официальный сайт: www.hkma.gov.hk
- Официальная публикация курсов: Monthly Statistical Bulletin — daily exchange rates
Быстрый старт
Один запрос для нужной пары — USD к HKD по официальному курсу Hong Kong Monetary Authority:
curl "https://allratestoday.com/api/v1/central-bank/hkma/latest?source=USD&target=HKD" \
-H "Authorization: Bearer art_live_your_key" Или полная опубликованная таблица банка:
curl "https://allratestoday.com/api/v1/central-bank/hkma/latest" \
-H "Authorization: Bearer art_live_your_key" На платных тарифах — любая историческая дата или временной ряд:
curl "https://allratestoday.com/api/v1/central-bank/hkma/history?source=USD&target=HKD&from=2025-01-01" \
-H "Authorization: Bearer art_live_your_key" Последние опубликованные курсы (2026-07-31)
Самая свежая таблица, опубликованная Hong Kong Monetary Authority, — ровно то, что сейчас возвращает эндпоинт /latest. Значения указаны в HKD за 1 единицу каждой валюты:
Скачать таблицу: Excel (.xlsx) CSV (нужен бесплатный аккаунт)
| База | Котировка | Тип | Курс |
|---|---|---|---|
AUD | HKD | reference | 5.512 |
CAD | HKD | reference | 5.594 |
CHF | HKD | reference | 9.718 |
CNY | HKD | reference | 1.16275 |
EUR | HKD | reference | 9.03 |
GBP | HKD | reference | 10.5455 |
IDR | HKD | reference | 0.0004344 |
INR | HKD | reference | 0.0825 |
JPY | HKD | reference | 0.04887 |
KRW | HKD | reference | 0.00548 |
MYR | HKD | reference | 1.91825 |
PHP | HKD | reference | 0.1285 |
SGD | HKD | reference | 6.113 |
THB | HKD | reference | 0.23525 |
TWD | HKD | reference | 0.246 |
USD | HKD | reference | 7.8420000000000005 |
ZAR | HKD | reference | 0.4755 |
Клиент для Node.js / TypeScript
Отдельный npm-пакет без зависимостей оборачивает эти эндпоинты — hkma-exchange-rate:
npm install hkma-exchange-rate import { getRate } from 'hkma-exchange-rate';
const pair = await getRate('USD', 'HKD', { apiKey: 'art_live_...' });
console.log(pair.rate, pair.rate_date); Ноль зависимостей, типы TypeScript в комплекте; работает везде, где есть fetch — Node 18+, Bun, Deno и edge-среды.
Зачем нужен официальный курс Hong Kong Monetary Authority?
Рыночные курсы меняются непрерывно, но налоговая отчётность, таможенные декларации, аудит и бухгалтерский учёт (Hong Kong и не только) обычно требуют официальный курс, опубликованный Hong Kong Monetary Authority на конкретную дату — фиксированное число, на которое можно ссылаться и которое не меняется после публикации. Этот API отдаёт именно такие таблицы с датой публикации банка (rate_date) в каждом ответе; в выходные и праздники возвращается последняя опубликованная дата — именно этот курс требуют применять правила комплаенса.
Пары, которые банк не публикует напрямую, вычисляются из его таблицы (обратный или кросс-курс через HKD) и явно помечаются "derived": true — опубликованное банком и вычисленное никогда не смешиваются.
Эндпоинты
GET /api/v1/central-bank/hkma/latest— последняя таблица или одна пара (все тарифы)GET /api/v1/central-bank/hkma/{YYYY-MM-DD}— таблица на любую дату (платные тарифы)GET /api/v1/central-bank/hkma/history— временной ряд, до 5 000 строк (платные тарифы)GET /api/v1/central-bank/hkma/availability— календарь публикаций: даты, на которые банк реально публиковал таблицу (все тарифы)
Полное описание параметров — в документации API. Каждый запрос учитывается в месячной квоте тарифа; курсы меняются раз в рабочий день, поэтому локальное кеширование опубликованной таблицы сильно экономит даже небольшую квоту.
Часто задаваемые вопросы
Есть ли API для курсов валют Hong Kong Monetary Authority?
Да — этот. Официальные ежедневные курсы HKD в чистом JSON; последняя таблица на любом тарифе, включая бесплатный.
Как часто обновляются курсы?
Hong Kong Monetary Authority публикует курсы один раз в рабочий день; API загружает каждую новую таблицу вскоре после публикации (последняя: 2026-07-31).
Это официальные курсы?
Да — данные берутся из публикаций самого Hong Kong Monetary Authority и отдаются без изменений с датой публикации банка. Всё вычисленное, а не опубликованное, помечается флагом derived.
Курсы Hong Kong Monetary Authority — один API-ключ
Последняя таблица на любом тарифе. История с 1981 года на платных тарифах. Кредитная карта не нужна.
Получить бесплатный API-ключ Документация