The Website . Make a pull request

EN | ID

Attention: For any extra support, questions, check out our Discord.

Add new nodes

1. Fork this repository
2. Edit the nodes.json file and add your node like the example
3. Create pull request

nodes.json example

[
    {
        "unique-id": "nodes-v4",
        "identifier": "My Node v4", 
        "host": "lavalink1.example.com",
        "port": 2333, 
        "password": "youshallnotpass",
        "secure": false,
        "version": "v4"
    }
]

• unique-id - The unique id of your node (example: nodes-v4) (Note: must used lowercase and change space with - )
• identifier - The identifier of your node (example: My Node v4)
• host - The host of your node (can be sub domain or IP)
• port - The port of your node
• password - The password of your node (if you have one)
• secure - If your node is using SSL (true or false)
• version - The version of your node (lavalink rest api version) (v3 or v4)

API

Badges

Stats service also supports badges generation, here the breakdown:

https://lavalink-list-api.ajieblogs.eu.org/<unique-id>/badge/<type>

• <unique-id> - Your unique-id
• <type> - Badge type, supported badge type are: Players, Status, Load

Example: https://lavalink-list-api.ajieblogs.eu.org/serenetia-v3/badge/Players
Output:

Example: https://lavalink-list-api.ajieblogs.eu.org/serenetia-v3/badge/Status
Output:

Example: https://lavalink-list-api.ajieblogs.eu.org/serenetia-v3/badge/Load
Output:

Raw json list

Deployed config are in here https://lavalink-list-api.pages.dev/nodes.json

Note

• Stats service may spam your stats and info endpoint (based on how many people opens the website and badges being generated), if you have firewall or rate limit you can whitelist this IP:

2a06:98c0:3600::103

• Node will marked as offline if timeout for 3 seconds
• Inactive servers or nodes may get deleted to avoid status delay.

FAQ

• Q: The Status API is open source?
• A: No (It was actually planned but someone copied it and we cancelled it.)

---

• Q: Can i get my lavalink stats api.
• A: Currently working on it. (Probably "No" but we will find another way and additional issues above)

---

• Q: Can we remove inactive nodes?
• A: If you think helps, why not?

Contributors