Hong Kong Observatory
App · 15 actions
Get Hong Kong weather from the Hong Kong Observatory: current conditions, today's and the 9-day forecast, typhoon signals and other warnings, special weather tips, tides, sunrise and moonrise, the lunar date, lightning, visibility, daily weather reports and earthquakes. No account or API key is required.
Actions
| Action | What it does |
|---|---|
| Convert to lunar date | Turn a date into its Chinese lunar calendar date, with the lunar year's name and zodiac animal, and the lunar month and day as numbers. |
| Get 9-day forecast | Get the forecast for each of the next nine days: the weather, wind, high and low temperature and humidity, and the chance of significant rain. |
| Get current weather | Get Hong Kong's latest weather report: the temperature and humidity, the weather, the UV index, the past hour's rainfall in every district, and any warning messages. |
| Get daily weather and radiation report | Get a past day's weather and radiation report: each station's high and low temperature, humidity, rainfall, sunshine, UV and background radiation. |
| Get high and low tides | Get the predicted times and heights of high and low tide at a Hong Kong tide station, for one day or up to a month. |
| Get hourly tide heights | Get the predicted tide height at a Hong Kong tide station for every hour of a day, in metres above Chart Datum. |
| Get latest earthquake | Get the latest significant earthquake the Observatory has reported, anywhere in the world: its magnitude, region, location and time. |
| Get latest felt earthquake | Get the latest earthquake that was felt in Hong Kong: its magnitude, where it struck, how strongly it was felt locally, and the Observatory's report. |
| Get lightning count | Get how many lightning strokes were detected over Hong Kong in the latest hour, cloud-to-ground and cloud-to-cloud, and by region. |
| Get moonrise and moonset | Get the times of moonrise, moon transit and moonset in Hong Kong for one day or up to a month. |
| Get special weather tips | Get the Observatory's special weather tips, such as heavy rain announcements or an expected No. 8 signal, newest first. |
| Get sunrise and sunset | Get the times of sunrise, solar noon and sunset in Hong Kong, with the hours of daylight, for one day or up to a month. |
| Get today's forecast | Get the Observatory's local weather forecast for today (or tonight and tomorrow, later in the day), the general weather situation, the outlook for the next few days, and any tropical cyclone or fire danger notes. |
| Get visibility | Get the latest 10-minute mean visibility, in kilometres, at each of the Observatory's visibility stations. |
| Get weather warnings | Get every warning and signal in force in Hong Kong, such as typhoon signals, rainstorm, thunderstorm, very hot or cold weather and landslip warnings, with the Observatory's full text. |
Convert to lunar date
Turn a date into its Chinese lunar calendar date, with the lunar year's name and zodiac animal, and the lunar month and day as numbers.
Inputs
- Date
datedate - The day to look up. Leave empty for today in Hong Kong.
Outputs
datetextis_leap_monthtrue/falselunar_datetextlunar_daynumberlunar_monthnumberlunar_yeartextstem_branch_yeartextzodiactextzodiac_animaltext
Example output
{
"date": "2026-10-16",
"is_leap_month": false,
"lunar_date": "\u4e5d\u6708\u521d\u4e03",
"lunar_day": 7,
"lunar_month": 9,
"lunar_year": "\u4e19\u5348\u5e74\uff0c\u99ac",
"stem_branch_year": "\u4e19\u5348",
"zodiac": "\u99ac",
"zodiac_animal": "Horse"
}Get 9-day forecast
Get the forecast for each of the next nine days: the weather, wind, high and low temperature and humidity, and the chance of significant rain. Also gives the sea and soil temperatures.
Inputs
- Language
languagetext - The language the Observatory writes the text in.One of:
en(English),tc(Traditional Chinese),sc(Simplified Chinese). Default:en.
Outputs
day_countnumberdayslistgeneral_situationtextlanguagetextsea_temperature_cnumbersea_temperature_placetextsea_temperature_recorded_attextsoil_temperatureslistupdated_attexturltext
Example output
{
"day_count": 1,
"days": [
{
"date": "2026-10-16",
"day_of_week": "Friday",
"icon": 51,
"icon_description": "Sunny Periods",
"icon_url": "https://www.hko.gov.hk/images/HKOWxIconOutline/pic51.png",
"max_humidity_percent": 85,
"max_temp_c": 30,
"min_humidity_percent": 65,
"min_temp_c": 26,
"significant_rain_chance": "Low",
"weather": "Mainly fine at first. Sunny periods during the day.",
"wind": "East force 4, occasionally force 5."
}
],
"general_situation": "Under the influence of a fresh easterly airstream, it will be windier with one or two rain patches over the coast of Guangdong.",
"language": "en",
"sea_temperature_c": 28,
"sea_temperature_place": "North Point",
"sea_temperature_recorded_at": "2026-10-15T14:00:00+08:00",
"soil_temperatures": [
{
"depth_m": 0.5,
"place": "Hong Kong Observatory",
"recorded_at": "2026-10-15T07:00:00+08:00",
"temperature_c": 29.6
}
],
"updated_at": "2026-10-16T00:00:00+08:00",
"url": "https://www.hko.gov.hk/en/wxinfo/currwx/fnd.htm"
}Get current weather
Get Hong Kong's latest weather report: the temperature and humidity, the weather, the UV index, the past hour's rainfall in every district, and any warning messages. Pick a place for its own temperature and a district for its own rainfall.
Inputs
- Temperature at
placetext - The weather station whose temperature to give. Leave empty for the Hong Kong Observatory's own reading.
- Rainfall in district
districttext - The district whose rainfall to pick out. Every district's rainfall is listed either way.One of:
Central & Western District,Eastern District,Islands District,Kowloon City,Kwai Tsing,Kwun Tong,North District,Sai Kung,Sha Tin,Sham Shui Po, and 8 more. - Language
languagetext - The language the Observatory writes the text in.One of:
en(English),tc(Traditional Chinese),sc(Simplified Chinese). Default:en.
Outputs
districttextdistrict_rainfall_mmnumberhumidity_percentnumbericonnumbericon_descriptiontexticon_urltextlanguagetextlightning_placeslistmax_rainfall_districttextmax_rainfall_mmnumbermin_temp_midnight_to_9am_cnumberobserved_attextplacetextrainfalllistrainfall_january_to_last_month_mmnumberrainfall_last_month_mmnumberrainfall_midnight_to_noon_mmnumberrainfall_period_endtextrainfall_period_starttextrainstorm_remindertextspecial_weather_tipslisttemperature_cnumbertemperatureslisttropical_cyclone_messageslistupdated_attexturltextuv_indexnumberuv_leveltextuv_periodtextuv_placetextwarning_messageslist
Example output
{
"district": "Sha Tin",
"district_rainfall_mm": 0,
"humidity_percent": 74,
"icon": 51,
"icon_description": "Sunny Periods",
"icon_url": "https://www.hko.gov.hk/images/HKOWxIconOutline/pic51.png",
"language": "en",
"lightning_places": [],
"max_rainfall_district": "Sai Kung",
"max_rainfall_mm": 2,
"min_temp_midnight_to_9am_c": 25.8,
"observed_at": "2026-10-16T10:00:00+08:00",
"place": "Hong Kong Observatory",
"rainfall": [
{
"district": "Sai Kung",
"rainfall_mm": 2,
"under_maintenance": false
},
{
"district": "Sha Tin",
"rainfall_mm": 0,
"under_maintenance": false
}
],
"rainfall_january_to_last_month_mm": null,
"rainfall_last_month_mm": null,
"rainfall_midnight_to_noon_mm": null,
"rainfall_period_end": "2026-10-16T10:45:00+08:00",
"rainfall_period_start": "2026-10-16T09:45:00+08:00",
"rainstorm_reminder": null,
"special_weather_tips": [],
"temperature_c": 27,
"temperatures": [
{
"place": "King's Park",
"temperature_c": 26
},
{
"place": "Hong Kong Observatory",
"temperature_c": 27
}
],
"tropical_cyclone_messages": [],
"updated_at": "2026-10-16T10:02:00+08:00",
"url": "https://www.hko.gov.hk/en/wxinfo/currwx/current.htm",
"uv_index": 5,
"uv_level": "moderate",
"uv_period": "During the past hour",
"uv_place": "King's Park",
"warning_messages": []
}Get daily weather and radiation report
Get a past day's weather and radiation report: each station's high and low temperature, humidity, rainfall, sunshine, UV and background radiation. Each day's report comes out after 1:30 a.m. the next morning.
Inputs
- Date
datedate - The day to report on, from 10 September 2019. Leave empty for yesterday.
- Station
stationtext - Only this station. Leave empty for every station; the Hong Kong Observatory's own readings are also given on their own.One of:
HKO(Hong Kong Observatory),KP(King's Park),CLK(Chek Lap Kok),CCH(Cheung Chau),HPV(Happy Valley),HKP(Hong Kong Park),SE1(Kai Tak Runway Park),KAT(Kat O),KLT(Kowloon City),KTG(Kwun Tong), and 24 more. - Language
languagetext - The language the Observatory writes the text in.One of:
en(English),tc(Traditional Chinese),sc(Simplified Chinese). Default:en.
Outputs
languagetextnoteslistpublished_attextradiation_summarytextreport_datetextstationobjectstation_countnumberstationslist
Example output
{
"language": "en",
"notes": [
"The data displayed is provisional."
],
"published_at": "2026-10-16T00:15:00+08:00",
"radiation_summary": "Average ambient gamma radiation dose rate taken outdoors in Hong Kong ranged from 0.08 to 0.15 microsievert per hour.",
"report_date": "2026-10-15",
"station": {
"grass_min_temp_c": 23.7,
"max_humidity_percent": 77,
"max_temp_c": 29.7,
"max_uv_index": null,
"mean_uv_index": null,
"min_humidity_percent": 65,
"min_temp_c": 26.6,
"name": "Hong Kong Observatory",
"normal_rainfall_since_jan_1_mm": 2319.4,
"radiation_microsieverts_per_hour": null,
"rainfall_mm": 0,
"rainfall_since_jan_1_mm": 2529.3,
"rainfall_trace": false,
"station": "HKO",
"sunshine_hours": null
},
"station_count": 1,
"stations": [
{
"grass_min_temp_c": 23.7,
"max_humidity_percent": 77,
"max_temp_c": 29.7,
"max_uv_index": null,
"mean_uv_index": null,
"min_humidity_percent": 65,
"min_temp_c": 26.6,
"name": "Hong Kong Observatory",
"normal_rainfall_since_jan_1_mm": 2319.4,
"radiation_microsieverts_per_hour": null,
"rainfall_mm": 0,
"rainfall_since_jan_1_mm": 2529.3,
"rainfall_trace": false,
"station": "HKO",
"sunshine_hours": null
}
]
}Get high and low tides
Get the predicted times and heights of high and low tide at a Hong Kong tide station, for one day or up to a month.
Inputs
- Tide station
stationtext - Where to predict the tide. Quarry Bay is Victoria Harbour's reference station.One of:
QUB(Quarry Bay (Victoria Harbour)),CCH(Cheung Chau),CLK(Chek Lap Kok),CMW(Chi Ma Wan),KCT(Kwai Chung),KLW(Ko Lau Wan),LOP(Lok On Pai),MWC(Ma Wan),SPW(Shek Pik),TAO(Tai O), and 4 more. Default:QUB. - Date
datedate - The day to look up. Leave empty for today in Hong Kong.
- Number of days
daysnumber - How many days to cover, starting from the date. Defaults to 1.From 1 to 31. Default:
1.
Outputs
end_datetextfirst_high_tide_attextfirst_low_tide_attexthigh_tideslisthighest_mnumberlow_tideslistlowest_mnumberstart_datetextstationtextstation_nametexttide_countnumbertideslist
Example output
{
"end_date": "2026-10-16",
"first_high_tide_at": "2026-10-16T23:33:00+08:00",
"first_low_tide_at": "2026-10-16T06:51:00+08:00",
"high_tides": [
{
"date": "2026-10-16",
"height_m": 2.34,
"time": "2026-10-16T23:33:00+08:00",
"type": "high"
}
],
"highest_m": 2.34,
"low_tides": [
{
"date": "2026-10-16",
"height_m": 0.96,
"time": "2026-10-16T06:51:00+08:00",
"type": "low"
}
],
"lowest_m": 0.96,
"start_date": "2026-10-16",
"station": "QUB",
"station_name": "Quarry Bay (Victoria Harbour)",
"tide_count": 2,
"tides": [
{
"date": "2026-10-16",
"height_m": 0.96,
"time": "2026-10-16T06:51:00+08:00",
"type": "low"
},
{
"date": "2026-10-16",
"height_m": 2.34,
"time": "2026-10-16T23:33:00+08:00",
"type": "high"
}
]
}Get hourly tide heights
Get the predicted tide height at a Hong Kong tide station for every hour of a day, in metres above Chart Datum.
Inputs
- Tide station
stationtext - Where to predict the tide. Quarry Bay is Victoria Harbour's reference station.One of:
QUB(Quarry Bay (Victoria Harbour)),CCH(Cheung Chau),CLK(Chek Lap Kok),CMW(Chi Ma Wan),KCT(Kwai Chung),KLW(Ko Lau Wan),LOP(Lok On Pai),MWC(Ma Wan),SPW(Shek Pik),TAO(Tai O), and 4 more. Default:QUB. - Date
datedate - The day to look up. Leave empty for today in Hong Kong.
Outputs
datetextheightslisthighest_attexthighest_mnumberlowest_attextlowest_mnumberstationtextstation_nametext
Example output
{
"date": "2026-10-16",
"heights": [
{
"height_m": 2.28,
"time": "2026-10-16T01:00:00+08:00"
},
{
"height_m": 0.96,
"time": "2026-10-16T07:00:00+08:00"
},
{
"height_m": 2.34,
"time": "2026-10-16T23:00:00+08:00"
}
],
"highest_at": "2026-10-16T23:00:00+08:00",
"highest_m": 2.34,
"lowest_at": "2026-10-16T07:00:00+08:00",
"lowest_m": 0.96,
"station": "QUB",
"station_name": "Quarry Bay (Victoria Harbour)"
}Get latest earthquake
Get the latest significant earthquake the Observatory has reported, anywhere in the world: its magnitude, region, location and time.
Inputs
- Language
languagetext - The language the Observatory writes the text in.One of:
en(English),tc(Traditional Chinese),sc(Simplified Chinese). Default:en.
Outputs
foundtrue/falselanguagetextlatitudenumberlongitudenumbermagnitudenumberoccurred_attextregiontextupdated_attext
Example output
{
"found": true,
"language": "en",
"latitude": -5.45,
"longitude": 152.07,
"magnitude": 6,
"occurred_at": "2026-10-14T02:45:00+08:00",
"region": "in New Britain Region, Papua New Guinea",
"updated_at": "2026-10-14T03:03:00+08:00"
}Get latest felt earthquake
Get the latest earthquake that was felt in Hong Kong: its magnitude, where it struck, how strongly it was felt locally, and the Observatory's report.
Inputs
- Language
languagetext - The language the Observatory writes the text in.One of:
en(English),tc(Traditional Chinese),sc(Simplified Chinese). Default:en.
Outputs
detailstextfoundtrue/falseintensitytextlanguagetextlatitudenumberlongitudenumbermagnitudenumberoccurred_attextregiontextupdated_attext
Example output
{
"details": "Felt by some people in Hong Kong.",
"found": true,
"intensity": "III",
"language": "en",
"latitude": 23.9,
"longitude": 114.6,
"magnitude": 4.1,
"occurred_at": "2026-07-12T03:40:00+08:00",
"region": "Guangdong Heyuan",
"updated_at": "2026-07-12T04:05:00+08:00"
}Get lightning count
Get how many lightning strokes were detected over Hong Kong in the latest hour, cloud-to-ground and cloud-to-cloud, and by region.
Inputs
- Language
languagetext - The language the Observatory writes the text in.One of:
en(English),tc(Traditional Chinese),sc(Simplified Chinese). Default:en.
Outputs
cloud_to_cloud_countnumbercloud_to_ground_countnumberlanguagetextperiod_endtextperiod_starttextregionslisttotal_countnumber
Example output
{
"cloud_to_cloud_count": 30,
"cloud_to_ground_count": 12,
"language": "en",
"period_end": "2026-10-16T01:59:00+08:00",
"period_start": "2026-10-16T01:00:00+08:00",
"regions": [
{
"count": 9,
"region": "New Territories West",
"type": "cloud_to_ground",
"type_name": "Cloud-to-ground"
},
{
"count": 3,
"region": "Lantau",
"type": "cloud_to_ground",
"type_name": "Cloud-to-ground"
}
],
"total_count": 42
}Get moonrise and moonset
Get the times of moonrise, moon transit and moonset in Hong Kong for one day or up to a month. A time is empty on a day the moon does not rise or set.
Inputs
- Date
datedate - The day to look up. Leave empty for today in Hong Kong.
- Number of days
daysnumber - How many days to cover, starting from the date. Defaults to 1.From 1 to 31. Default:
1.
Outputs
datetextday_countnumberdayslistmoon_transittextmoonrisetextmoonsettext
Example output
{
"date": "2026-10-16",
"day_count": 1,
"days": [
{
"date": "2026-10-16",
"moon_transit": "2026-10-16T16:34:00+08:00",
"moonrise": "2026-10-16T11:14:00+08:00",
"moonset": "2026-10-16T21:55:00+08:00"
}
],
"moon_transit": "2026-10-16T16:34:00+08:00",
"moonrise": "2026-10-16T11:14:00+08:00",
"moonset": "2026-10-16T21:55:00+08:00"
}Get special weather tips
Get the Observatory's special weather tips, such as heavy rain announcements or an expected No. 8 signal, newest first.
Inputs
- Language
languagetext - The language the Observatory writes the text in.One of:
en(English),tc(Traditional Chinese),sc(Simplified Chinese). Default:en.
Outputs
has_tipstrue/falselanguagetextlatest_tiptexttip_countnumbertipslist
Example output
{
"has_tips": true,
"language": "en",
"latest_tip": "Announcement on Localised Heavy Rain: More than 70 millimetres of rainfall were recorded in Tuen Mun District in the past hour.",
"tip_count": 1,
"tips": [
{
"text": "Announcement on Localised Heavy Rain: More than 70 millimetres of rainfall were recorded in Tuen Mun District in the past hour.",
"updated_at": "2026-09-10T16:40:00+08:00"
}
]
}Get sunrise and sunset
Get the times of sunrise, solar noon and sunset in Hong Kong, with the hours of daylight, for one day or up to a month.
Inputs
- Date
datedate - The day to look up. Leave empty for today in Hong Kong.
- Number of days
daysnumber - How many days to cover, starting from the date. Defaults to 1.From 1 to 31. Default:
1.
Outputs
datetextday_countnumberdaylight_hoursnumberdayslistsolar_noontextsunrisetextsunsettext
Example output
{
"date": "2026-10-16",
"day_count": 1,
"daylight_hours": 11.63,
"days": [
{
"date": "2026-10-16",
"daylight_hours": 11.63,
"solar_noon": "2026-10-16T12:09:00+08:00",
"sunrise": "2026-10-16T06:20:00+08:00",
"sunset": "2026-10-16T17:58:00+08:00"
}
],
"solar_noon": "2026-10-16T12:09:00+08:00",
"sunrise": "2026-10-16T06:20:00+08:00",
"sunset": "2026-10-16T17:58:00+08:00"
}Get today's forecast
Get the Observatory's local weather forecast for today (or tonight and tomorrow, later in the day), the general weather situation, the outlook for the next few days, and any tropical cyclone or fire danger notes.
Inputs
- Language
languagetext - The language the Observatory writes the text in.One of:
en(English),tc(Traditional Chinese),sc(Simplified Chinese). Default:en.
Outputs
fire_danger_warningtextforecasttextforecast_periodtextgeneral_situationtextlanguagetextoutlooktexttropical_cyclone_infotextupdated_attexturltext
Example output
{
"fire_danger_warning": null,
"forecast": "Mainly fine at first. Sunny periods during the day. Temperatures will range between 26 and 30 degrees. Moderate easterly winds.",
"forecast_period": "Weather forecast for today",
"general_situation": "A fresh easterly airstream is affecting the coast of Guangdong.",
"language": "en",
"outlook": "One or two rain patches on Saturday. Fine and dry early next week.",
"tropical_cyclone_info": null,
"updated_at": "2026-10-16T01:45:00+08:00",
"url": "https://www.hko.gov.hk/en/wxinfo/currwx/flw.htm"
}Get visibility
Get the latest 10-minute mean visibility, in kilometres, at each of the Observatory's visibility stations.
Inputs
- Language
languagetext - The language the Observatory writes the text in.One of:
en(English),tc(Traditional Chinese),sc(Simplified Chinese). Default:en.
Outputs
languagetextlowest_visibility_kmnumberlowest_visibility_stationtextobserved_attextstation_countnumberstationslist
Example output
{
"language": "en",
"lowest_visibility_km": 17,
"lowest_visibility_station": "Central",
"observed_at": "2026-10-16T02:00:00+08:00",
"station_count": 2,
"stations": [
{
"station": "Central",
"visibility_km": 17
},
{
"station": "Chek Lap Kok",
"visibility_km": 27
}
]
}Get weather warnings
Get every warning and signal in force in Hong Kong, such as typhoon signals, rainstorm, thunderstorm, very hot or cold weather and landslip warnings, with the Observatory's full text. The typhoon signal and rainstorm colour are also given on their own, ready to check in a condition.
Inputs
- Language
languagetext - The language the Observatory writes the text in.One of:
en(English),tc(Traditional Chinese),sc(Simplified Chinese). Default:en.
Outputs
fire_danger_warningtexthas_warningstrue/falselanguagetextnameslistrainstorm_warningtextthunderstorm_warningtrue/falsetyphoon_signaltexttyphoon_signal_numbernumberupdated_attexturltextwarning_countnumberwarningslist
Example output
{
"fire_danger_warning": null,
"has_warnings": true,
"language": "en",
"names": [
"No. 8 Northeast Gale or Storm Signal"
],
"rainstorm_warning": null,
"thunderstorm_warning": false,
"typhoon_signal": "No. 8 Northeast Gale or Storm Signal",
"typhoon_signal_number": 8,
"updated_at": "2026-09-24T11:15:00+08:00",
"url": "https://www.hko.gov.hk/en/wxinfo/dailywx/wxwarntoday.htm",
"warning_count": 1,
"warnings": [
{
"action": "issued",
"code": "WTCSGNL",
"details": [
"The No. 8 Northeast Gale or Storm Signal was issued at 11:15 a.m."
],
"details_text": "The No. 8 Northeast Gale or Storm Signal was issued at 11:15 a.m.",
"expires_at": null,
"in_force": true,
"issued_at": "2026-09-24T11:15:00+08:00",
"level": "No. 8 Northeast Gale or Storm Signal",
"level_code": "TC8NE",
"name": "Tropical Cyclone Warning Signal",
"updated_at": "2026-09-24T11:15:00+08:00"
}
]
}