Leaderboard

Traktor's own accounts, ranked by what their trades through Traktor realized.

GET /v1/leaderboard answers with the board Traktor's Traders page draws as its Traktor leaderboard view: its accounts ranked by what their trades through Traktor realized in a window.

curl -s "https://api.traktor.fun/v1/leaderboard" \
  -H "Authorization: Bearer $TRAKTOR_API_KEY"

const response = await fetch("https://api.traktor.fun/v1/leaderboard", {
  headers: { Authorization: `Bearer ${process.env.TRAKTOR_API_KEY}` },
});
const body = await response.json();

import os
import requests

response = requests.get(
    "https://api.traktor.fun/v1/leaderboard",
    headers={"Authorization": f"Bearer {os.environ['TRAKTOR_API_KEY']}"},
)
print(response.json())

Each sale in the window is booked against the average cost of the account's buys before it, the way its Portfolio tab books it, and window picks the range as that tab's chart does. The board lists the first 1,000 accounts, the most realized first, and summary counts every account ranked, past the list too.

• pnlUsd is null when none of the window's sales was of a token whose cost the ledger names, such as one that came from outside, since what those tokens cost is unknown; such a row comes after every row with a figure, and summary.pnlUsd adds up the rows that have one.

• roi is what the sales realized over what the tokens sold cost, and null while nothing sold had a cost the ledger names.

• wins and losses count the tokens whose sales realized more, or lost more, than half a cent; winRate is wins over the tokens decided either way, null while none is.

• you is the standing of the account that owns the key, with its place on the whole board, and null while that account has no buy or sale in the window or is not ranked at all: closed, suspended, or kept off the board at its owner's request.

A row names an account by its X or Traktor name and an id that stays the same for the account, never a wallet. The board is read from the ledger once a minute, and meta.asOf dates that read. While a new read fails, the last board stays up to five minutes old, its meta.asOf saying so; past that, a board that cannot be read is 503 data_unavailable, and its unit comes back (Limit headers).