For the complete documentation index, see llms.txt. This page is also available as Markdown.

REST API Limitation

WebSocket rate and connection caps: WebSocket Limitation. Over-limit codes: REST API Error Codes.

Plan-based limits

Plan
Limits

Free

All endpoints: 1 request/second, 60/minute, 86,400/day

Basic

All endpoints: 2 requests/second, 120/minute, 172,800/day

Premium

All endpoints: 10 requests/second, 600/minute, 864,000/day

Pro

All endpoints: 20 requests/second, 1,200/minute, 1,728,000/day

The live cap is apiNumPerSec from package info.

IP-based limits

  • Business API calls are gated by the API key plan, not by IP.

  • Public website widgets may apply IP rate limits.

  • Excessive failures can trip risk control. Contact Telegram support to unblock.

Last updated