API Detailed Documentation
API URL:
https://api.hkma.gov.hk/public/market-data-and-statistics/monthly-statistical-bulletin/gov-bond/out-amt-gov-bonds-remaining-tenor|
| |
| Output Fields (JSON) | Swagger Format |
| Name | Type | Unit Of Measure | Description |
|---|---|---|---|
| end_of_month | Date | As at end of Year and Month in ISO format yyyy-mm, For example, 1997-01 | |
| institutional_1y_or_below | Number | HK$ billion | Institutional Bond Issuance Programme 1 year or below |
| institutional_1yto3y | Number | HK$ billion | Institutional Bond Issuance Programme Over 1 year & up to 3 years |
| institutional_3yto5y | Number | HK$ billion | Institutional Bond Issuance Programme Over 3 years & up to 5 years |
| institutional_5yto7y | Number | HK$ billion | Institutional Bond Issuance Programme Over 5 years & up to 7 years |
| institutional_over7y | Number | HK$ billion | Institutional Bond Issuance Programme Over 7 years |
| institutional_subtotal | Number | HK$ billion | Institutional Bond Issuance Programme Sub-total |
| retail_1y_or_below | Number | HK$ billion | Retail Bond Issuance Programme 1 year or below |
| retail_1yto3y | Number | HK$ billion | Retail Bond Issuance Programme Over 1 year & up to 3 years |
| retail_3yto5y | Number | HK$ billion | Retail Bond Issuance Programme Over 3 years & up to 5 years |
| retail_5yto7y | Number | HK$ billion | Retail Bond Issuance Programme Over 5 years & up to 7 years |
| retail_subtotal | Number | HK$ billion | Retail Bond Issuance Programme Sub-total |
| total | Number | HK$ billion | Total |
Footnotes:
| Notes: In addition, the HKSAR Government issued three Islamic bonds under the Government Bond Programme, each with an issuance size of US$1 billion, on 18 September 2014 (Stock Code:4223), 3 June 2015 (Stock Code:4226) and 28 February 2017 (Stock Code:4233). The 2014 and 2015 issuances were 5-year tenors while the 2017 issuance was a 10-year tenor. |
API Examples
Javascript Example
$.ajax({url: 'https://api.hkma.gov.hk/public/market-data-and-statistics/monthly-statistical-bulletin/gov-bond/out-amt-gov-bonds-remaining-tenor?offset=0',dataType:'json',success:function(data){alert('results found:'+ data.result.datasize)}});
Python Example
import urllib.requesturl = 'https://api.hkma.gov.hk/public/market-data-and-statistics/monthly-statistical-bulletin/gov-bond/out-amt-gov-bonds-remaining-tenor?offset=0'with urllib.request.urlopen (url) as req:print (req.read())