MillionScan API

curl -H "Authorization: Bearer msk_live_..." \
  "https://millionscan.com/api/public/v1/leaderboard?tier=featured&page_size=10"

import os, requests

session = requests.Session()
session.headers["Authorization"] = f"Bearer {os.environ['MILLIONSCAN_KEY']}"

resp = session.get(
    "https://millionscan.com/api/public/v1/leaderboard",
    params={"tier": "featured", "page_size": 10, "sort_by": "score"},
)
resp.raise_for_status()
data = resp.json()
for t in data["traders"]:
    print(t["public_id"], t["score"], t["roi_30d"])

const resp = await fetch(
  "https://millionscan.com/api/public/v1/leaderboard?tier=featured&page_size=10",
  { headers: { Authorization: `Bearer ${process.env.MS_KEY}` } },
);
if (!resp.ok) throw new Error(`HTTP ${resp.status}`);
const data = await resp.json();
for (const t of data.traders) {
  console.log(t.public_id, t.score, t.roi_30d);
}

curl -H "Authorization: Bearer msk_live_..." \
  "https://millionscan.com/api/public/v1/traders/%2338291/positions"

import urllib.parse, os, requests

key = os.environ["MILLIONSCAN_KEY"]
public_id = "#38291"
encoded = urllib.parse.quote(public_id, safe="")

resp = requests.get(
    f"https://millionscan.com/api/public/v1/traders/{encoded}/positions",
    headers={"Authorization": f"Bearer {key}"},
)
resp.raise_for_status()
for p in resp.json()["open_positions"]:
    print(p["coin"], p["side"], p["size"], "uPnL:", p["unrealized_pnl"])

const publicId = encodeURIComponent("#38291");
const resp = await fetch(
  `https://millionscan.com/api/public/v1/traders/${publicId}/positions`,
  { headers: { Authorization: `Bearer ${process.env.MS_KEY}` } },
);
const data = await resp.json();
for (const p of data.open_positions) {
  console.log(p.coin, p.side, p.size, "uPnL:", p.unrealized_pnl);
}

curl -H "Authorization: Bearer msk_live_..." \
  "https://millionscan.com/api/public/v1/traders/%2338291/trades?page=1&page_size=100"

import urllib.parse, os, requests

key = os.environ["MILLIONSCAN_KEY"]
public_id = "#38291"
encoded = urllib.parse.quote(public_id, safe="")

resp = requests.get(
    f"https://millionscan.com/api/public/v1/traders/{encoded}/trades",
    headers={"Authorization": f"Bearer {key}"},
    params={"page": 1, "page_size": 100},
)
resp.raise_for_status()
data = resp.json()
wins = [t for t in data["trades"] if (t["realized_pnl"] or 0) > 0]
print(f"win/loss split: {len(wins)}/{len(data['trades']) - len(wins)}")

const publicId = encodeURIComponent("#38291");
const resp = await fetch(
  `https://millionscan.com/api/public/v1/traders/${publicId}/trades?page=1&page_size=100`,
  { headers: { Authorization: `Bearer ${process.env.MS_KEY}` } },
);
const { trades } = await resp.json();
const wins = trades.filter((t: any) => (t.realized_pnl ?? 0) > 0);
console.log(`win/loss split: ${wins.length}/${trades.length - wins.length}`);

# wscat (npm install -g wscat) — easiest manual test
wscat -c "wss://millionscan.com/api/public/v1/events?api_key=msk_live_..."

# Then send:
{"type":"subscribe","trader_ids":["#38291","#42391"]}

import asyncio, json, os
import websockets

async def main():
    key = os.environ["MILLIONSCAN_KEY"]
    url = f"wss://millionscan.com/api/public/v1/events?api_key={key}"

    async with websockets.connect(url) as ws:
        # Subscribe to a specific watchlist (empty list = all)
        await ws.send(json.dumps({
            "type": "subscribe",
            "trader_ids": ["#38291", "#42391"],
        }))

        async for raw in ws:
            msg = json.loads(raw)
            if msg.get("type") == "ping":
                await ws.send(json.dumps({"type": "pong"}))
                continue
            if msg.get("type") == "position_event":
                print(msg["public_id"], msg["action"], msg["coin"], msg["side"])

asyncio.run(main())

const key = process.env.MS_KEY!;
const ws = new WebSocket(
  `wss://millionscan.com/api/public/v1/events?api_key=${key}`,
);

ws.addEventListener("open", () => {
  ws.send(JSON.stringify({
    type: "subscribe",
    trader_ids: ["#38291", "#42391"],
  }));
});

ws.addEventListener("message", (ev) => {
  const msg = JSON.parse(ev.data as string);
  if (msg.type === "ping") {
    ws.send(JSON.stringify({ type: "pong" }));
    return;
  }
  if (msg.type === "position_event") {
    console.log(msg.public_id, msg.action, msg.coin, msg.side);
  }
});