One API to
track every vessel globally

1# Get real-time vessel position by MMSI
2curl -X GET "https://api.shipfinder.com/v1/vessel/position?mmsi=412345678" \
3     -H "Authorization: Bearer YOUR_API_KEY" \
4     -H "Accept: application/json"
5
6# Response
7{
8  "mmsi": 412345678,
9  "vessel_name": "HAI HONG 88",
10  "position": { "lat": 31.21, "lon": 121.50 },
11  "speed": 12.4,
12  "course": 87,
13  "destination": "CNSHA",
14  "eta": "2026-05-08T03:20:00Z",
15  "timestamp": "2026-05-07T12:34:11Z"
16}

1import { ShipFinder } from "@shipfinder/sdk";
2
3const client = new ShipFinder({ apiKey: process.env.SF_KEY });
4
5// Real-time position by MMSI
6const vessel = await client.vessel.position({ mmsi: 412345678 });
7console.log(vessel.position); // { lat: 31.21, lon: 121.50 }
8
9// Subscribe to geofence events via stream
10const stream = client.events.subscribe({
11  geofence: "port:CNSHA",
12  events: ["arrival", "departure"],
13});
14
15stream.on("event", (e) => {
16  console.log(`${e.vessel_name} ${e.type} at ${e.timestamp}`);
17});

1from shipfinder import ShipFinder
2
3client = ShipFinder(api_key="YOUR_API_KEY")
4
5# Historical track for any time window
6track = client.vessel.historical_track(
7    mmsi=412345678,
8    start="2026-04-01T00:00:00Z",
9    end="2026-05-01T00:00:00Z",
10)
11
12for point in track.points:
13    print(point.timestamp, point.lat, point.lon, point.speed)
14
15# Detect ship-to-ship transfers in a region
16sts = client.compliance.detect_sts(
17    bbox=[25.0, 55.0, 28.0, 58.0],   # Persian Gulf
18    since="2026-04-01",
19)