Skip to main content
This feature is available on all plans with WebSocket access.

Overview

Subscription tags let you categorize your WebSocket subscriptions by purpose (e.g., “majors”, “long tail”, “defi”) and see a breakdown of usage and credits consumption by tag in the dashboard. Without tags, usage is only broken down by endpoint or by individual API key. Tags give you a third dimension — grouping subscriptions into logical categories across any WebSocket endpoint.

How It Works

Add an optional tag field (max 50 characters) to the payload of any WebSocket subscription message. The tag is tracked per event and aggregated in the usage dashboard under the “By Tag” breakdown view.

Supported Endpoints

Tags work on every WebSocket endpoint:

Usage Examples

Fast Trades with Tag

Market Details with Tag

OHLCV with Tag

Multi-Events Stream with Tag

Viewing Tag Usage in the Dashboard

  1. Go to admin.mobula.io/usage
  2. Select WebSocket as the data source
  3. Use the “By Event” / “By Tag” selector to switch to the tag breakdown view
  4. You’ll see credits and event counts aggregated per tag
Subscriptions without a tag are grouped under “Untagged”.

Tag Guidelines

  • Tags are optional — omit the field or pass null to leave a subscription untagged
  • Maximum length: 50 characters
  • Tags are case-sensitive"Majors" and "majors" are tracked separately
  • Use consistent naming across your subscriptions for clean aggregation
  • You can use different tags on different subscriptions with the same API key

Implementation Example

Support

Can’t find what you’re looking for? Reach out to us, response times < 1h.

Support

Telegram

Support

Slack

Need help?

Email