Hydra
Docs

How to activate, change, and cancel stream subscriptions.

Managing Subscriptions

Subscriptions are managed through the dashboard or directly via the API. Your active subscriptions determine which streams are included in your JWT scope.

Activating Subscriptions

From the dashboard, connect your wallet and toggle the streams you want. The dashboard shows your current token balance, what each stream requires, and which you're eligible for.

Via API:

POST https://api.hydra.app/subscriptions
Authorization: Bearer <jwt>
Content-Type: application/json

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

{
  "active": ["aircraft", "vessels", "cyber"],
  "eligible": ["aircraft", "vessels", "alerts", "cyber", "airspace", "signals"],
  "ineligible": ["markets", "social"],
  "reason": "Insufficient token balance for ineligible streams"
}

Viewing Active Subscriptions

GET https://api.hydra.app/subscriptions
Authorization: Bearer <jwt>

{
  "active": ["aircraft", "cyber"],
  "activatedAt": {
    "aircraft": 1710000000,
    "cyber": 1709950000
  }
}

Changing Subscriptions

Update your subscription list at any time. A new JWT is issued immediately — the old one is invalidated within 60 seconds.

PUT https://api.hydra.app/subscriptions
Authorization: Bearer <jwt>

{
  "streams": ["cyber", "alerts", "markets"]
}

Cancelling Subscriptions

Remove specific streams:

DELETE https://api.hydra.app/subscriptions
Authorization: Bearer <jwt>

{
  "streams": ["aircraft"]
}

Or remove all subscriptions:

DELETE https://api.hydra.app/subscriptions/all
Authorization: Bearer <jwt>
📋
Note

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