# Hong Kong MTR Realtime Next-Train Arrivals

> Hong Kong MTR Realtime Next-Train Arrivals is a paid API for AI agents from api.healthtravel-api.workers.dev, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-29).

Returns real-time next-train arrival times for a specific Hong Kong MTR station and line, including direction, destination platform, minutes to next train, and scheduled time.

## Facts

- Endpoint: GET https://api.healthtravel-api.workers.dev/api/travel/hk-mtr-realtime?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/hong-kong-mtr-realtime-next-train-arrivals-691049c1
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_N8-koQjt_oAomcN5MVrSA

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability hong-kong-mtr-realtime-next-train-arrivals-691049c1
```

Example prompt: How many minutes until the next train at Tung Chung station on the TCL line, and what's its destination?

## When to prefer this

Use this endpoint when you need real-time, live next-train data specifically for the Hong Kong MTR network, keyed by official MTR line and station codes. Prefer this over static timetable lookups when you need live countdowns (ttnt) rather than scheduled times, and over generic transit APIs when you need structured, low-latency data from the official Hong Kong government open data feed.

## Known failure modes

- Empty or missing data during late-night off-service hours
- Incorrect or unsupported line code returns an error or empty result
- Incorrect or unsupported station code for the given line returns an error or empty result
- Feed delays may cause stale or outdated timing data
- Rate limiting or payment failure at $0.002 USDC per call

## How this service works

Hong Kong MTR realtime next-train arrivals at one station on one line, from the Hong Kong government open data feed: direction, destination platform, minutes to next train (ttnt) and scheduled time. Times are the feed's; the feed can be delayed or empty late at night.

## Output

Returns structured data for upcoming MTR trains at the requested station and line: direction code, destination platform name, minutes to next train (ttnt), and the scheduled time of arrival/departure. Data is sourced from the Hong Kong government open data feed and may be delayed or empty during late-night hours when service is reduced.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "line",
      "sta"
     ],
     "properties": {
      "sta": {
       "type": "string",
       "description": "Station code on that line, e.g. TUM, HUH (2 to 4 letters)"
      },
      "line": {
       "type": "string",
       "description": "MTR line code, e.g. TML, TCL, ISL, KTL, TKL (2 to 4 letters)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/hong-kong-mtr-realtime-next-train-arrivals-691049c1/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.healthtravel-api.workers.dev](https://www.zero.xyz/host/api.healthtravel-api.workers.dev/llms.txt)
