HyKey

A hypixel api proxy that caches to redis and handles rate limits.

features

• Caches to redis
  • it returns the cached data of a endpoint for 60 seconds
  • it also returns the cached data if the ratelimit is hit to prevent 429s
• Handles rate limits
• Removes the need for api keys

Public instance

• hy.tricked.dev
  • please dont break or abuse it lol the key only has a 60 requests per minute limit

Setup

You need to have a redis server running on your machine. I recommend using dragonflydb the docker-compose file in this repository will start a redis server for you.

Usage: hykey [OPTIONS] --api-key <API_KEY>
Options:
-a, --api-key <API_KEY> [env: API_KEY=]
-k, --key-limit <KEY_LIMIT> [env: KEY_LIMIT=] [default: 60]
-r, --redis-url <REDIS_URL> [env: REDIS_URL=] [default: redis://127.0.0.1/]
-b, --bind-addr <BIND_ADDR> [env: BIND_ADDR=] [default: 0.0.0.0]
-p, --bind-port <BIND_PORT> [env: BIND_PORT=] [default: 4000]
-u, --hypixel-api <HYPIXEL_API> [env: HYPIXEL_API=] [default: https://api.hypixel.net]
-h, --help Print help