Troubleshooting

Common Errors

ErrorWhat It MeansWhat to Do
401 / 403Your IP isn't in the allowlistCheck your current public IP, open a Discord ticket with the correct one
429Rate limit exceededBack off (exponential), lower request frequency, or upgrade tier
Timeout (no response)Network issue or server maintenanceTry pinging the domain; check #announcements in Discord
Connection refused on port 10000 or 8900gRPC/WS port blocked or not enabled for your tierVerify 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:

  1. IP change? — if you're on a dynamic IP (residential ISP, some cloud providers), your address may have rotated. Run curl ifconfig.me and compare with what you gave us.
  2. Firewall / VPN — make sure outbound traffic to ports 8899, 8900, 10000 isn't blocked.
  3. 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:

  1. Check #announcements in Discord for any ongoing maintenance
  2. Open a ticket in #service-ticket with:
    • Your endpoint URL
    • The method or subscription that's failing
    • Error output from your application
  3. Response time: typically several minutes to a couple of hours during business hours