External liabilities and claims – Positions vis-a-vis Mainland China

API Detailed Documentation

API URL:

https://api.hkma.gov.hk/public/market-data-and-statistics/monthly-statistical-bulletin/banking/elc-pos-v-mc

Request Parameters (Mandatory)

Parameter Name Description
segment Used to indicate which sets of data are going to retrieve.
Format: segment=data segment name (new/old)
Example: segment=new
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
liability_bank_mainland_hkdNumberHK$ millionPosition vis-a-vis Mainland China
Liabilities to banks in Mainland China HK$2
liability_bank_mainland_fcNumberHK$ millionPosition vis-a-vis Mainland China
Liabilities to banks in Mainland China F.C.
claim_bank_mainland_hkdNumberHK$ millionPosition vis-a-vis Mainland China
Claims on banks in Mainland China HK$
claim_bank_mainland_fcNumberHK$ millionPosition vis-a-vis Mainland China
Claims on banks in Mainland China F.C.
liability_nbc_mainland_hkdNumberHK$ millionPosition vis-a-vis Mainland China
Liabilities to non-bank customers in Mainland China HK$
liability_nbc_mainland_fcNumberHK$ millionPosition vis-a-vis Mainland China
Liabilities to non-bank customers in Mainland China F.C.
claim_nbc_mainland_hkdNumberHK$ millionPosition vis-a-vis Mainland China
Claims on non-bank customers in Mainland China HK$
claim_nbc_mainland_fcNumberHK$ millionPosition vis-a-vis Mainland China
Claims on non-bank customers in Mainland China F.C.

Footnotes:

1. For positions from June 2015 onwards, the external liabilities and claims data are collected following the Bank for International Settlements' (BIS) Guidelines for Reporting the BIS International Banking Statistics issued in March 2013 (BIS Guidelines). The data are analysed according to the residence of counterparty. Some positions have been reclassified and are not directly comparable with positions before June 2015.
2. Incomplete data coverage for positions before December 2014 due to reporting gaps of authorized institutions.
3. External liabilities and claims are analysed by the address of the counterparty. This means, in the case a company with branches, the business address of the office with which the liabilities or claims were incurred and in the case of an individual, his/her home address.
4. Note that only quarterly figures are available prior to April 1994 while the monthly series are available since then.

API Examples

Javascript Example

$.ajax({
url: 'https://api.hkma.gov.hk/public/market-data-and-statistics/monthly-statistical-bulletin/banking/elc-pos-v-mc?offset=0',
dataType:'json',
success:function(data){
alert('results found:'+ data.result.datasize)
}
});

Python Example

import urllib.request
url = 'https://api.hkma.gov.hk/public/market-data-and-statistics/monthly-statistical-bulletin/banking/elc-pos-v-mc?offset=0'
with urllib.request.urlopen (url) as req:
print (req.read())

How to use the APIs

To learn more, please visit API documentation.