Sinay · Rate Limits

Sinay Rate Limits

Sinay governs API usage primarily through a monthly call / API-unit (credit) allowance tied to the subscribed plan rather than by publishing fixed per-second or per-minute request caps. Each API exposes its own consumption reporting - a /usages endpoint (returning allCalls, successCalls, clientErrorCalls, serverErrorCalls, and consumedApiUnits per month) on the Ports & Vessels, Metocean, CO2, and ETA APIs, and /consumption/current-period and /consumption/periods on the Port Congestion API. Some endpoints consume more than one API unit per call, so the effective request ceiling depends on the per-endpoint credit weighting for the plan.

Sinay Rate Limits is the machine-readable rate-limit profile for Sinay on the APIs.io network, conforming to the API Commons Rate Limits specification.

It captures 3 rate-limit definitions, measuring api_units and requests.

The profile also includes 3 backoff/retry policies defined and response codes documented for unauthorized.

Tagged areas include Maritime, Maritime Data, Rate Limiting, and Quotas.

3 Limits
MaritimeMaritime DataRate LimitingQuotas

Limits

Monthly API Units / Calls account
api_units
per plan (free ~500/mo, Pro ~10,000/mo, Enterprise custom)
The dominant limit. Reported via each API's /usages consumedApiUnits or the congestion /consumption periods.
Per-Endpoint Credit Weighting endpoint
api_units
varies by endpoint
Some endpoints consume more than one API unit per call; consult the Developers Platform.
Fixed Request-Rate Cap account
requests
not published
No per-second/per-minute numeric rate cap documented in the per-product Swagger files.

Policies

Monthly Allowance
Usage is metered against the plan's monthly call / credit allowance rather than a rolling per-minute cap.
Consumption Reporting
Clients can self-monitor spend via each API's /usages endpoint or the congestion /consumption endpoints.
Backoff Strategy
Clients should implement retries with exponential backoff and handle 401 (auth) and error responses gracefully.

Sources