HKMA Daily Monetary Statistics Scraper
parseforge/hkma-hongkong-monetary-scraper
Developer toolsBusinessEducation
Scrapes daily monetary statistics from the Hong Kong Monetary Authority for a specified date range. Returns each day's figures as a flat row, exportable to CSV, JSON, Excel, or XML.
- Total users
- 2
- Monthly active
- 1
- Total runs
- 45
- Bookmarked
- 0
- Rating
- Not rated yet
- Last modified
- 9 days ago
Overview
HKMA Daily Monetary Statistics Scraper
Scrape HKMA daily monetary statistics for any date range, up to a million records per run. Each row includes the date, monetary aggregate, and all published figures, returned in a flat schema. No login or API key. Export to CSV, JSON, Excel, or XML.
The HKMA publishes daily monetary statistics that are essential for tracking Hong Kong's banking system, but the official website offers no bulk download and manual copying is error-prone. This Actor reads the public daily statistics pages directly, filters by date range, and returns each day's figures in one consistent row. It works for analysts, economists, and compliance teams who need clean time-series data without writing a scraper.
| Who uses it | What they scrape HKMA Hong Kong Monetary Authority for |
|---|---|
| Financial analysts | Monitoring daily changes in Hong Kong's monetary base and banking liquidity |
| Economic researchers | Building historical time series of monetary aggregates for econometric models |
| Compliance officers | Tracking daily monetary indicators for regulatory reporting and risk assessment |
| Data journalists | Pulling the latest monetary statistics to support stories on Hong Kong's economy |
What it does
This Actor collects HKMA daily monetary statistics for a specified date range and returns each day's figures as a flat row.
- ๐ Date range control: set fromDate and toDate to scrape any period, from a single day to years of history.
- ๐ข Volume cap: limit the number of daily records returned, from 10 for a quick preview to 1,000,000 for full archives.
- ๐ Flat output: every day's statistics are returned as one row with all published figures, ready for CSV, JSON, Excel, or XML export.
Results export to CSV, JSON, Excel, or XML, or straight from the API.
What you can do with HKMA Hong Kong Monetary Authority data
๐ Track monetary base trends.
An economist sets fromDate to the start of the quarter and toDate to today, then exports the daily monetary base to chart liquidity trends for a policy briefing.
๐งฎ Build a historical dataset.
A researcher scrapes five years of daily statistics with maxItems set to 1,000,000, then loads the CSV into Stata to run regressions on banking aggregates.
๐ Monitor daily liquidity.
A treasury analyst runs the Actor each morning for the previous day's figures and compares them against internal forecasts to flag unusual movements.
๐๏ธ Support news reporting.
A data journalist pulls the latest week of monetary statistics and uses the JSON output to create an interactive chart for an article on Hong Kong's banking sector.
Why choose this scraper
| What you get | |
|---|---|
| No API key needed | Access public HKMA data without registration or authentication |
| Bulk historical data | Pull years of daily statistics in a single run, not one page at a time |
| Consistent schema | Every row has the same fields, so you can merge runs without cleaning |
| Flexible export | Download as CSV, JSON, Excel, or XML for your existing workflow |
How it compares
No other Store actor targets HKMA Hong Kong Monetary Authority the same way, so the honest comparison is with the alternatives teams actually weigh.
| HKMA Daily Monetary Statistics Scraper | Build it in-house | By hand | |
|---|---|---|---|
| Setup | Run it now, zero config | Days of engineering | None, but hours per pull |
| When HKMA Hong Kong Monetary Authority changes | Maintained for you | You fix it | You re-learn the page |
| Proxies, retries, anti-bot | Built in | Your problem | Browser only |
| Output | Fixed JSON schema, CSV/Excel export | Whatever you build | Copy-paste |
| Cost | Pay per result | Engineering time | Analyst hours |
Configure the run
Drive the Actor with a fromDate and toDate, and set maxItems to cap the number of daily records returned. The scraper reads each day's page and returns only the dates you requested. The Input tab lists every parameter.
A first run with the defaults:
{
"fromDate": "2026-05-01",
"toDate": "2026-06-04",
"maxItems": 10
}
A larger pull:
{
"fromDate": "2026-05-01",
"toDate": "2026-06-04",
"maxItems": 200
}
Pricing
Pay-per-result: $0.0018 per result collected. You pay only for the results written to your dataset.
| Results collected | Approximate cost |
|---|---|
| 100 results | $0.18 |
| 1,000 results | $1.80 |
| 10,000 results | $18.00 |
New Apify accounts start with $5 in free credit.
Free users
Free-plan runs return up to 10 results as a preview. Upgrade your Apify plan to collect up to 1,000,000 results per run.
Run it
- Create a free Apify account with $5 in credit.
- Open the HKMA Daily Monetary Statistics Scraper.
- Set your inputs and any filters, then click Start.
- Export the results as CSV, Excel, JSON, or XML from the Dataset tab.
Run it programmatically through the Apify API (run-sync-get-dataset-items) or the ApifyClient for JavaScript and Python.
Use with AI agents (MCP)
Give an AI agent live access to HKMA Hong Kong Monetary Authority through the Model Context Protocol. Add the Actor to Claude, Cursor, or any MCP client:
claude mcp add --transport http apify "https://mcp.apify.com?tools=parseforge/hkma-hongkong-monetary-scraper"
Then prompt it in plain language to run the scraper and read back the results.
Troubleshooting
Why am I getting no results?
Check that your fromDate and toDate are in YYYY-MM-DD format and that the range includes dates when the HKMA published statistics. Also ensure maxItems is set to at least 1.
Why did the run stop before my toDate?
You likely hit the maxItems limit. Increase maxItems if you are a paid user, or narrow your date range to stay within the free preview limit of 10 records.
The output has fewer rows than expected.
Some dates may not have published statistics, or the HKMA page structure may have changed. Try a smaller date range to isolate the issue, and contact support if the problem persists.
Can I scrape data for a single day?
Yes. Set fromDate and toDate to the same date, and the Actor will return that day's statistics if available.
FAQ
| Question | Answer |
|---|---|
| What data does this Actor scrape? | It scrapes the daily monetary statistics published by the Hong Kong Monetary Authority, including monetary aggregates and related figures for each date in your range. |
| Do I need an API key or login? | No. The Actor reads the public HKMA daily statistics pages directly, so no registration or authentication is required. |
| How far back can I scrape? | You can set fromDate to any date for which the HKMA has published statistics. The Actor will attempt to retrieve every day in your range, subject to the maxItems limit. |
| What is the maximum number of records? | Free users are limited to 10 daily records for preview. Paid users can set maxItems up to 1,000,000, which covers many years of daily data. |
| What output formats are supported? | You can export the results as CSV, JSON, Excel, or XML directly from the Apify platform. |
| Can I schedule this Actor to run daily? | Yes. Use Apify's scheduler to run the Actor every day with toDate set to today, so you always have the latest statistics. |
| Does the Actor handle missing dates? | If the HKMA does not publish statistics for a particular date, that date will be skipped and the Actor will continue with the next available day. |
| Is the data returned in a consistent schema? | Yes. Every row has the same fields, so you can merge multiple runs without additional cleaning. |
Related actors
Browse the full ParseForge collection for more scrapers.
๐ Need help? Email parseforge@protonmail.com with your run ID, your input, and what you expected.
โ ๏ธ Disclaimer. This Actor is unofficial and is not affiliated with, endorsed by, or sponsored by Hong Kong Monetary Authority. It collects only publicly available data. You are responsible for using the collected data in compliance with the source's terms of service and applicable data-protection laws, including GDPR, CCPA, and PIPL. Do not use it to collect personal data unlawfully.
Input
| Field | Type | What it does | Default |
|---|---|---|---|
| fromDate | string | Earliest date to include, in YYYY-MM-DD format. HKMA daily figures start on 2002-01-02. Leave empty to start from the most recent business day. | 2026-05-01 |
| toDate | string | Latest date to include, in YYYY-MM-DD format. Leave empty to include the newest published figures. | 2026-06-04 |
| sortOrder | string (2 options) | Return the newest business day first (descending) or the oldest first (ascending). | desc |
| maxItems | integer | Free users: Limited to 10 items (preview). Paid users: Optional, max 1,000,000 | 10 |
Pricing
from $1.63 per 1,000 results
| Charged for | What it is | Price each |
|---|---|---|
| result | Single result in the default dataset. | $0.00163 to $0.0018 |
Tiered: the lower figure is the price on a higher Apify plan. Billing and the free credit live on Apify.
API
One POST returns the dataset directly. Same shape for every scraper in the library, so swapping the slug is the only change.
curl -X POST "https://api.apify.com/v2/acts/parseforge~hkma-hongkong-monetary-scraper/run-sync-get-dataset-items?token=$APIFY_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"helloWorld": 123
}' Examples
Input that runs as-is.
{
"helloWorld": 123
} Reviews
No reviews yet. Be the first.
Issues
We build and maintain this scraper, so a problem with it comes to us. Report it on the Apify listing and the thread stays attached to the scraper where the next person can find it: open an issue.
Broken and urgent, or you would rather not post in public? Write to parseforge@protonmail.com and it reaches the people who wrote it.
Related scrapers
Run HKMA Daily Monetary Statistics Scraper on Apify All scrapers
