> For the index of Synoptic streams and APIs for agents, see [llms.txt](https://synoptic.com/llms.txt).

# Telegram Tracker

> Real-time tracker for public Telegram channels

## Facts

- Stream ID: `01KBNX5CAQM2GPKC568XC6VQXS`
- Page: https://synoptic.com/p/streams/telegram-tracker
- Agent skill: https://synoptic.com/p/streams/telegram-tracker/SKILL.md
- Author: [@OpticFeeds](https://synoptic.com/OpticFeeds)
- Category: Other
- Kind: Custom targets: each subscriber receives only posts for the targets they choose
- Price: Paid: $5 per month for every 5 targets, $15 per 3 months for every 5 targets, $30 per 6 months for every 5 targets, $60 per year for every 5 targets
- Followers: 16
- Targets are Telegram channel name(the one in the link to the channel). Provide them without…: Telegram channel name(the one in the link to the channel). Provide them without @ and lowercase. A subscription holds 5 to 200 targets, in steps of 5.

## Connect

No guest access: reading posts needs a Synoptic account and an API key, or MCP sign-in. Posts follow the targets each subscriber picks.

1. Sign in at https://synoptic.com/auth/login (new users: https://synoptic.com/auth/signup).
2. Subscribe at https://synoptic.com/p/streams/telegram-tracker (Paid: $5 per month for every 5 targets, $15 per 3 months for every 5 targets, $30 per 6 months for every 5 targets, $60 per year for every 5 targets).
3. Choose targets on https://synoptic.com/p/streams/telegram-tracker, with MCP `set_stream_custom_targets`, or with `POST https://api.synoptic.com/v1/streams/01KBNX5CAQM2GPKC568XC6VQXS/custom-targets`. Targets are Telegram channel name(the one in the link to the channel). Provide them without…: Telegram channel name(the one in the link to the channel). Provide them without @ and lowercase. A subscription holds 5 to 200 targets, in steps of 5.
4. Create a reader key in Settings → API & Keys: https://synoptic.com/p/settings/api-keys.
5. Connect `wss://ws.api.synoptic.com/v1/on-stream-post?apiKey=<reader key>&streamIds=01KBNX5CAQM2GPKC568XC6VQXS`, or read history with `GET https://api.synoptic.com/v1/streams/01KBNX5CAQM2GPKC568XC6VQXS/posts?limit=50` and the header `x-api-key: <reader key>`. MCP calls after OAuth sign-in are realtime too.

## Latest posts

Not available without an account: posts depend on your targets.

## How to use

- Each post has `id`, `streamId`, `text` (markdown) and `createdAt` (ISO 8601). Deduplicate by `id`.
- Each post has `customTarget`: the target it matched. You receive only posts for the targets you set; with no targets you receive nothing.

## FAQ

**Do I need an account?**
Yes. Posts depend on the targets you choose, and choosing targets needs an account.

**Is it free?**
Paid: $5 per month for every 5 targets, $15 per 3 months for every 5 targets, $30 per 6 months for every 5 targets, $60 per year for every 5 targets.

**How much history can I read?**
With access, `GET https://api.synoptic.com/v1/streams/01KBNX5CAQM2GPKC568XC6VQXS/posts` pages with `nextToken`, `GET https://api.synoptic.com/v1/streams/01KBNX5CAQM2GPKC568XC6VQXS/posts/search` searches text, and MCP `get_stream_posts` accepts `fromDate` and `toDate`.

**How fast do posts arrive?**
The realtime WebSocket sends each post as soon as it is published.

**Which targets can I choose?**
Targets are Telegram channel name(the one in the link to the channel). Provide them without…: Telegram channel name(the one in the link to the channel). Provide them without @ and lowercase. A subscription holds 5 to 200 targets, in steps of 5.

## More

- [Agent skill for this stream](https://synoptic.com/p/streams/telegram-tracker/SKILL.md)
- [Subscribe to posts](https://docs.synoptic.com/s/websocket/subscribe-to-posts.md)
- [REST API reference](https://docs.synoptic.com/s/rest/api-reference.md)
- [MCP](https://docs.synoptic.com/s/mcp/mcp.md)
- [Custom streams](https://docs.synoptic.com/s/integrations/custom-streams.md)
- [Docs index](https://docs.synoptic.com/s/llms.txt)
