Troubleshooting
Common Errors
| Error | What It Means | What to Do |
|---|---|---|
| 401 / 403 | Your IP isn't in the allowlist | Check your current public IP, open a Discord ticket with the correct one |
| 429 | Rate limit exceeded | Back off (exponential), lower request frequency, or upgrade tier |
| Timeout (no response) | Network issue or server maintenance | Try pinging the domain; check #announcements in Discord |
| Connection refused on port 10000 or 8900 | gRPC/WS port blocked or not enabled for your tier | Verify your plan includes gRPC; check that your firewall allows outbound on those ports |
Before Opening a Ticket
A few things to check on your end first:
- IP change? — if you're on a dynamic IP (residential ISP, some cloud providers), your address may have rotated. Run
curl ifconfig.meand compare with what you gave us. - Firewall / VPN — make sure outbound traffic to ports 8899, 8900, 10000 isn't blocked.
- Client config — double-check the endpoint URL and port. A common mistake is pointing to port 443 instead of 8899.
Escalation
If the issue isn't on your side:
- Check
#announcementsin Discord for any ongoing maintenance - Open a ticket in
#service-ticketwith:- Your endpoint URL
- The method or subscription that's failing
- Error output from your application
- Response time: typically several minutes to a couple of hours during business hours