Rate Limits

10requests per minute (soft limit on Free), for your whole account

On Free the soft limit is 10 requests per minute and the hard limit 100, counted for your whole account across all players. Paid plans have higher limits, see the pricing page. Requests above the hard limit get HTTP 429 with Retry-After. Design your API calls efficiently.

Do and avoid

  • Cache data locally
  • Load all configs at startup
  • Submit scores only on improvements
  • Use the useCache parameter
  • Make repeated identical requests
  • Fetch individual configs repeatedly
  • Submit scores every frame
  • Always bypass the cache

Efficient startup pattern

Load only what you need at startup, then rely on caching for the rest.

Unity (C#)
C#
1async void Start()
2{
3 HorizonApp.Initialize();
4 await new HorizonServer().Connect();
5​
6 // Startup loads (3 requests)
7 await UserManager.Instance.CheckAuth();
8 await RemoteConfigManager.Instance.GetAllConfigs();
9 await NewsManager.Instance.LoadNews();
10​
11 // Startup costs 3 requests. The per-minute limit counts for your whole account, not per player.
12}

Tutorial video

Rate Limits3:36
Open video separately ↗