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
