Org APIhkab.org.hk ↗
Access Hong Kong HIBOR interest settlement rates and HKD exchange rates from HKAB. All tenors, all currency pairs, daily history up to 31-day ranges.
What is the Org API?
This API exposes 4 endpoints covering HKAB-published HKD interest settlement rates (HIBOR) and opening indicative counter exchange rates. The get_hibor_rates endpoint returns numeric rates for all 8 standard tenors from Overnight through 12 Months for any given business date, while get_hibor_rates_range retrieves up to 31 consecutive calendar days of daily HIBOR data in a single call. Exchange rate responses include buying TT, buying OD, and selling rates per currency pair.
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 HKAB HKD Interest Settlement Rates (HIBOR) for a specific date. Returns rates for all standard tenors (Overnight through 12 Months). When no date parameters are supplied, returns the most recent available rates, automatically skipping weekends and holidays. Each rate is a percentage value. The publication_time reflects the official HKAB fixing time.
| Param | Type | Description |
|---|---|---|
| day | integer | Day (1-31). When omitted along with year and month, returns latest available rates. |
| year | integer | Year (e.g. 2026). When omitted along with month and day, returns latest available rates. |
| month | integer | Month (1-12). When omitted along with year and day, returns latest available rates. |
{
"type": "object",
"fields": {
"rates": "object mapping tenor names (Overnight, 1 Week, 2 Weeks, 1 Month, 2 Months, 3 Months, 6 Months, 12 Months) to numeric rate values as percentages",
"is_holiday": "boolean indicating whether the date is a holiday (rates may be null on holidays)",
"publication_date": "string in YYYY-MM-DD format indicating the rate publication date",
"publication_time": "string indicating time of publication (e.g. '11:15am')"
},
"sample": {
"data": {
"rates": {
"1 Week": 2.09685,
"1 Month": 2.67964,
"2 Weeks": 2.24018,
"2 Months": 2.7581,
"3 Months": 2.81185,
"6 Months": 2.95738,
"12 Months": 3.2131,
"Overnight": 2
},
"is_holiday": false,
"publication_date": "2026-06-10",
"publication_time": "11:15am"
},
"status": "success"
}
}About the Org API
HIBOR Rates
The get_hibor_rates endpoint accepts optional year, month, and day integers. When all three are omitted, it returns the most recently published rates, automatically resolving around weekends and public holidays. The response includes a rates object keyed by tenor name — Overnight, 1 Week, 2 Weeks, 1 Month, 2 Months, 3 Months, 6 Months, and 12 Months — plus publication_date (YYYY-MM-DD), publication_time (e.g. 11:15am), and an is_holiday boolean. On holidays, rate values may be null.
Historical HIBOR Range
The get_hibor_rates_range endpoint accepts required start_date and end_date strings in YYYY-MM-DD format. The span must not exceed 31 calendar days. It returns an array of daily records in chronological order, each containing the same tenor map and metadata fields as the single-date endpoint. Weekends are skipped automatically; holiday entries are included with is_holiday: true and potentially null rates.
Exchange Rates
The get_exchange_rates endpoint accepts an optional date parameter in YYYY-MM-DD format. It returns an exchange_rates array where each element carries a currency_code, selling_rate, buying_tt_rate, and buying_od_rate — all expressed as HKD per unit of the foreign currency. The response also includes a last_updated timestamp and an is_holiday flag.
Homepage Highlights
The get_homepage_highlights endpoint takes no parameters and returns a combined snapshot: hibor_highlights with all eight tenor rates and publication metadata, and exchange_rate_highlights filtered to seven major currencies (AUD, EUR, GBP, JPY, CNY, CNH, USD). This is useful when you need a quick market summary without making two separate calls.
The Org API is a managed, monitored endpoint for hkab.org.hk — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when hkab.org.hk changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official hkab.org.hk API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Display a live HIBOR rate dashboard showing all 8 tenors for the current Hong Kong business day
- Calculate floating-rate loan interest adjustments using monthly or 3-month HIBOR from
get_hibor_rates - Build a historical HIBOR chart by querying sequential 31-day windows with
get_hibor_rates_range - Show HKD buying and selling rates for major currencies in a retail banking app using
get_exchange_rates - Monitor HIBOR trend shifts across Overnight and 1-Month tenors over a rolling month
- Populate a financial widget with the latest HIBOR and FX snapshot in one call via
get_homepage_highlights - Flag holiday-adjusted rate gaps by reading the
is_holidayfield across a date range response
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does HKAB publish an official developer API for HIBOR and exchange rates?+
What does `get_hibor_rates_range` return for holidays within a range?+
is_holiday set to true. The rates object for those entries may contain null values for all tenors, since HKAB does not publish settlement rates on Hong Kong public holidays. Weekends are excluded entirely from the returned array.Does the exchange rates endpoint cover all currencies HKAB publishes?+
get_exchange_rates endpoint returns all currency pairs published by HKAB on a given date, including currency_code, selling_rate, buying_tt_rate, and buying_od_rate. The get_homepage_highlights endpoint is filtered to seven major currencies only. If HKAB adds or removes a currency pair, the response reflects that without a version change.Is historical HIBOR data available beyond a 31-day window?+
get_hibor_rates_range call is capped at 31 calendar days. Longer historical series are not returned in one response. You can page through history by making sequential calls with non-overlapping date ranges. You can also fork this API on Parse and revise it to add a dedicated longer-range aggregation endpoint.