---
title: "HKMA Exchange Rate API: Official HKD Rates as JSON"
description: "Official Hong Kong Monetary Authority daily exchange rates as JSON — ~19 currencies against the HKD, history back to 1981. REST + npm SDK, free tier included."
canonical: https://allratestoday.com/blog/hkma-exchange-rate-api/
source: AllRatesToday (https://allratestoday.com/) — Markdown mirror of the page above; index of all pages at https://allratestoday.com/llms.txt
generated: 2026-10-16T12:33:32.008Z
---

**Hong Kong Monetary Authority** publishes official exchange rates — ~19 currencies against the HKD — and these are the *published official rates* used for tax filings, audits, and compliant invoicing in Hong Kong, not moving market prices. This guide shows how to pull them as JSON: via a REST endpoint or the zero-dependency [`hkma-exchange-rate`](https://www.npmjs.com/package/hkma-exchange-rate) npm package, with history back to 1981.

  USD → HKD — official Hong Kong Monetary Authority daily reference rate Weekly observations, Aug '25 – Jul '26 · HKD per 1 USD

*Source: Hong Kong Monetary Authority published rates · chart data from the AllRatesToday API (`/api/v1/central-bank/hkma/history?source=USD&target=HKD`).*

## What the HKMA publishes

- **~19 currencies against the HKD**.
- **History back to 1981** — queryable by exact date or as a time series.
- **The bank's own publication date** on every response, so a rate is always citable.
- **No gaps to trip over** — requests for non-publication days resolve to the most recent published rates and are flagged explicitly.

The chart above is the Linked Exchange Rate System at work: the HKD trades in a tight 7.75–7.85 band per USD, and the official daily table documents it.

## Why official rates, not market rates

A live mid-market feed answers "what is USD/HKD 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 central bank's published rates, and it never changes after publication.

## Get the latest rates (REST)

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

The response is the bank’s most recent published table — one row per pair in its own quoting direction, the publication date (`rate_date`) and a freshness flag. Live example captured 2026-08-31:

```
{
  "bank": "hkma",
  "name": "Hong Kong Monetary Authority",
  "rate_date": "2026-08-31",
  "age_days": 40,
  "stale": false,
  "cadence": "monthly",
  "rates": [
    {"base": "AUD", "quote": "HKD", "type": "reference", "value": 5.612},
    {"base": "CAD", "quote": "HKD", "type": "reference", "value": 5.6395},
    {"base": "CHF", "quote": "HKD", "type": "reference", "value": 9.691},
    {"base": "CNY", "quote": "HKD", "type": "reference", "value": 1.16635},
    … 13 more rows
  ],
  "disclaimer": "Official rates as published by the named central bank. On weekends/holidays the most recent published rate_date is returned."
}
```

Most integrations need one pair. Add `source` and `target` and the API returns a single resolved rate — `derived: false` when Hong Kong Monetary Authority printed the pair itself:

```
curl "https://allratestoday.com/api/v1/central-bank/hkma/latest?source=USD&target=HKD" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

```
{
  "bank": "hkma",
  "name": "Hong Kong Monetary Authority",
  "rate_date": "2026-08-31",
  "source": "USD",
  "target": "HKD",
  "rate": 7.839,
  "rate_type": "reference",
  "derived": false,
  "method": "published",
  "age_days": 40,
  "stale": false,
  "cadence": "monthly",
  "disclaimer": "Official rates as published by the named central bank. On weekends/holidays the most recent published rate_date is returned."
}
```

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

## The npm SDK

```
npm install hkma-exchange-rate
```

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

// One pair at the official Hong Kong Monetary Authority rate
const pair = await getRate('USD', 'HKD', { 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 'hkma-exchange-rate';

// The official rates for an invoice date — non-publication days return
// the most recent published date, flagged via published_on_requested_date.
const day = await getRatesForDate('2026-06-30', { apiKey: 'art_live_...' });

// Time series for one pair
const series = await getHistory(
  { source: 'USD', target: 'HKD', from: '2026-01-01' },
  { apiKey: 'art_live_...' }
);
```

Historical dates and time series need a [paid plan](https://allratestoday.com/pricing/); the latest rates stay free.

## Published vs derived pairs

If the HKMA does not print a pair directly, the API resolves it from the bank's published rates — an inverse, or a cross rate via HKD — 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.

## FAQ

### Does Hong Kong Monetary Authority have an official exchange rate API?

Hong Kong Monetary Authority publishes its official rates on its website, but not always in a developer-friendly form. AllRatesToday serves the bank's published rates as clean JSON — ~19 currencies against the HKD, with history back to 1981 — via REST or the hkma-exchange-rate npm package. The latest table is free.

### How often do Hong Kong Monetary Authority rates update?

Once per business day. These are published reference rates, not moving market prices — the table changes when the bank publishes a new one, and every API response carries the bank's own publication date so you can cite it.

### Can I get the Hong Kong Monetary Authority rate for a past date, like an invoice date?

Yes. The /central-bank/hkma/rates-for-date endpoint returns the official rates for any date back to 1981. Non-publication days resolve to the most recent published date and are flagged, so your audit trail stays honest. Historical dates require a paid plan; latest rates are free.

## Official Hong Kong Monetary Authority rates, as JSON

The latest rates are free — 300 free requests, no credit card.

 [Get your free API key](https://allratestoday.com/register/)

## Related Articles

- [Hong Kong Monetary Authority rates API — product page](https://allratestoday.com/central-bank-rates-api/hkma/)
- [All covered central banks](https://allratestoday.com/central-bank-rates-api/)
- [Bank of Japan exchange rate API guide](https://allratestoday.com/blog/boj-exchange-rate-api/)
- [Bank of Israel exchange rate API guide](https://allratestoday.com/blog/boi-exchange-rate-api/)
- [Central bank API documentation](https://allratestoday.com/docs/#central-bank)
- [Best exchange rate APIs in 2026 — how the official-rate and market-rate providers compare](https://allratestoday.com/best/best-exchange-rate-api/)