Org 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.
What is the Org 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.
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'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace hkab-org-hk-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
from parse_apis.hkab_rates_api import HKAB, HiborRate, ExchangeRateSnapshot, MarketHighlight, ExchangeRateHighlight, ExchangeRate
hkab = HKAB()
# Get the latest HIBOR rates
hibor = hkab.hiborrates.get()
print(hibor.publication_date, hibor.publication_time, hibor.is_holiday)
for tenor, rate in hibor.rates.items():
print(tenor, rate)
# Get exchange rates for a specific date
snapshot = hkab.exchangeratesnapshots.get(date="2026-06-09")
print(snapshot.date, snapshot.is_holiday, snapshot.last_updated)
for fx in snapshot.exchange_rates:
print(fx.currency_code, fx.selling_rate, fx.buying_tt_rate, fx.buying_od_rate)
# Get combined market highlights
highlights = hkab.markethighlights.get()
print(highlights.hibor_highlights.publication_date, highlights.hibor_highlights.publication_time)
for fx in highlights.exchange_rate_highlights.rates:
print(fx.currency_code, fx.selling_rate)
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 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.
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?+
- 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 | 100 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.