List galaxy

GET /v1/leaderboard/galaxy

Returns every ranked org as a star, for a page to draw the community as a galaxy: each star holds its band in the reward program's level table, a coarse size (a factor of two), the star of the org that referred it, if any, and, only for the ranks the reader has earned a view of, its exact points and the name the standing shows for it. The window is the standing's: a signed-in reader sees their own star, five ranks below it and as many above as their points have earned; a reader who is not signed in sees the last ranks, where a newcomer starts. Every other star has points of -1 and no name, and is still drawn. The stars are columns of equal length, best first, and center is the tokens used and the orgs active in the last 24 hours. A star's id is opaque: it is the same wherever this answer mentions that star, names no org, and is replaced on the next read, about a minute later. A signed-in reader gets self, the id of their own star. Names are the standing's: masked in the middle, whole where the org listed itself, empty where it withdrew. No org id, handle or email is sent. No credential is needed to read it.

Request

GET /v1/leaderboard/galaxy takes no parameters and no body — the credential is the whole request.

Response

200 body — 13 fields.

Failure carries the platform error shape — see Errors.

Examples

hanzo leaderboard galaxy

import { Configuration, LeaderboardApi } from 'hanzoai';

const api = new LeaderboardApi(new Configuration({ accessToken: process.env.HANZO_API_KEY }));
const { data } = await api.getLeaderboardGalaxy();

from hanzoai.cloud import ApiClient, Configuration
from hanzoai.cloud.api import LeaderboardApi

client = ApiClient(Configuration(access_token=os.environ["HANZO_API_KEY"]))
result = LeaderboardApi(client).get_leaderboard_galaxy()

cfg := hanzoai.NewConfiguration()
cfg.AddDefaultHeader("Authorization", "Bearer "+os.Getenv("HANZO_API_KEY"))
client := hanzoai.NewAPIClient(cfg)

resp, _, err := client.LeaderboardAPI.GetLeaderboardGalaxy(context.Background()).Execute()
if err != nil {
	return err
}

use hanzo_client::apis::{configuration::Configuration, leaderboard_api};

let mut cfg = Configuration::new();
cfg.bearer_access_token = std::env::var("HANZO_API_KEY").ok();

let result = leaderboard_api::get_leaderboard_galaxy(&cfg, Default::default()).await?;

import ai.hanzo.cloud.ApiClient;
import ai.hanzo.cloud.api.LeaderboardApi;

ApiClient client = new ApiClient();
client.setBearerToken(System.getenv("HANZO_API_KEY"));

var result = new LeaderboardApi(client).getLeaderboardGalaxy();

curl https://api.hanzo.ai/v1/leaderboard/galaxy \
  -H "Authorization: Bearer $HANZO_API_KEY"

curl -X POST https://api.hanzo.ai/v1/mcp \
  -H "Authorization: Bearer $HANZO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
       "jsonrpc": "2.0",
       "id": 1,
       "method": "tools/call",
       "params": {
         "name": "leaderboard",
         "arguments": {
           "op": "get_leaderboard_galaxy",
           "input": {}
         }
       }
     }'

Leaderboard API · All Hanzo APIs · Interactive reference