hkab.org.hk APIhkab.org.hk ↗
Access Hong Kong HIBOR interest settlement rates and daily FX exchange rates from the Hong Kong Association of Banks via 3 structured API endpoints.
curl -X GET 'https://api.parse.bot/scraper/6130a648-a250-465f-bffe-a31e774b7f9a/get_hibor_rates?day=13&year=2026&month=5' \ -H 'X-API-Key: $PARSE_API_KEY'
Fetches the HKAB HKD Interest Settlement Rates (HIBOR) for a specific date. If no date parameters are provided, returns the latest available rates (skipping holidays and weekends).
| Param | Type | Description |
|---|---|---|
| day | integer | Day (1-31). |
| year | integer | Year (e.g. 2026). |
| month | integer | Month (1-12). |
{
"type": "object",
"fields": {
"rates": "object mapping tenor names to rate values (Overnight, 1 Week, 2 Weeks, 1 Month, 2 Months, 3 Months, 6 Months, 12 Months)",
"is_holiday": "boolean indicating whether the date is a holiday",
"publication_date": "string in YYYY-MM-DD format",
"publication_time": "string indicating time of publication (e.g. '11:15am')"
},
"sample": {
"data": {
"rates": {
"1 Week": 2.68649,
"1 Month": 2.7,
"2 Weeks": 2.68506,
"2 Months": 2.84714,
"3 Months": 2.90018,
"6 Months": 2.98815,
"12 Months": 3.16161,
"Overnight": 2.69548
},
"is_holiday": false,
"publication_date": "2026-05-13",
"publication_time": "11:15am"
},
"status": "success"
}
}About the hkab.org.hk API
This API exposes 3 endpoints covering HKAB-published HKD HIBOR interest settlement rates and opening indicative counter exchange rates. The get_hibor_rates endpoint returns all eight standard HIBOR tenors — from Overnight through 12 Months — for any given date, automatically skipping holidays and weekends when no date is specified. Exchange rate data covers buying and selling rates across multiple currencies, and a combined highlights endpoint delivers both rate sets in a single call.
HIBOR Rates
The get_hibor_rates endpoint accepts optional day, month, and year integers to target a specific date. The response includes a rates object keyed by tenor name (Overnight, 1 Week, 2 Weeks, 1 Month, 2 Months, 3 Months, 6 Months, 12 Months), alongside publication_date in YYYY-MM-DD format, publication_time (e.g. 11:15am), and an is_holiday boolean. When no date parameters are supplied, the endpoint returns the most recent business day, skipping weekends and Hong Kong public holidays automatically.
Exchange Rates
The get_exchange_rates endpoint accepts an optional date string in YYYY-MM-DD format. It returns an exchange_rates array where each entry carries currency_code, selling_rate, buying_tt_rate (telegraphic transfer), and buying_od_rate (on-demand). The response also includes the date, an is_holiday flag, and a last_updated timestamp. Omitting the date parameter returns the latest available day's rates.
Homepage Highlights
The get_homepage_highlights endpoint takes no inputs and returns a combined snapshot: hibor_highlights with all HIBOR tenors plus publication metadata, and exchange_rate_highlights filtered to seven major currencies — AUD, EUR, GBP, JPY, CNY, CNH, and USD. This is useful when you need a quick current-state overview without making multiple calls.
- Monitor daily HIBOR fixings across all eight tenors for loan pricing or interest rate benchmarking.
- Track HKD exchange rate movements against USD, EUR, CNY, and CNH for treasury reporting.
- Build an alert system that detects changes in the 1-Month or 3-Month HIBOR rates day-over-day.
- Populate a financial dashboard with the latest HIBOR and major FX rates from a single
get_homepage_highlightscall. - Retrieve historical HIBOR data for a specific date by passing
day,month, andyeartoget_hibor_rates. - Automate FX rate ingestion for accounting systems that require daily buying and selling rates per currency code.
- Verify whether a given date was a Hong Kong public holiday using the
is_holidayfield in either rates endpoint.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does HKAB provide an official developer API?+
What does `get_exchange_rates` return beyond the rate values?+
exchange_rates array includes currency_code, selling_rate, buying_tt_rate (telegraphic transfer buying rate), and buying_od_rate (on-demand buying rate). The parent response also carries the date, a last_updated timestamp, and an is_holiday boolean for that day.Does the API cover historical HIBOR rates beyond a single date lookup?+
get_hibor_rates endpoint returns data for one specified date per call — there is no built-in date range or batch query parameter. If you need to retrieve a series of dates you would need to call the endpoint once per date. You can fork this API on Parse and revise it to add a range-based endpoint if that pattern is needed.Are currencies beyond the seven major ones available through `get_homepage_highlights`?+
get_homepage_highlights returns exchange rates filtered to AUD, EUR, GBP, JPY, CNY, CNH, and USD only. The full currency list — which includes additional currencies published by HKAB — is available via get_exchange_rates. You can fork this API on Parse and revise the highlights endpoint to include additional currency codes if required.How does the API behave when requested date falls on a holiday or weekend?+
get_hibor_rates and get_exchange_rates return an is_holiday boolean in their response. When no date is supplied, get_hibor_rates automatically returns the latest available business day, skipping weekends and Hong Kong public holidays. Requesting a specific holiday date will reflect that in the is_holiday field rather than silently returning a neighbouring day's data.