Hydra
Docs

How to activate, change, and cancel stream subscriptions.

Managing Subscriptions

Subscriptions control which streams your app can access. Activate streams from the Platform dashboard or via the API — your API keys are then scoped to your active subscriptions.

Activating Streams

From the Platform dashboard, select your app and navigate to the Streams tab. Toggle on the streams you want. The dashboard shows your current token balance, tier, and which streams you're eligible for.

Via API:

POST https://api.hydra.fast/apps/:slug/subscriptions
Authorization: Bearer <privy-token>
Content-Type: application/json

{
  "streams": ["aircraft", "vessels", "cyber"]
}

{
  "active": ["aircraft", "vessels", "cyber"],
  "eligible": ["signals", "markets", "earthquakes", "aircraft", "vessels"],
  "tier": "standard"
}
Note

You can only activate streams your token tier supports. Requesting a stream above your tier returns 402 Payment Required.

Viewing Active Subscriptions

GET https://api.hydra.fast/apps/:slug/subscriptions
Authorization: Bearer <privy-token>

{
  "active": ["aircraft", "cyber"],
  "activatedAt": {
    "aircraft": "2026-03-20T10:00:00.000Z",
    "cyber": "2026-03-19T14:30:00.000Z"
  },
  "eligible": ["signals", "markets", "earthquakes", "aircraft", "vessels", "alerts", "airspace", "cyber"],
  "tier": "advanced"
}

Deactivating Streams

Remove specific streams:

DELETE https://api.hydra.fast/apps/:slug/subscriptions
Authorization: Bearer <privy-token>
Content-Type: application/json

{
  "streams": ["aircraft"]
}

Deactivating a stream immediately removes it from all existing API key scopes for that app. Active connections using those scopes will receive 403 Forbidden on subsequent requests.

Subscriptions & API Keys

Subscriptions and API keys are linked:

  • When you create an API key, you choose scopes from your app's active subscriptions
  • When you deactivate a stream, any API key scoped to that stream loses access
  • When you activate a new stream, existing keys are unaffected — create a new key or update scopes to include it
Tip

Activate all the streams you need before generating API keys. This way you can scope each key to exactly the streams it requires in a single step.

Balance Changes

Your token balance is checked hourly. If your balance drops below a tier threshold:

What happens When
Streams above your new tier stop working Next balance check (within 1 hour)
Active subscriptions remain in place Streams re-activate if balance is restored
API keys are not revoked Keys remain valid but scoped streams may return 402
Note

Deactivating subscriptions does not return tokens. Tokens are held in your wallet at all times — only the access grant changes.