# Straits.live Premium Stream Session

> Straits.live Premium Stream Session is a paid API for AI agents from straits.live, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-15).

Purchases a short-lived signed token via micropayment that authenticates a real-time Server-Sent Events stream of Strait of Hormuz shipping, index, and event data.

## Facts

- Endpoint: POST https://straits.live/api/premium/stream/session
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/straits-live-premium-stream-session-a30db2ab
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_MO4fc2ojqnzQZqx8bwvqE

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 straits-live-premium-stream-session-a30db2ab -d '<json body>'
```

Example prompt: Start a live Straits.live premium stream session for real-time Strait of Hormuz shipping ticks and Hormuz Index moves — go ahead and authorize the $0.05 USDC payment to get the signed token.

## When to prefer this

Choose this endpoint when you need a continuous, push-based real-time feed of Strait of Hormuz data (vessel ticks, index moves, events) without polling overhead. It is ideal for latency-sensitive trading systems, automated risk monitors, or any agent that must react to Hormuz crisis developments as they happen rather than on a scheduled pull basis. Prefer over the snapshot REST endpoints when sustained streaming and instant event delivery are required.

## Known failure modes

- Payment failure or insufficient USDC balance returns a 402 Payment Required error
- Expired or invalid signed token results in 401 Unauthorized on the SSE endpoint
- Token used after its short TTL has elapsed returns 403 Forbidden
- Malformed POST body (missing required type or method fields) returns 400 Bad Request
- Network interruption drops the SSE connection, requiring a new session purchase

## How this service works

Buy a real-time stream session: one payment returns a short-lived signed token that authenticates a Server-Sent Events connection at /api/premium/stream, pushing Strait of Hormuz ticks, Hormuz Index moves, and events without polling.

## Output

Returns a short-lived signed session token that the caller uses to authenticate a persistent Server-Sent Events connection at /api/premium/stream, which then pushes real-time Strait of Hormuz vessel ticks, Hormuz Index price moves, and geopolitical/shipping events without any further polling.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "token": "...",
  "schema": "https://straits.live/api/premium/stream/session",
  "expiresAt": "2026-07-09T12:15:00Z",
  "streamUrl": "https://straits.live/api/premium/stream?token=..."
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/straits-live-premium-stream-session-a30db2ab/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from straits.live](https://www.zero.xyz/host/straits.live/llms.txt)
