- Reference
- 2026-09-30
- Actual
- 10
- Previous
- 11
- Forecast
- --
Hong Kong Residential mortgages written off over the past twelve months
The Residential mortgages written off over the past twelve months series for Hong Kong is a key macroeconomic indicator published monthly by the national statistics authority or the Hong Kong Monetary Authority. It is available via the FXMacroData API at /api/v1/announcements/hkd/mortgage_writeoffs_twelve_month.
- Latest
- 10 HKD million
- Change vs previous
- -1 HKD million
- Change vs year ago
- +5 HKD million
- Long-run average
- 1.51 HKD million
- Last updated
- Next release
- --
- Vs forecast
- --
- Revision
- None
In September 2026 (2026-09-30)
Previous 11 HKD million (-9.1%)
5 HKD million on Sep 30, 2025 (+100%)
100 readings since 2018; latest +8.49 HKD million vs average
Not yet on the official schedule
No forecast for the latest release
Unchanged since first published. History starts with the first stored release
Hong Kong / Mortgage Writeoffs Twelve Month
Understand the economy
Hong Kong's activity connects international merchandise trade with financial markets, inbound tourism and cross-boundary services. The government's economic-situation assessment in autumn 2026 identifies AI-related electronics trade as an importan...
How This Economy WorksRelease alerts
Get HKD Residential mortgages written off over the past twelve months alerts
Enter your account email. We will notify you when the next official-source HKD Residential mortgages written off over the past twelve months release is published.
Watch a 30-second Short on every major release: subscribe on YouTube
Why Residential mortgages written off over the past twelve months matters for HKD
Hong Kong's Residential mortgages written off over the past twelve months is monitored by the Hong Kong Monetary Authority when assessing the health of the economy and calibrating monetary policy. Surprises relative to consensus can move the hkd in the short term.
How to interpret this series
A reading above market expectations typically signals stronger-than-anticipated conditions and is broadly supportive of the hkd. A miss versus consensus can shift rate expectations and weigh on the hkd.
Check the publisher's unit, reference period and seasonal adjustment. Understand economic measurement terms before comparing this series with another country's measure.
What this data measures
Residential mortgages written off over the past twelve months is a published macroeconomic indicator covering one or more of the currencies supported by FXMacroData. Residential mortgages written off over the past twelve months in the Hong Kong Monetary Authority's monthly Residential Mortgage Survey, reported in HKD million. The survey population expands in December 2000. The table on this page shows the latest released value for every supported currency, the previous reading, the change between the two, the reference date, the publication frequency, the units, and the original publishing source.
How to read the release
Track year-over-year growth versus nominal GDP and against the central bank's broader inflation framework. Single-month moves are noisy; the trend over six to twelve months is the signal.
Historical Residential mortgages written off over the past twelve months
Source: Hong Kong Monetary Authority (HKMA). Cadence: Monthly. Unit: HKD million. Coverage metadata updating.
Recent announcements
Each release with its reference period, actual, previous and forecast figures.
| Release time | Reference period | Actual | Previous | Forecast | Detail |
|---|---|---|---|---|---|
| Time not published | 10 | 11 | -- | Announcement page | |
| Time not published | 11 | 12 | -- | Announcement page | |
| Time not published | 12 | 12 | -- | Announcement page | |
| Time not published | 12 | 13 | -- | Announcement page | |
| Time not published | 13 | 13 | -- | Announcement page | |
| Time not published | 13 | 12 | -- | Announcement page | |
| Time not published | 12 | 12 | -- | Announcement page | |
| Time not published | 12 | 10 | -- | Announcement page | |
| Time not published | 10 | 8 | -- | Announcement page | |
| Time not published | 8 | 6 | -- | Announcement page |
- Reference
- 2026-08-31
- Actual
- 11
- Previous
- 12
- Forecast
- --
- Reference
- 2026-07-31
- Actual
- 12
- Previous
- 12
- Forecast
- --
- Reference
- 2026-06-30
- Actual
- 12
- Previous
- 13
- Forecast
- --
- Reference
- 2026-05-31
- Actual
- 13
- Previous
- 13
- Forecast
- --
- Reference
- 2026-04-30
- Actual
- 13
- Previous
- 12
- Forecast
- --
- Reference
- 2026-03-31
- Actual
- 12
- Previous
- 12
- Forecast
- --
- Reference
- 2026-02-28
- Actual
- 12
- Previous
- 10
- Forecast
- --
- Reference
- 2026-01-31
- Actual
- 10
- Previous
- 8
- Forecast
- --
- Reference
- 2025-12-31
- Actual
- 8
- Previous
- 6
- Forecast
- --
Common questions
How this series is measured, published and used.
Where can I access historical Residential mortgages written off over the past twelve months data for Hong Kong?
Historical Residential mortgages written off over the past twelve months data for Hong Kong is available at /api/v1/announcements/hkd/mortgage_writeoffs_twelve_month.
How often is Hong Kong Residential mortgages written off over the past twelve months updated?
Residential mortgages written off over the past twelve months for Hong Kong is released on a monthly schedule by Hong Kong Monetary Authority (or the relevant national statistics agency). FXMacroData updates the series as official data becomes available. Publication times are included where they are known; planned, estimated and unavailable times are identified in the record's timing metadata.
What unit is Residential mortgages written off over the past twelve months reported in?
The series is published in HKD million. The exact unit is also returned on every API response under the indicator metadata.
Where does FXMacroData source Hong Kong Residential mortgages written off over the past twelve months data?
Data is fetched directly from Hong Kong Monetary Authority or the official national statistics publication for Hong Kong. The source URL is preserved on every announcement record so downstream consumers can trace the value back to its primary release.
What is the latest Hong Kong Residential mortgages written off over the past twelve months reading?
The latest Hong Kong Residential mortgages written off over the past twelve months reading is 10 HKD million in September 2026, released Sep 30, 2026 by Hong Kong Monetary Authority (HKMA). That is -1 HKD million against the previous reading of 11 HKD million.
How does Hong Kong Residential mortgages written off over the past twelve months compare with a year ago?
Hong Kong Residential mortgages written off over the past twelve months is +5 HKD million compared with a year earlier, when the reading was 5 HKD million (Sep 30, 2025).
Hong Kong Residential mortgages written off over the past twelve months API docs
Endpoint, parameters, response fields, data provenance and a working example for this series.
Endpoint coverage and contract
This page documents the exact request inputs, response fields, access model, and currently published history window for
/api/v1/announcements/hkd/mortgage_writeoffs_twelve_month.
Coverage metadata updating
Production OpenAPI schema: https://api.fxmacrodata.com/openapi.json
Official series ID: HKMA:residential-mortgage-survey:loan_wo_12mth_amt
USD is free without a key. All other currencies require an Individual API key.
Public USD endpoint — anonymous callers receive the most recent 90 days, and a release becomes readable 15 minutes after it is published (the response carries a `freemium_delay` object saying so). Send your key in the `X-API-Key` header to page through full stored USD history or to access any other currency. Date filters are applied before pagination. The default page size is 20 rows and the maximum is 100. Use either `page` or `offset`; when both are provided, `page` takes precedence. Broad windows should be traversed with `pagination.next_offset`, not split into custom shorter-window retries. If the selected series exists but a requested date window has no observations, the API returns 200 with an empty `data` array and a `no_data` object (`error_code` `NO_DATA_IN_REQUESTED_WINDOW`) carrying coverage dates, `recommended_start_date`, and `available_observation_count`; a 404 means the currency or indicator slug is wrong. Forecasts are served separately by /v1/predictions/hkd/mortgage_writeoffs_twelve_month; join via `announcement_id`.
Macroeconomic announcement and catalogue rows are normalized from official central-bank, national statistics, treasury, or government publisher releases. Responses expose publisher metadata via source, source_url, and provenance fields where available.
Responses expose source, source_url, provenance, and data_quality fields for source citation, timestamp completeness, stale-data flags, and point-in-time safety checks.
Path parameters
| Parameter | Required | Type | Description |
|---|---|---|---|
currency |
YES | string |
3-letter currency code. |
indicator |
YES | string |
Indicator slug. Use /v1/data_catalogue/{currency} to list available slugs per currency. |
Query parameters
| Parameter | Required | Format | Description |
|---|---|---|---|
start_date |
NO | string (YYYY-MM-DD) |
Earliest observation date to include. Date filters are applied before pagination. Authenticated requests page through full stored history when omitted; anonymous USD requests are limited to the most recent 90 days, delayed 15 minutes, and 100 no-key requests/day. |
end_date |
NO | string (YYYY-MM-DD) |
Latest observation date to include. Defaults to today. |
limit |
NO | integer |
Maximum number of most-recent-first rows to return per page. Defaults to 20; maximum 100. |
page |
NO | integer |
One-based page number. When supplied, page takes precedence over offset; page=2 with limit=20 is equivalent to offset=20. |
offset |
NO | integer |
Zero-based row offset after date filtering. Use with pagination.next_offset to request the next page. |
api_key |
Individual (USD: no-key 100/day) | string |
Legacy query-string form of the Individual API key, still accepted. Send the key in the X-API-Key header instead. A key is required for non-USD currencies, for real-time releases, and for USD requests that need history older than 90 days. |
Use start_date and end_date to narrow the series first, then page through the filtered result with limit plus either page or offset.
The default page size is 20 rows and the maximum is 100.
The response includes earliest_available_date, latest_available_date, and a pagination object with returned_count, total_count, has_more, next_offset, and page_includes_latest_available.
If the selected series exists but the requested date window has no rows, the endpoint returns 200 with an empty data array and a no_data object (error_code=NO_DATA_IN_REQUESTED_WINDOW) naming the coverage the series does have.
Response fields
| Field | Type | Description |
|---|---|---|
currency |
string |
3-letter currency code. |
indicator |
string |
Indicator slug as requested. |
has_official_forecast |
boolean |
True if the central bank publishes an official forecast for this indicator. |
start_date |
string |
Earliest date in the filtered result set (YYYY-MM-DD). |
end_date |
string |
Latest date in the filtered result set (YYYY-MM-DD). |
earliest_available_date |
string | null |
Earliest date available for this series before any date filter or pagination is applied. |
latest_available_date |
string | null |
Latest date available for this series before pagination is applied. |
requested_start_date |
string |
Start date applied to the request after endpoint defaults are resolved. |
requested_end_date |
string |
End date applied to the request after endpoint defaults are resolved. |
requested_window_has_data |
boolean |
False when the endpoint returned the latest eligible observation before the requested window instead of an observation inside the requested date range. |
page_includes_latest_available |
boolean |
True when the current page includes latest_available_date. False usually means the latest row is on a different page or the response is a historical page. |
pagination.limit |
integer |
Page size used for this response. |
pagination.offset |
integer |
Zero-based offset used for this response. |
pagination.returned_count |
integer |
Number of rows included in data[]. |
pagination.total_count |
integer |
Total number of rows matching the path and date filters before pagination. |
pagination.has_more |
boolean |
True when another page is available. |
pagination.next_offset |
integer | null |
Offset to use for the next page, or null when there are no more rows. |
pagination.page_includes_latest_available |
boolean |
Mirrors page_includes_latest_available inside the pagination envelope for clients that keep pagination state together. |
cb_target |
object | null |
Central bank target metadata (e.g. inflation target range), if applicable. |
data[].date |
string |
Observation date (YYYY-MM-DD). |
data[].announcement_id |
string |
Stable announcement identifier in the form `{currency}_{indicator}_{date}` — use it to join predictions from /v1/predictions/{currency}/{indicator} and revision history. |
data[].val |
number | null |
Observed value in the indicator's native unit. |
data[].announcement_datetime |
integer | null |
Unix timestamp (UTC) of the official data release. |
data[].release_time_assumed |
boolean | null |
Present and true when announcement_datetime was derived from the median publication lag measured on this series' confirmed releases, because no official release calendar reaches that period. Omitted on rows whose publication time was captured from the release. |
data[].pct_change |
number | null |
Period-over-period percentage change. |
data[].pct_change_12m |
number | null |
12-month rolling percentage change. |
data_quality |
object |
Standardized endpoint-level quality, source, freshness, and point-in-time safety metadata for the returned payload. |
data_quality.is_official |
boolean |
True when the response is backed by an official source and is not proxy, fallback, derived, or prohibited-source data. |
data_quality.is_proxy |
boolean |
True when the response is an explicit proxy for the requested concept rather than the primary official series. |
data_quality.is_fallback |
boolean |
True when one or more returned rows are marked as fallback data. |
data_quality.is_stale |
boolean |
True when the newest available observation is older than the endpoint's frequency-aware stale_after_days threshold. |
data_quality.has_announcement_datetime |
boolean |
True when all rows in the quality scope carry the required announcement timestamp field or fields. |
data_quality.point_in_time_safe |
boolean |
True only when every row in the quality scope carries a publication timestamp captured from the release itself, and the result is not fallback or prohibited-source data. One row with a missing or derived timestamp clears it for the whole response, so most full-history requests return false; gate a backtest on the per-row release_time_assumed flag. |
data_quality.has_assumed_release_times |
boolean |
True when at least one row in scope carries a publication timestamp derived from the series' measured publication lag rather than captured from the release. |
data_quality.assumed_release_time_count |
integer |
Number of rows in scope whose publication timestamp was derived. Compare against row_count to size the derived portion of the window. |
data_quality.latest_available_date |
string | null |
Freshest observation date available for the quality scope before pagination-specific caveats. |
data_quality.last_updated |
string | null |
Server-side refresh or update timestamp when the endpoint has one available. |
data_quality.data_lag_days |
integer | null |
Calendar-day lag between today and latest_available_date; null when the latest date is missing, invalid, or future-dated. |
data_quality.source_name |
string | null |
Human-readable source or publisher label used for the response. |
data_quality.source_type |
official | public | fallback | derived |
Normalized source classification shared across source-backed REST and MCP responses. |
data_quality.is_derived |
boolean |
True when the endpoint output is calculated from underlying source rows, such as spreads, slopes, forward curves, forecasts, or sentiment composites. |
data_quality.row_count |
integer |
Number of rows considered in the data-quality scope. |
data_quality.announcement_datetime_count |
integer |
Number of rows in scope with complete required announcement timestamp fields. |
data_quality.missing_announcement_datetime_count |
integer |
Number of rows in scope missing at least one required announcement timestamp field. |
data_quality.quality_scope |
string |
Scope used to compute the quality object, such as full_result, latest, recent, or scheduled_releases. |
data_quality.stale_after_days |
integer | null |
Frequency-aware threshold used for is_stale; daily=7, weekly=21, monthly=62, quarterly=125, annual=550 by default. |
source |
string |
Human-readable upstream publisher or source family for this response. |
source_url |
string | null |
Official publisher URL or source landing page when available. |
provenance |
object |
Structured provenance metadata including publisher, storage layer, served_by, timestamp field, and value field. |
source_series_name |
string | null |
Publisher's source-series label when FXMacroData stores one. |
source_local_name |
string | null |
Local-language or publisher-native series name when available. |
provenance.publisher |
string |
Official upstream publisher for the requested currency/indicator series. |
provenance.storage |
string |
FXMacroData serving storage layer for the returned payload. |
Example request and response
Example usage
To retrieve the first page of Hong Kong Residential mortgages written off over the past twelve months data from 2023:
GET https://api.fxmacrodata.com/v1/announcements/hkd/mortgage_writeoffs_twelve_month?start_date=2023-01-01&end_date=2023-12-31&limit=20&page=1
X-API-Key: YOUR_API_KEY
import requests
url = "https://api.fxmacrodata.com/v1/announcements/hkd/mortgage_writeoffs_twelve_month"
params = {
"start_date": "2023-01-01",
"end_date": "2023-12-31",
"limit": "20",
"page": "1",
}
headers = {"X-API-Key": "YOUR_API_KEY"}
response = requests.get(url, params=params, headers=headers, timeout=20)
response.raise_for_status()
payload = response.json()
print(payload.get("data", payload))