Prices and yields of Government Bonds issued under the Institutional Bond Issuance Programme – Period average figures

API Detailed Documentation

API URL:

https://api.hkma.gov.hk/public/market-data-and-statistics/monthly-statistical-bulletin/gov-bond/instit-bond-price-yield-periodaverage?segment=Benchmark

Request Parameters (Mandatory)

Parameter Name Description
segment Used to indicate which sets of data are going to retrieve.
Format: segment=data segment name (Benchmark/OutstandPrices/OutstandYields/MaturedPrices/MaturedYields)
Example: segment=Benchmark

Benchmark

Output Fields (JSON) Swagger Format
Name Type Unit Of Measure Description
end_of_monthDateEnd of period figures
Year and Month in ISO format yyyy-mm, For example, 1997-01
ind_pricing_2yNumberpercent per annumBenchmark yields
Indicative Pricings
2-year
ind_pricing_3yNumberpercent per annumBenchmark yields
Indicative Pricings
3-year
ind_pricing_5yNumberpercent per annumBenchmark yields
Indicative Pricings
5-year
ind_pricing_10yNumberpercent per annumBenchmark yields
Indicative Pricings
10-year
ind_pricing_15yNumberpercent per annumBenchmark yields
Indicative Pricings
15-year
closing_ref_rate_2yNumberpercent per annumBenchmark yields
Closing Reference Rates
2-year
closing_ref_rate_3yNumberpercent per annumBenchmark yields
Closing Reference Rates
3-year
closing_ref_rate_5yNumberpercent per annumBenchmark yields
Closing Reference Rates
5-year
closing_ref_rate_10yNumberpercent per annumBenchmark yields
Closing Reference Rates
10-year
closing_ref_rate_15yNumberpercent per annumBenchmark yields
Closing Reference Rates
15-year

OutstandPrices

Output Fields (JSON) Swagger Format
Name Type Unit Of Measure Description
end_of_monthDateEnd of period figures
Year and Month in ISO format yyyy-mm, For example, 1997-01
ind_pricing_10gb2001NumberIndicative Pricings
10GB2001
ind_pricing_05gb2002NumberIndicative Pricings
05GB2002
ind_pricing_05gb2011NumberIndicative Pricings
05GB2011
ind_pricing_10gb2108NumberIndicative Pricings
10GB2108
ind_pricing_05gb2205NumberIndicative Pricings
05GB2205
ind_pricing_10gb2301NumberIndicative Pricings
10GB2301
ind_pricing_10gb2408NumberIndicative Pricings
10GB2408
ind_pricing_10gb2601NumberIndicative Pricings
10GB2601
ind_pricing_10gb2706NumberIndicative Pricings
10GB2706
ind_pricing_10gb2901NumberIndicative Pricings
10GB2901
ind_pricing_15gb3007NumberIndicative Pricings
15GB3007
ind_pricing_15gb3203NumberIndicative Pricings
15GB3203
ind_pricing_15gb3403NumberIndicative Pricings
15GB3403
closing_ref_rate_10gb2001NumberClosing Reference Rates
10GB2001
closing_ref_rate_05gb2002NumberClosing Reference Rates
05GB2002
closing_ref_rate_05gb2011NumberClosing Reference Rates
05GB2011
closing_ref_rate_10gb2108NumberClosing Reference Rates
10GB2108
closing_ref_rate_05gb2205NumberClosing Reference Rates
05GB2205
closing_ref_rate_10gb2301NumberClosing Reference Rates
10GB2301
closing_ref_rate_10gb2408NumberClosing Reference Rates
10GB2408
closing_ref_rate_10gb2601NumberClosing Reference Rates
10GB2601
closing_ref_rate_10gb2706NumberClosing Reference Rates
10GB2706
closing_ref_rate_10gb2901NumberClosing Reference Rates
10GB2901
closing_ref_rate_15gb3007NumberClosing Reference Rates
15GB3007
closing_ref_rate_15gb3203NumberClosing Reference Rates
15GB3203
closing_ref_rate_15gb3403NumberClosing Reference Rates
15GB3403

OutstandYields

Output Fields (JSON) Swagger Format
Name Type Unit Of Measure Description
end_of_monthDateEnd of period figures
Year and Month in ISO format yyyy-mm, For example, 1997-01
ind_pricing_10gb2001Numberpercent per annumIndicative Pricings
10GB2001
ind_pricing_05gb2002Numberpercent per annumIndicative Pricings
05GB2002
ind_pricing_05gb2011Numberpercent per annumIndicative Pricings
05GB2011
ind_pricing_10gb2108Numberpercent per annumIndicative Pricings
10GB2108
ind_pricing_05gb2205Numberpercent per annumIndicative Pricings
05GB2205
ind_pricing_10gb2301Numberpercent per annumIndicative Pricings
10GB2301
ind_pricing_10gb2408Numberpercent per annumIndicative Pricings
10GB2408
ind_pricing_10gb2601Numberpercent per annumIndicative Pricings
10GB2601
ind_pricing_10gb2706Numberpercent per annumIndicative Pricings
10GB2706
ind_pricing_10gb2901Numberpercent per annumIndicative Pricings
10GB2901
ind_pricing_15gb3007Numberpercent per annumIndicative Pricings
15GB3007
ind_pricing_15gb3203Numberpercent per annumIndicative Pricings
15GB3203
ind_pricing_15gb3403Numberpercent per annumIndicative Pricings
15GB3403
closing_ref_rate_10gb2001Numberpercent per annumClosing Reference Rates
10GB2001
closing_ref_rate_05gb2002Numberpercent per annumClosing Reference Rates
05GB2002
closing_ref_rate_05gb2011Numberpercent per annumClosing Reference Rates
05GB2011
closing_ref_rate_10gb2108Numberpercent per annumClosing Reference Rates
10GB2108
closing_ref_rate_05gb2205Numberpercent per annumClosing Reference Rates
05GB2205
closing_ref_rate_10gb2301Numberpercent per annumClosing Reference Rates
10GB2301
closing_ref_rate_10gb2408Numberpercent per annumClosing Reference Rates
10GB2408
closing_ref_rate_10gb2601Numberpercent per annumClosing Reference Rates
10GB2601
closing_ref_rate_10gb2706Numberpercent per annumClosing Reference Rates
10GB2706
closing_ref_rate_10gb2901Numberpercent per annumClosing Reference Rates
10GB2901
closing_ref_rate_15gb3007Numberpercent per annumClosing Reference Rates
15GB3007
closing_ref_rate_15gb3203Numberpercent per annumClosing Reference Rates
15GB3203
closing_ref_rate_15gb3403Numberpercent per annumClosing Reference Rates
15GB3403

MaturedPrices

Output Fields (JSON) Swagger Format
Name Type Unit Of Measure Description
end_of_monthDateEnd of period figures
Year and Month in ISO format yyyy-mm, For example, 1997-01
ind_pricing_02gb1109NumberIndicative Pricings
02GB1109
ind_pricing_02gb1203NumberIndicative Pricings
02GB1203
ind_pricing_02gb1209NumberIndicative Pricings
02GB1209
ind_pricing_02gb1303NumberIndicative Pricings
02GB1303
ind_pricing_02gb1309NumberIndicative Pricings
02GB1309
ind_pricing_02gb1403NumberIndicative Pricings
02GB1403
ind_pricing_05gb1411NumberIndicative Pricings
05GB1411
ind_pricing_03gb1505NumberIndicative Pricings
03GB1505
ind_pricing_05gb1512NumberIndicative Pricings
05GB1512
ind_pricing_03gb1605NumberIndicative Pricings
03GB1605
ind_pricing_05gb1612NumberIndicative Pricings
05GB1612
ind_pricing_03gb1704NumberIndicative Pricings
03GB1704
ind_pricing_03gb1711NumberIndicative Pricings
03GB1711
ind_pricing_05gb1802NumberIndicative Pricings
05GB1802
ind_pricing_05gb1902NumberIndicative Pricings
05GB1902
closing_ref_rate_02gb1109NumberClosing Reference Rates
02GB1109
closing_ref_rate_02gb1203NumberClosing Reference Rates
02GB1203
closing_ref_rate_02gb1209NumberClosing Reference Rates
02GB1209
closing_ref_rate_02gb1303NumberClosing Reference Rates
02GB1303
closing_ref_rate_02gb1309NumberClosing Reference Rates
02GB1309
closing_ref_rate_02gb1403NumberClosing Reference Rates
02GB1403
closing_ref_rate_05gb1411NumberClosing Reference Rates
05GB1411
closing_ref_rate_03gb1505NumberClosing Reference Rates
03GB1505
closing_ref_rate_05gb1512NumberClosing Reference Rates
05GB1512
closing_ref_rate_03gb1605NumberClosing Reference Rates
03GB1605
closing_ref_rate_05gb1612NumberClosing Reference Rates
05GB1612
closing_ref_rate_03gb1704NumberClosing Reference Rates
03GB1704
closing_ref_rate_03gb1711NumberClosing Reference Rates
03GB1711
closing_ref_rate_05gb1802NumberClosing Reference Rates
05GB1802
closing_ref_rate_05gb1902NumberClosing Reference Rates
05GB1902

MaturedYields

Output Fields (JSON) Swagger Format
Name Type Unit Of Measure Description
end_of_monthDateEnd of period figures
Year and Month in ISO format yyyy-mm, For example, 1997-01
ind_pricing_02gb1109Numberpercent per annumIndicative Pricings
02GB1109
ind_pricing_02gb1203Numberpercent per annumIndicative Pricings
02GB1203
ind_pricing_02gb1209Numberpercent per annumIndicative Pricings
02GB1209
ind_pricing_02gb1303Numberpercent per annumIndicative Pricings
02GB1303
ind_pricing_02gb1309Numberpercent per annumIndicative Pricings
02GB1309
ind_pricing_02gb1403Numberpercent per annumIndicative Pricings
02GB1403
ind_pricing_05gb1411Numberpercent per annumIndicative Pricings
05GB1411
ind_pricing_03gb1505Numberpercent per annumIndicative Pricings
03GB1505
ind_pricing_05gb1512Numberpercent per annumIndicative Pricings
05GB1512
ind_pricing_03gb1605Numberpercent per annumIndicative Pricings
03GB1605
ind_pricing_05gb1612Numberpercent per annumIndicative Pricings
05GB1612
ind_pricing_03gb1704Numberpercent per annumIndicative Pricings
03GB1704
ind_pricing_03gb1711Numberpercent per annumIndicative Pricings
03GB1711
ind_pricing_05gb1802Numberpercent per annumIndicative Pricings
05GB1802
ind_pricing_05gb1902Numberpercent per annumIndicative Pricings
05GB1902
closing_ref_rate_02gb1109Numberpercent per annumClosing Reference Rates
02GB1109
closing_ref_rate_02gb1203Numberpercent per annumClosing Reference Rates
02GB1203
closing_ref_rate_02gb1209Numberpercent per annumClosing Reference Rates
02GB1209
closing_ref_rate_02gb1303Numberpercent per annumClosing Reference Rates
02GB1303
closing_ref_rate_02gb1309Numberpercent per annumClosing Reference Rates
02GB1309
closing_ref_rate_02gb1403Numberpercent per annumClosing Reference Rates
02GB1403
closing_ref_rate_05gb1411Numberpercent per annumClosing Reference Rates
05GB1411
closing_ref_rate_03gb1505Numberpercent per annumClosing Reference Rates
03GB1505
closing_ref_rate_05gb1512Numberpercent per annumClosing Reference Rates
05GB1512
closing_ref_rate_03gb1605Numberpercent per annumClosing Reference Rates
03GB1605
closing_ref_rate_05gb1612Numberpercent per annumClosing Reference Rates
05GB1612
closing_ref_rate_03gb1704Numberpercent per annumClosing Reference Rates
03GB1704
closing_ref_rate_03gb1711Numberpercent per annumClosing Reference Rates
03GB1711
closing_ref_rate_05gb1802Numberpercent per annumClosing Reference Rates
05GB1802
closing_ref_rate_05gb1902Numberpercent per annumClosing Reference Rates
05GB1902

Footnotes:

1. Figures powered by Thomson Reuters.
2. Calculation method and further information are set out in the Reference Manual for Government Bond Indicative Pricings
(http://www.hkgb.gov.hk/en/others/documents/IndicativePricings_Manual.pdf).

API Examples

Javascript Example

$.ajax({
url: 'https://api.hkma.gov.hk/public/market-data-and-statistics/monthly-statistical-bulletin/gov-bond/instit-bond-price-yield-periodaverage?segment=Benchmark&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/gov-bond/instit-bond-price-yield-periodaverage?segment=Benchmark&offset=0'
with urllib.request.urlopen (url) as req:
print (req.read())

How to use the APIs

To learn more, please visit API documentation.