Traders

The Traders page under a key: the directory, one wallet's page and its portfolio.

The trader routes answer with the same views Traktor's Traders page and trader pages read, in the v1 envelope and drawn from your plan's units.

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

const response = await fetch("https://api.traktor.fun/v1/traders/directory", {
  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/traders/directory",
    headers={"Authorization": f"Bearer {os.environ['TRAKTOR_API_KEY']}"},
)
print(response.json())

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

const response = await fetch("https://api.traktor.fun/v1/traders/0x2222222222222222222222222222222222222222", {
  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/traders/0x2222222222222222222222222222222222222222",
    headers={"Authorization": f"Bearer {os.environ['TRAKTOR_API_KEY']}"},
)
print(response.json())

curl -s "https://api.traktor.fun/v1/traders/0x2222222222222222222222222222222222222222/portfolio" \
  -H "Authorization: Bearer $TRAKTOR_API_KEY"

const response = await fetch("https://api.traktor.fun/v1/traders/0x2222222222222222222222222222222222222222/portfolio", {
  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/traders/0x2222222222222222222222222222222222222222/portfolio",
    headers={"Authorization": f"Bearer {os.environ['TRAKTOR_API_KEY']}"},
)
print(response.json())

Each answer is the view the server last built for that question, shared with every other reader of it, and meta.asOf dates that build.

• The directory is rebuilt about once a minute. It lists every trader a source names, and, among the wallets that traded through the apps Traktor tracks, each chain's best traders by a year's realized profit, then every other one of them whose year Traktor holds, for that year alone. A row for one of those carries id codex:<wallet>, and where no source names the wallet its handle is the wallet's own address and name is null.

• A row listed for its year alone whose wallet traded in the last day carries that day's figures as null, never zero, as Traktor reads the day only for the traders the sources name: volumeUsd, netUsd, buyUsd, sellUsd, trades, spark and activeHours. It clears no screen on the day, a floor of zero or a side included, and sorts last on any of those figures.

• On any row, buyUsd or sellUsd is also null where that side traded in the window and none of those trades had a dollar figure, as far as Traktor's count of unpriced trades (a floor) shows, and where some were priced it is the priced trades' dollars alone; netUsd is null beside a null side, and volumeUsd where no trade was priced. Such a figure sorts last whichever way its column is turned, and the buyShare sort puts a row with a null side last, as the avgTrade sort does one with a null volume. A null netUsd clears no side screen and nets its trader neither way in the summary's buyers and sellers, and a null volumeUsd clears no minAvgTrade screen nor a minVolume above 0 (a minVolume of 0 is no floor where the day was read). The summary's dollars and each row's spark add the priced trades alone.

• The day's busiest wallets that pump.fun, Axiom, a wallet-label source or an X account names are rows too, id named:<wallet>, under that name.

• A wallet's page is read from Traktor's own store. The portfolio comes from a data provider, and a cold read can make a request there, which its units reflect. It names the account the wallet belongs to, the fomo account fomo's matcher links it to, else the fomo account whose handle a wallet label gives the wallet, and reads that account's wallet of the other kind with it.

  • A wallet a row of the all-time Leaderboard names is read alone on its own page and account is null: the page never names a Traktor account.

  • A labelled handle whose account Traktor does not know names that wallet alone: account.source is fomo, handle the fomo handle, name and avatarUrl null and profileUrl its fomo page.

  • Where none of those names it, the wallet's own pump.fun profile does, for that wallet alone: account.source is pump, handle its pump.fun username, name null and profileUrl its pump.fun page.

  • Where no pump.fun profile names it either, Axiom's KOL or pump.fun list does, for that wallet alone: account.source is axiom, handle the handle Axiom gives (a KOL's X handle or a pump.fun username), name the list's display name or null, and no profileUrl.

With any of the market filter's token screens (minMcap, launchpad, dex and the rest), the directory lists only the traders whose year Traktor holds and who traded a token the screens pass in the window: volumeUsd, netUsd, buyUsd, sellUsd, trades, spark, activeHours and the summary count those tokens' trades alone, and codex, holdings, firstSeenAt and lastTradeAt stay the account's. A trader with no year Traktor holds, and every row listed for its year alone, is left out while one is set. The body's generatedAt is then the instant the trades were read to, at most two minutes before the answer was built, which meta.asOf dates.

Every query key and the wallet in the path are checked before the request is admitted. A key the route does not take, or a value its grammar refuses, is a 400 with no X-Traktor-Cost.

A view still being built, or one that failed with nothing kept, is 503 data_unavailable, with details.reason warming or unavailable, and its units come back, as on the Tokens page.