# GET /v2/stream/usage

**Usage**

REST companion to the `/v2/stream` WebSocket. Returns how many distinct tickers this ACCOUNT currently has subscribed (pooled across every live connection and every API key — a second key does not grant a second budget), the plan cap, and open connection count vs the flat 5-connection abuse guard. `max_tickers` is `null` when the plan is unlimited.

## Plan access

- **Plan access.** Paid plans (Hobby and above). Hobby 10 · Pro 100 · Scale 1,000 · Enterprise unlimited.
- **Auth.** API key. Send Authorization: Bearer at the handshake, or a first-message auth frame.
- **Cadence.** One update per subscribed ticker per minute turnover. Not a raw trade tape.

## Status codes

- **200** — Envelope with `tickers`, `max_tickers` (null = unlimited), `connections`, `max_connections`.
- **401** — Missing or invalid API key.

## Sample response

```json
{
  "as_of": "2026-07-27T14:20:05.000Z",
  "tickers": 4,
  "max_tickers": 10,
  "connections": 1,
  "max_connections": 5
}
```

## Examples

### Check consumption

Request:

```shell
curl "https://api.tickerbot.io/v2/stream/usage" \
  -H "Authorization: Bearer YOUR_KEY"
```

Response (`200`):

```json
{
  "as_of": "2026-07-27T14:20:05.000Z",
  "tickers": 4,
  "max_tickers": 10,
  "connections": 1,
  "max_connections": 5
}
```

---

Interactive sandbox + parameter editor: https://tickerbot.io/docs/endpoints/websockets/tickers/stream-usage