Exchange Rate API for Hong Kong: HKAB Daily Rates, HKMA Figures, Bank TT Boards and Live HKD

One exchange rate API for Hong Kong: the official HKAB daily table with selling and TT buying rates, HKMA figures back to 1981, TT boards from HSBC and Bank of China (Hong Kong), and live HKD market rates for 160+ currencies. JSON, CSV, XLSX. Free key.

By Madhushan, Founder & Lead Developer ·

Hong Kong flag In one line: the official HKAB daily table, the HKMA figures back to 1981, TT boards from two Hong Kong banks and the live HKD market rate, from one REST API in JSON, CSV or Excel. Start with a free key. No card. 繁體中文

Hong Kong has two official exchange rate series and they do different jobs. The Hong Kong Association of Banks (HKAB) table is set every morning, with a selling and a buying side, and is the rate several ordinances name. The Hong Kong Monetary Authority (HKMA) figures give one rate per currency per day back to 1981, but are released monthly. This API returns both against the Hong Kong dollar, alongside bank boards and the live market rate.

Which HKD rate applies to what

NeedRate the rule points toSetEndpoint
Duty on dutiable goods (Cap. 109), cross-boundary cash declarations (Cap. 629)HKAB selling rateDaily, at the opening of business/api/v1/central-bank/hkab/latest
Salaries tax: income at a buying rate, expenses at a selling rateIRD average rates, or a dated buying or selling rateIRD averages monthly; HKAB daily/api/v1/central-bank/hkab/{date}
Profits tax return, HKAS 21 closing and average ratesA stated, consistent official rateHKMA figures, daily values released monthly/api/v1/central-bank/hkma/{date}
Stamp duty on foreign-currency considerationRate determined by the Monetary Authority (TT buying)Posted by HKEX each trading day for RMB and USDHKAB TT buying as a cross-check
Pricing, checkout, dashboards, FX exposureLive mid-market rateEvery 60 seconds/api/v1/rates

The official tables are read from the publisher's own page and never revised afterwards, so a figure fetched for a past date is the figure an auditor will find.

HKAB official daily table

HKAB is a statutory body, created by the Hong Kong Association of Banks Ordinance (Cap. 364). It sets its exchange rates once, at the opening of business. The API returns the selling rate, the telegraphic transfer buying rate and the middle of the two for 22 currencies, per one unit of foreign currency under ISO codes.

# Official HKAB table for today: selling, TT buying and middle rates
curl "https://allratestoday.com/api/v1/central-bank/hkab/latest" \
  -H "Authorization: Bearer art_live_your_key"
{
  "bank": "hkab",
  "rate_date": "2026-11-11",
  "cadence": "daily",
  "rates": [
    { "base": "USD", "quote": "HKD", "type": "tt_buy", "value": 7.8145 },
    { "base": "USD", "quote": "HKD", "type": "sell",   "value": 7.875 },
    { "base": "USD", "quote": "HKD", "type": "middle", "value": 7.84475 },
    { "base": "CNY", "quote": "HKD", "type": "tt_buy", "value": 1.1635 },
    { "base": "CNY", "quote": "HKD", "type": "sell",   "value": 1.1885 }
  ]
}

Where the law names this rate, and which day's table applies, is set out in HKAB exchange rates in Hong Kong law. In Google Sheets, one formula puts today's US dollar rows in a sheet:

=QUERY(IMPORTDATA("https://allratestoday.com/api/open/central-bank/hkab?format=csv"),
       "select * where Col2 = 'USD'", 1)

HKMA figures, 1981 to today

The HKMA series covers 17 currencies with one rate per day from 2 January 1981. It is released with the Monthly Statistical Bulletin, so it suits closing rates, period averages and prior years rather than anything dated this month. The US dollar column shows the Linked Exchange Rate System: HK$7.75 to 7.85 to one US dollar since 1983.

# HKMA figures: the table for a closing date
curl "https://allratestoday.com/api/v1/central-bank/hkma/2025-12-31" \
  -H "Authorization: Bearer art_live_your_key"

# a year of daily USD figures as CSV, for an average
curl "https://allratestoday.com/api/v1/central-bank/hkma/history?symbol=USD&from=2025-04-01&to=2026-03-31&format=csv" \
  -H "Authorization: Bearer art_live_your_key"

Year-end figures are on the closing rates page for 31 December 2025 and 31 March 2026, and the full series as CSV or Excel is covered in the HKMA history download guide.

Bank TT boards: HSBC and Bank of China (Hong Kong)

Trade declarations and day-to-day conversions run on a bank's own rate. The API reads the telegraphic transfer board of two Hong Kong banks several times a day and reports each rate with its spread.

# HSBC Hong Kong TT board, one currency
curl "https://allratestoday.com/api/open/bank-rates/hk/hsbchk?ccy=USD"
{
  "bank": "hsbchk",
  "name": "HSBC Hong Kong",
  "basis": "TT buy / sell",
  "bank_updated_at": "2026-11-12 05:44:25 +0800",
  "ccy": "USD",
  "buy": 7.8125,
  "sell": 7.8771,
  "mid": 7.8448,
  "spread_pct": 0.823
}

The three sets of figures are compared on one day in HSBC, Bank of China (Hong Kong) and the HKAB rate compared.

Live HKD market rates

For pricing and conversion the mid-market rate is refreshed every 60 seconds for HKD against 160+ currencies, in either direction. A free key covers it; add amount to get the converted figure in the same response.

# Live mid-market USD/HKD, refreshed every 60 seconds (free key)
curl "https://allratestoday.com/api/v1/rates?source=USD&target=HKD&amount=1000" \
  -H "Authorization: Bearer art_live_your_key"

The SDKs for JavaScript, Python, PHP, Go and Rust wrap the same call, and the hkab-exchange-rate package wraps the HKAB table.

Hong Kong rules that name a rate

These guides describe the rules as published; confirm the treatment for your facts with your accountant.

Endpoints used on this page

EndpointReturnsPlan
/api/v1/central-bank/hkab/latestToday's official HKAB tableFree
/api/v1/central-bank/hkma/latestLatest HKMA tableFree
/api/open/bank-rates/hk/{bank}A bank's TT board, one currency with ?ccy=Free
/api/v1/rates?source=&target=HKDLive mid-market rate, optional amountFree
/api/v1/central-bank/hkab/{date}The HKAB table for a past datePaid
/api/v1/central-bank/hkma/historyHKMA figures for any date rangePaid

Every table endpoint accepts &format=json|csv|xml|xlsx. The /api/open/ endpoints are CORS-open and can be called from a browser or a spreadsheet; the keyed ones are for servers. Full reference in the documentation.

Frequently asked questions

Which exchange rate should a Hong Kong business use?

It depends on the obligation. Duty on dutiable goods and cross-boundary cash declarations use the HKAB selling rate. Stamp duty uses a rate determined by the Monetary Authority. Salaries tax uses a buying rate for income and a selling rate for expenses, and the Inland Revenue Department posts average rates for salaries tax and profits tax. HKAS 21 asks for the transaction-date rate and the closing rate and names no source. Pricing and payments use the live market rate.

Does the HKMA publish a daily exchange rate?

The HKMA figures are daily in detail but are released monthly with the Monthly Statistical Bulletin, on the 3rd and 6th business days of each month. For a same-day official rate Hong Kong uses the table the Hong Kong Association of Banks sets at the opening of business.

What is in the HKAB table?

A selling rate and a telegraphic transfer buying rate for each currency, set at the opening of business. The API returns both, plus the middle of the two, for 22 currencies per one unit of foreign currency.

Which Hong Kong banks are covered?

HSBC Hong Kong and Bank of China (Hong Kong). Each board is read several times a day with its buying, selling and middle rates and the spread.

How far back does the history go?

The HKMA series starts on 2 January 1981 for 17 currencies. The HKAB archive in the API starts on 3 November 2026; the HKAB website keeps historical rates from November 2006.

Is there a free plan?

A free API key covers live rates and conversion, with no card. Dated tables and history need a paid plan, from €4.99 a month.

Start with the Hong Kong endpoints

Live HKD rates with a free key in 30 seconds.

Get a free API key See today's HKAB table