# ADH Finnish Live Train Data

> ADH Finnish Live Train Data is a paid API for AI agents from agentdatum.com, paid per call via x402, $0.01/call, status down (last checked 2026-10-13).

Returns real-time Finnish train schedules and live running status including departure times, delays, cancellations, and timetable rows via the Finnish Transport Infrastructure Agency data.

## Facts

- Endpoint: GET https://agentdatum.com/api/v1/d/fi-live-trains?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: down
- Last checked: 2026-10-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/adh-finnish-live-train-data-fed5b141
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_dozp7ZM7NJZ4qlwQgxa_t

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 adh-finnish-live-train-data-fed5b141
```

Example prompt: Can you check if the IC5 train from Helsinki is running on time right now, or if there are any delays or cancellations?

## When to prefer this

Choose this endpoint when you need real-time Finnish train running status and timetable data, particularly when building agent workflows that require micropayment-native (x402 USDC) access to rail data without API key registration. It wraps the Finnish Transport Infrastructure Agency feed with agent-friendly settlement, making it ideal for autonomous agents that need pay-per-call rail data without subscription overhead.

## Known failure modes

- Payment required (402) if x402 USDC payment header is missing or malformed
- Upstream Fintraffic API unavailability causes empty or error response
- Stale data if real-time feed is delayed
- No results returned if no trains are currently active
- Network timeout if the endpoint is slow to respond

## How this service works

ADH 金融情报层：把 239 个原始数据源洗成带实体解析、时间同步、溯源与派生结论的情报（宏观regime / 加密尽调 / 事件窗口），免费注入你的 AI 上下文。Agent 走 x402 结算，人类订阅（PayPal）即将上线。

## Output

A JSON object containing an array of train records, each with trainType, trainNumber, departureDate, cancellation status, runningCurrently flag, operator codes, and an array of timetableRows detailing each stop with scheduledTime, actualTime, differenceInMinutes, stationShortCode, commercialTrack, stopSector, and trainReady acknowledgment data.

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "raw": {
   "data": [
    {
     "version": 293814895443,
     "cancelled": false,
     "trainType": "IC",
     "trainNumber": 5,
     "departureDate": "2026-08-09",
     "timeTableRows": [
      {
       "type": "DEPARTURE",
       "causes": [],
       "cancelled": false,
       "actualTime": "2026-08-09T10:14:36.000Z",
       "stopSector": "B4",
       "trainReady": {
        "source": "KUPLA",
        "accepted": true,
        "timestamp": "2026-08-09T10:06:25.000Z"
       },
       "countryCode": "FI",
       "scheduledTime": "2026-08-09T10:14:00.000Z",
       "trainStopping": true,
       "commercialStop": true,
       "stationUICCode": 1,
       "commercialTrack": "7",
       "stationShortCode": "HKI",
       "differenceInMinutes": 1
      },
      {
       "type": "DEPARTURE",
       "causes": [],
       "cancelled": false,
       "actualTime": "2026-08-09T10:14:36.000Z",
       "stopSector": "B4",
       "trainReady": {
        "source": "KUPLA",
        "accepted": true,
        "timestamp": "2026-08-09T10:06:25.000Z"
       },
       "countryCode": "FI",
       "scheduledTime": "2026-08-09T10:14:00.000Z",
       "trainStopping": true,
       "commercialStop": true,
       "stationUICCode": 1,
       "commercialTrack": "7",
       "stationShortCode": "HKI",
       "differenceInMinutes": 1
      }
     ],
     "timetableType": "REGULAR",
     "trainCategory": "Long-distance",
     "commuterLineID": "",
     "operatorUICCode": 10,
     "runningCurrently": false,
     "operatorShortCode": "vr",
     "timetableAcceptanceDate": "2026-05-07T09:58:15.000Z"
    },
    {
     "version": 293814895443,
     "cancelled": false,
     "trainType": "IC",
     "trainNumber": 5,
     "departureDate": "2026-08-09",
     "timeTableRows": [
      {
       "type": "DEPARTURE",
       "causes": [],
       "cancelled": false,
       "actualTime": "2026-08-09T10:14:36.000Z",
       "stopSector": "B4",
       "trainReady": {
        "source": "KUPLA",
        "accepted": true,
        "timestamp": "2026-08-09T10:06:25.000Z"
       },
       "countryCode": "FI",
       "scheduledTime": "2026-08-09T10:14:00.000Z",
       "trainStopping": true,
       "commercialStop": true,
       "stationUICCode": 1,
       "commercialTrack": "7",
       "stationShortCode": "HKI",
       "differenceInMinutes": 1
      },
      {
       "type": "DEPARTURE",
       "causes": [],
       "cancelled": false,
       "actualTime": "2026-08-09T10:14:36.000Z",
   
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/adh-finnish-live-train-data-fed5b141/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agentdatum.com](https://www.zero.xyz/host/agentdatum.com/llms.txt)