# TariffMonkee Taiwan Transit Check

> TariffMonkee Taiwan Transit Check is a paid API for AI agents from tariffmonkee.com, paid per call via x402, $0.05/call, status unknown (last checked 2026-10-28).

Returns real-time Taiwan transit data (bus arrival predictions, TRA rail live board, THSR high-speed rail train info, and MRT arrival boards) for a given stop, route, or station via TDX.

## Facts

- Endpoint: GET https://tariffmonkee.com/paid/tw-transit-check?utm_source=zero.xyz
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-28
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/tariffmonkee-taiwan-transit-check-8c2e3a31
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Obaxrkn_Kj-TxFdA5Crv-

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 tariffmonkee-taiwan-transit-check-8c2e3a31
```

Example prompt: What are the next bus arrivals for route 紅56 in Taipei right now — and has any bus already passed my stop?

## When to prefer this

Use this endpoint when you need real-time Taiwan public transit arrival data — specifically bus predictions, TRA live boards, THSR daily train info, or MRT arrival boards — without needing journey planning or routing. Prefer this over direct TDX API calls when you want a simplified, paid-per-call interface that handles TDX authentication. Not suitable for trip planning, fare calculation, or transit outside Taiwan.

## Known failure modes

- Missing required mode parameter returns an error
- Missing city or route_name for bus mode returns an error
- Missing station_id for TRA or THSR mode returns an error
- Missing rail_system for MRT mode returns an error
- Invalid city code or route name not found in TDX returns empty results or TDX error
- TDX upstream outage causes failure or stale data
- estimate_seconds of -1 indicates bus already passed (not an error)
- Station ID must be looked up separately via TDX's own station endpoints

## How this service works

Taiwan real-time transit via TDX: bus arrival predictions, TRA rail live board, THSR high-speed rail daily train info, and MRT arrival boards (Taipei, Kaohsiung, Taoyuan, Kaohsiung Light Rail) for a given stop, route or station. Passes TDX data through and does not plan journeys. A bus estimate of -1 means the bus already passed. TRA, THSR and MRT return TDX's raw fields.

## Output

Returns a JSON object with mode, count, and a results array. For bus mode: each item includes stop_name, route_name, plate_number, estimate_seconds (seconds until arrival; -1 means already passed), already_passed boolean, next_bus_time, stop_sequence, and update_time. For TRA, THSR, and MRT modes: raw TDX fields are passed through covering train IDs, arrival/departure times, platform info, and station names. Also includes data_note, attribution, disclaimer, sources, and verified_on metadata fields.

## 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": [
      "mode"
     ],
     "properties": {
      "city": {
       "type": "string",
       "description": "Required for mode=bus. TDX city code, e.g. 'Taichung', 'Kaohsiung', 'Taipei'."
      },
      "mode": {
       "type": "string",
       "description": "'bus', 'tra', 'thsr', or 'mrt'."
      },
      "route_name": {
       "type": "string",
       "description": "Required for mode=bus. Route name as TDX has it, e.g. '紅56'."
      },
      "station_id": {
       "type": "string",
       "description": "Required for mode=tra or mode=thsr. Look up via TDX's own /v2/Rail/TRA/Station or /v2/Rail/THSR/Station."
      },
      "rail_system": {
       "type": "string",
       "description": "Required for mode=mrt. One of: TRTC (Taipei), KRTC (Kaohsiung), TYMC (Taoyuan), KLRT (Kaohsiung Light Rail)."
      },
      "station_name": {
       "type": "string",
       "description": "Optional for mode=mrt, to filter to one station. Omit to get the whole system's board (capped at 50 rows)."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "mode",
      "results",
      "count",
      "data_note",
      "attribution",
      "disclaimer",
      "sources",
      "verified_on"
     ],
     "properties": {
      "mode": {
       "type": "string"
      },
      "count": {
       "type": "number"
      },
      "results": {
       "type": "array",
       "items": {
        "type": "object",
        "required": [
         "stop_name",
         "route_name",
         "plate_number",
         "estimate_seconds",
         "already_passed",
         "next_bus_time",
         "stop_sequence",
         "update_time"
        ],
        "properties": {
         "stop_name": {
          "type": "string"
         },
         "route_name": {
          "type": "string"
         },
         "update_time": {
          "type": "string"
         },
     
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "mode": "bus",
  "count": 65,
  "results": [
   {
    "stop_name": "大學十七街口",
    "route_name": "紅56科技幹線",
    "update_time": "2026-10-18T16:07:50+08:00",
    "plate_number": "916-V2",
    "next_bus_time": "2026-10-18T16:20:00+08:00",
    "stop_sequence": 2,
    "already_passed": false,
    "estimate_seconds": 780
   },
   {
    "stop_name": "援中國小(大學26街口)",
    "route_name": "紅56科技幹線",
    "update_time": "2026-10-18T16:07:50+08:00",
    "plate_number": "KKA-9161",
    "next_bus_time": "2026-10-18T16:22:00+08:00",
    "stop_sequence": 4,
    "already_passed": false,
    "estimate_seconds": 0
   },
   {
    "stop_name": "大學東路口",
    "route_name": "紅56科技幹線",
    "update_time": "2026-10-18T16:07:50+08:00",
    "plate_number": "KKA-9161",
    "next_bus_time": "2026-10-18T16:26:00+08:00",
    "stop_sequence": 8,
    "already_passed": false,
    "estimate_seconds": 180
   }
  ],
  "sources": [
   {
    "url": "https://tdx.transportdata.tw",
    "name": "TDX 運輸資料流通服務 (Transport Data eXchange)"
   },
   {
    "url": "https://motc-ptx.gitbook.io/tdx-zi-liao-shi-yong-kui-hua-bao-dian/data_notice/public_transportation_data/bus_dynamic_data",
    "name": "TDX API usage notice -- bus real-time data caveats"
   }
  ],
  "data_note": "TDX retains at most the last 2 hours of estimate data per stop, specifically because some county source systems don't update reliably -- a route with no results may simply be outside its operating hours. estimate_seconds is null and already_passed is true when the bus has already passed this stop (T...",
  "disclaimer": "Passes through TDX's own real-time data for the specific stop/route/station requested -- this does not plan a journey or compute a route. Only the transit operator's own real-time systems are authoritative for a specific departure.",
  "attribution": "資料介接「交通部TDX平臺」(Data via Ministry of Transportation and Communications TDX Platform), per the Government Open Data License v1. Logo: https://tdx.transportdata.tw/images/tdxlogo.png",
  "verified_on": "2026-09-08"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/tariffmonkee-taiwan-transit-check-8c2e3a31/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from tariffmonkee.com](https://www.zero.xyz/host/tariffmonkee.com/llms.txt)