Quickstart

# pip install 0xinsider
import oxinsider

client = oxinsider.Client()  # reads OXINSIDER_API_KEY

top = client.list_leaderboard(limit=5)
if not top["data"]:
    raise RuntimeError("the leaderboard page is empty right now")

trader = client.get_trader(top["data"][0]["id"])
whales = client.list_whale_trades(min_grade="A", limit=50)

# grade is absent, not null, when the wallet has none.
print(top["data"][0], trader["data"].get("grade", "ungraded"), len(whales["data"]))

// go get github.com/0xinsider/0xinsider-go@v0.3.0
ctx, cancel := context.WithTimeout(context.Background(), 30*time.Second)
defer cancel()

client, err := oxinsider.New(oxinsider.WithBearerToken(os.Getenv("OXINSIDER_API_KEY")))
if err != nil {
	log.Fatal(err)
}

limit := 5
board, err := client.ListLeaderboardWithResponse(ctx, &oxinsider.ListLeaderboardParams{Limit: &limit})
if err != nil {
	log.Fatal(err)
}
if board.JSON200 == nil {
	log.Fatalf("HTTP %d: %s", board.StatusCode(), board.Body)
}
if len(board.JSON200.Data) == 0 {
	log.Fatal("the leaderboard page is empty right now")
}

trader, err := client.GetTraderWithResponse(ctx, board.JSON200.Data[0].Id, &oxinsider.GetTraderParams{})
if err != nil {
	log.Fatal(err)
}

// Grade is a pointer, because the API omits it when the wallet has none.
grade := "ungraded"
if trader.JSON200 != nil && trader.JSON200.Data.Grade != nil {
	grade = string(*trader.JSON200.Data.Grade)
}
fmt.Println(board.JSON200.Data[0].Address, grade)

const headers = { Authorization: `Bearer ${process.env.OXINSIDER_API_KEY}` };
const BASE = "https://api.0xinsider.com/api/v1";

async function get(path) {
  const res = await fetch(`${BASE}${path}`, { headers });
  const body = await res.json();
  if (!res.ok) throw new Error(`${res.status} ${body.error.code}: ${body.error.message}`);
  return body;
}

const top = await get("/leaderboard?limit=5");
if (top.data.length === 0) throw new Error("the leaderboard page is empty right now");
const topId = top.data[0].id;

const trader = await get(`/trader/${topId}`);
const whales = await get("/whale-trades?min_grade=A&limit=50");

// grade is absent, not null, when the wallet has none.
console.log({ top: top.data[0], grade: trader.data.grade ?? "ungraded", whales: whales.data.length });