# SiteCheck Trade & Energy – Vessel Tracker (AIS)

> SiteCheck Trade & Energy – Vessel Tracker (AIS) is a paid API for AI agents from api.tradeenergy-api.workers.dev, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-29).

Returns live AIS position, speed, heading, and voyage details for a single vessel by MMSI, sourced from Finland's Digitraffic feed covering Finnish and Baltic waters.

## Facts

- Endpoint: GET https://api.tradeenergy-api.workers.dev/api/logistics/vessel-tracker?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/sitecheck-trade-energy-vessel-tracker-ais-0f62a30b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_cPwdfHDerzEM7i1w4jUci

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 sitecheck-trade-energy-vessel-tracker-ais-0f62a30b
```

Example prompt: Can you look up the current position, speed, and destination for the vessel with MMSI 230940690 — I need to know where it is right now and where it's headed in Finnish waters.

## When to prefer this

Choose this endpoint when you need real-time AIS vessel tracking specifically within Finnish or Baltic waters and have a 9-digit MMSI identifier. It is ideal for logistics workflows, port operations, or shipping monitoring in the Gulf of Finland or Baltic Sea region. Do not use it for global vessel tracking — vessels outside Finnish/Baltic coverage will return no data.

## Known failure modes

- Vessel outside Finnish/Baltic coverage area returns no position data
- Invalid or non-9-digit MMSI returns an error or empty result
- Vessel not currently transmitting AIS returns stale or missing data
- Unknown MMSI (vessel not in Digitraffic registry) returns null or error
- Upstream Digitraffic feed outage causes timeout or empty response

## How this service works

Live AIS position, speed, heading and voyage status (destination, ETA, draught) for one vessel by 9-digit MMSI, from Finland's Digitraffic AIS feed. Covers Finnish and Baltic waters only, not global coverage; vessels outside that area return no position.

## Output

A JSON object containing the vessel's MMSI, name, call sign, ship type, current latitude and longitude, speed in knots, course and heading in degrees, navigational status code, position timestamp, destination port, raw ETA value, draught in meters, the Digitraffic source URL, and the time the data was checked and last updated.

## 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": [
      "mmsi"
     ],
     "properties": {
      "mmsi": {
       "type": "string",
       "description": "9-digit MMSI of the vessel, e.g. 230940690"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "mmsi": 230940690,
  "name": "HM-61",
  "source": "https://meri.digitraffic.fi/api/ais/v1/",
  "voyage": {
   "etaRaw": 1596,
   "destination": "HELSINKI",
   "draughtMeters": 15
  },
  "callSign": "OJ8949",
  "position": {
   "lat": 60.212522,
   "lon": 25.184267,
   "courseDeg": 306,
   "navStatus": 0,
   "headingDeg": 309,
   "positionAt": "2026-10-23T09:37:50.443Z",
   "speedKnots": 2.1
  },
  "shipType": 51,
  "checkedAt": "2026-10-23T09:37:55.678Z",
  "dataUpdatedAt": "2026-10-23T09:37:50Z"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/sitecheck-trade-energy-vessel-tracker-ais-0f62a30b/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.tradeenergy-api.workers.dev](https://www.zero.xyz/host/api.tradeenergy-api.workers.dev/llms.txt)
