Node License-1.gif

Introduction

This week, I put together a small application to experiment with the Splinterlands SPS validator node API.

The goal? To explore available API calls, including some that aren’t in the official schema, and make it easy to interact with them.

What Does It Do?

The app pulls the API spec directly from the official SPS validator GitHub repository and adds the top 10 validator nodes to the server list for easy access.

By default, it includes all the API calls specified in the official schema. However, I also dug through the code and found some extra endpoints that weren’t listed—so I added those in too!

Try It Out

You can check out the playground here:
👉 validator-playground.spl-stats.com

As usual it a opensource tool so if you wandering how its created here it the repo
👉 https://github.com/gamerbeaker007/sps-validator-playground

Running It Locally

If you want to spin it up on your own machine, you can:
Using the Latest Version

docker pull gamerbeaker/splinterlands-validator-swagger:latest
docker run -p 3000:3000 gamerbeaker/splinterlands-validator-swagger:latest

Using a Specific Version

docker pull gamerbeaker/splinterlands-validator-swagger:v1.0.0
docker run -p 3000:3000 gamerbeaker/splinterlands-validator-swagger:v1.0.0

That’s it! You’ll have a local instance ready to test out API calls.
visit: http://localhost:3000/

How to use it

Select your node

It shows the top ten active validators select one where you want to experiment with.

Try out a specific call

If you want to test a specific API call, here’s how it looks in Swagger-UI:

In the example above, you can see how to interact with an endpoint and what to expect in the response. Here’s a breakdown:

cURL Command – This shows how you can reproduce the request in a terminal using curl.
Request URL – This is the exact URL that Swagger-UI uses to make the API call. You can copy this and use it in your own requests.
JSON Response – This is the actual response returned by the validator API. It provides the structured data you requested.

This makes it easy to see what’s happening behind the scenes and experiment with different parameters.

Where Did I Use It Already?

One practical use case I found was extending the top SPS holders for BeeBalanced.

Normally, the Splinterlands API only provides the top 100 Staked SPS (SPSP) holders, but with the validator API, I was able to pull 2,000 SPSP holders instead. This made it much easier to get a more accurate view of SPSP distribution.

SPSP Distribution – The app fetches data for the top 2,000 SPSP holders to give a picture of how SPSP is spread.

KE Ratio of Top SPS Holders – Combine this with their Hive balances (Hive Power/posting rewards and curation rewards). This then can be used to look at their KE ratio. Which helps understand involvement in the hive eco system.