Skip to content

api-evangelist/sinay

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Sinay (sinay)

Sinay is a maritime data and analytics company whose Developers Platform exposes a marketplace of REST APIs for the shipping and ocean-tech industry - vessel and port lookup from combined satellite and terrestrial AIS, metocean (weather and ocean) conditions, per-voyage CO2 emissions modeled on the GLEC Framework, ETA prediction, live port congestion, sailing schedules, and underwater noise.

APIs.json: https://raw.githubusercontent.com/api-evangelist/sinay/refs/heads/main/apis.yml

Access Model (read this first)

  • Marketplace of per-product REST APIs. Every Sinay API is served over HTTPS from the single host api.sinay.ai, with each product mounted under its own versioned base path - e.g. https://api.sinay.ai/co2/api/v2 and https://api.sinay.ai/ports-vessels/api/v1.
  • One auth scheme everywhere. All endpoints require an API key sent in an API_KEY request header. Get a free key from the Sinay Developers Platform.
  • Per-API subscriptions / credits. Usage is metered as monthly API calls / API units (credits). Published tiers: a Free plan (~500 calls/month), a Pro plan (~10,000 calls/month), and a custom Enterprise plan, plus a no-credit-card free trial (~100 calls/month). Some endpoints consume more than one API unit per call. Each API reports its own consumption via a /usages endpoint (or /consumption on Port Congestion). Prices/currency are not reconciled here - confirm on the Developers Platform.
  • REST only. No public WebSocket API is documented. A separate Webhooks API (container-tracking / Safecube surface) pushes events via HTTP POST to a subscriber endpoint; it is out of scope for the five maritime APIs profiled here.

This entry profiles five of Sinay's maritime-data APIs. The Swagger index at api.sinay.ai/doc also lists live specs for underwater noise, sailing schedules, Safecube Ports Intelligence (beta), container tracking, webhooks, and Safecube - not profiled separately here.

Tags

  • Vessel Tracking
  • AIS
  • Maritime
  • Maritime Data
  • Weather
  • CO2 Emissions
  • Port Congestion
  • Ship Tracking
  • ETA
  • Ocean Data

Timestamps

  • Created: 2026-07-12
  • Modified: 2026-07-12

APIs

Sinay Ports and Vessels API

Look up vessels by name, MMSI, or IMO and ports by name or UN/LOCODE from Sinay's maritime reference data, built on combined satellite and terrestrial AIS.

Sinay Metocean API

Retrieve meteorological and oceanographic (weather and ocean) conditions for a geographic area and time window from a chosen model.

Sinay CO2 Emission API

Compute the CO2 emissions of a container voyage between two ports for a given vessel (IMO or MMSI), returning voyage length and tons of CO2 per TEU via a vessel-model method and a GLEC Framework tradelane method (WTT/TTW/WTW).

Sinay ETA API

Predict a vessel's estimated time of arrival to a destination port, routed from its latest AIS position or from a specified departure port and date.

Sinay Port Congestion API

Retrieve aggregated live port congestion data for a single port by UN/LOCODE or up to ten ports at once, plus credit-consumption reporting.

Artifacts

Common Properties

Grounding & Honesty Notes

  • Endpoints, methods, the API_KEY header security scheme, and the CO2 / ETA / congestion request-response shapes were transcribed from the live per-product Swagger files at https://api.sinay.ai/<product>/api/<version>/swagger.yaml (confirmed 2026-07-12).
  • In the consolidated OpenAPI, some response bodies (vessel/port records, metocean stations, ETA result, congestion aggregate) are represented as generic objects; the authoritative field-level schemas live in the upstream per-product Swagger.
  • Pricing (plans, finops) is modeled from public descriptions of the Developers Platform and marked reconciled: false; per-unit prices, currency, and per-endpoint credit weightings are unverified.

Maintainers

FN: Kin Lane Email: kin@apievangelist.com

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors