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

ActionWhat it does
Convert to lunar dateTurn 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 forecastGet 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 weatherGet 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 reportGet 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 tidesGet 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 heightsGet the predicted tide height at a Hong Kong tide station for every hour of a day, in metres above Chart Datum.
Get latest earthquakeGet the latest significant earthquake the Observatory has reported, anywhere in the world: its magnitude, region, location and time.
Get latest felt earthquakeGet 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 countGet 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 moonsetGet the times of moonrise, moon transit and moonset in Hong Kong for one day or up to a month.
Get special weather tipsGet the Observatory's special weather tips, such as heavy rain announcements or an expected No. 8 signal, newest first.
Get sunrise and sunsetGet 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 forecastGet 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 visibilityGet the latest 10-minute mean visibility, in kilometres, at each of the Observatory's visibility stations.
Get weather warningsGet 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

Datedatedate
The day to look up. Leave empty for today in Hong Kong.

Outputs

datetext
is_leap_monthtrue/false
lunar_datetext
lunar_daynumber
lunar_monthnumber
lunar_yeartext
stem_branch_yeartext
zodiactext
zodiac_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

Languagelanguagetext
The language the Observatory writes the text in.One of: en (English), tc (Traditional Chinese), sc (Simplified Chinese). Default: en.

Outputs

day_countnumber
dayslist
general_situationtext
languagetext
sea_temperature_cnumber
sea_temperature_placetext
sea_temperature_recorded_attext
soil_temperatureslist
updated_attext
urltext
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 atplacetext
The weather station whose temperature to give. Leave empty for the Hong Kong Observatory's own reading.
Rainfall in districtdistricttext
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.
Languagelanguagetext
The language the Observatory writes the text in.One of: en (English), tc (Traditional Chinese), sc (Simplified Chinese). Default: en.

Outputs

districttext
district_rainfall_mmnumber
humidity_percentnumber
iconnumber
icon_descriptiontext
icon_urltext
languagetext
lightning_placeslist
max_rainfall_districttext
max_rainfall_mmnumber
min_temp_midnight_to_9am_cnumber
observed_attext
placetext
rainfalllist
rainfall_january_to_last_month_mmnumber
rainfall_last_month_mmnumber
rainfall_midnight_to_noon_mmnumber
rainfall_period_endtext
rainfall_period_starttext
rainstorm_remindertext
special_weather_tipslist
temperature_cnumber
temperatureslist
tropical_cyclone_messageslist
updated_attext
urltext
uv_indexnumber
uv_leveltext
uv_periodtext
uv_placetext
warning_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

Datedatedate
The day to report on, from 10 September 2019. Leave empty for yesterday.
Stationstationtext
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.
Languagelanguagetext
The language the Observatory writes the text in.One of: en (English), tc (Traditional Chinese), sc (Simplified Chinese). Default: en.

Outputs

languagetext
noteslist
published_attext
radiation_summarytext
report_datetext
stationobject
station_countnumber
stationslist
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 stationstationtext
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.
Datedatedate
The day to look up. Leave empty for today in Hong Kong.
Number of daysdaysnumber
How many days to cover, starting from the date. Defaults to 1.From 1 to 31. Default: 1.

Outputs

end_datetext
first_high_tide_attext
first_low_tide_attext
high_tideslist
highest_mnumber
low_tideslist
lowest_mnumber
start_datetext
stationtext
station_nametext
tide_countnumber
tideslist
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 stationstationtext
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.
Datedatedate
The day to look up. Leave empty for today in Hong Kong.

Outputs

datetext
heightslist
highest_attext
highest_mnumber
lowest_attext
lowest_mnumber
stationtext
station_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

Languagelanguagetext
The language the Observatory writes the text in.One of: en (English), tc (Traditional Chinese), sc (Simplified Chinese). Default: en.

Outputs

foundtrue/false
languagetext
latitudenumber
longitudenumber
magnitudenumber
occurred_attext
regiontext
updated_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

Languagelanguagetext
The language the Observatory writes the text in.One of: en (English), tc (Traditional Chinese), sc (Simplified Chinese). Default: en.

Outputs

detailstext
foundtrue/false
intensitytext
languagetext
latitudenumber
longitudenumber
magnitudenumber
occurred_attext
regiontext
updated_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

Languagelanguagetext
The language the Observatory writes the text in.One of: en (English), tc (Traditional Chinese), sc (Simplified Chinese). Default: en.

Outputs

cloud_to_cloud_countnumber
cloud_to_ground_countnumber
languagetext
period_endtext
period_starttext
regionslist
total_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

Datedatedate
The day to look up. Leave empty for today in Hong Kong.
Number of daysdaysnumber
How many days to cover, starting from the date. Defaults to 1.From 1 to 31. Default: 1.

Outputs

datetext
day_countnumber
dayslist
moon_transittext
moonrisetext
moonsettext
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

Languagelanguagetext
The language the Observatory writes the text in.One of: en (English), tc (Traditional Chinese), sc (Simplified Chinese). Default: en.

Outputs

has_tipstrue/false
languagetext
latest_tiptext
tip_countnumber
tipslist
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

Datedatedate
The day to look up. Leave empty for today in Hong Kong.
Number of daysdaysnumber
How many days to cover, starting from the date. Defaults to 1.From 1 to 31. Default: 1.

Outputs

datetext
day_countnumber
daylight_hoursnumber
dayslist
solar_noontext
sunrisetext
sunsettext
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

Languagelanguagetext
The language the Observatory writes the text in.One of: en (English), tc (Traditional Chinese), sc (Simplified Chinese). Default: en.

Outputs

fire_danger_warningtext
forecasttext
forecast_periodtext
general_situationtext
languagetext
outlooktext
tropical_cyclone_infotext
updated_attext
urltext
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

Languagelanguagetext
The language the Observatory writes the text in.One of: en (English), tc (Traditional Chinese), sc (Simplified Chinese). Default: en.

Outputs

languagetext
lowest_visibility_kmnumber
lowest_visibility_stationtext
observed_attext
station_countnumber
stationslist
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

Languagelanguagetext
The language the Observatory writes the text in.One of: en (English), tc (Traditional Chinese), sc (Simplified Chinese). Default: en.

Outputs

fire_danger_warningtext
has_warningstrue/false
languagetext
nameslist
rainstorm_warningtext
thunderstorm_warningtrue/false
typhoon_signaltext
typhoon_signal_numbernumber
updated_attext
urltext
warning_countnumber
warningslist
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"
    }
  ]
}

On this page