Asset quality – Retail banks

API Detailed Documentation


API Data Enquiry

Output Fields (JSON) Swagger Format
Name Type Unit Of Measure Description
end_of_monthDateAs at end of
Year and Month in ISO format yyyy-mm, For example, 1997-01
pass_loansNumber%As % of total loans3
Pass loans
sp_ment_loansNumber%As % of total loans3
Special mention loans
cl_gross_substandardNumber%As % of total loans3
Classified loans (gross) Substandard
cl_gross_doubtfulNumber%As % of total loans3
Classified loans (gross) Doubtful
cl_gross_lossNumber%As % of total loans3
Classified loans (gross) Loss
cl_gross_totalNumber%As % of total loans3
Classified loans (gross) Total
cl_netNumber%As % of total loans3
Classified loans (net)4
loans_od3mNumber%As % of total loans3
Loans overdue > 3 months
loans_reschNumber%As % of total loans3
Rescheduled loans
loans_od3m_resch_totalNumber%As % of total loans3
Loans overdue > 3 months and rescheduled loans Total
nonperform_loansNumber%As % of total loans3
Non-performing loans5
cl_gross_mainland_lendNumber%As % of total Mainland-related lending Classified loans (gross) of Mainland-related lending6


1. Retail banks comprise all the locally incorporated banks plus a number of the larger foreign banks whose operations are similar to those of the locally incorporated banks in that they operate a branch network and are active in retail banking.
2. Figures relate to Hong Kong offices and overseas branches only unless otherwise stated.
3. There is a break in data series due to an expansion of coverage. Starting from December 2015, the coverage was expanded to include retail banks' major overseas subsidiaries in addition to Hong Kong offices and overseas branches.
4. Net of specific provisions/individual impairment allowances.
5. Loans on which interest has been placed in suspense or on which interest accrual has ceased. Information on non-performing loans are not available from January 2005 following adoption of the new Hong Kong Accounting Standard 39.
6. Figures cover retail banks' Hong Kong offices, Mainland branches and subsidiaries.

API Examples

Javascript Example

url: '',
alert('results found:'+ data.result.datasize)

Python Example

import urllib.request
url = ''
with urllib.request.urlopen (url) as req:
print (

How to use the APIs

To learn more, please visit API documentation.