Skip to main content
Goal: pick the best wallets, then get notified when they make a move. This recipe builds a follow list from the leaderboard and watches the whale-trade feed for activity from anyone on it. All requests need a Bearer key. See Authentication.

​
1. Build the follow list

Pull the leaderboard and keep the top grades. The leaderboard ranks S, A, and B already; filter to S and A in code (there is no min_grade param on this endpoint). 
import os, requests

BASE = "https://api.0xinsider.com/api/v1"
H = {"Authorization": f"Bearer {os.environ['OXINSIDER_API_KEY']}"}

leaders = requests.get(f"{BASE}/leaderboard", params={"limit": 100}, headers=H).json()
follow = [t["address"] for t in leaders["data"] if t["grade"] in ("S", "A")]
Narrow by style if you want to copy one approach. Pass strategy to rank a single strategy type: 
curl -H "Authorization: Bearer $OXINSIDER_API_KEY" \
  "https://api.0xinsider.com/api/v1/leaderboard?strategy=swing_trader&limit=50"

​
2. Enrich the list

Pull full profiles for the whole set in one call with batch. Add expand for strategy and trust if you want to weight them: 
batch = requests.post(
    f"{BASE}/traders/batch",
    json={"traders": follow, "expand": ["strategy", "trust"]},
    headers=H,
).json()

for item in batch["data"]:
    if item["status"] == "ok":
        t = item["data"]
        print(t["username"], t["grade"], t["pnl"]["total"], t.get("strategy", {}).get("strategy_type"))

​
3. Watch for new activity

The whale-trade feed is the live signal. Poll it filtered to high grades, then keep only trades from wallets on your follow list: 
follow_set = set(a.lower() for a in follow)

def new_moves(min_size=10000):
    feed = requests.get(
        f"{BASE}/whale-trades",
        params={"min_grade": "A", "min_size": min_size, "limit": 100},
        headers=H,
    ).json()
    return [
        tr for tr in feed["data"]
        if tr["trader"]["address"].lower() in follow_set
    ]

for tr in new_moves():
    print(f'{tr["trader"]["username"]} {tr["side"]} ${tr["size_usd"]:,.0f} @ {tr["price"]} on {tr["market"]["title"]}')
For a push instead of a poll, register a webhook on whale_trades_inserted and apply the same follow-list filter when each event arrives. See Webhooks.

​
4. Drill into one market

When a followed trader enters a market you care about, read their full entry and exit history on that market with the position timeline. It takes the trader and a condition_id: 
curl -H "Authorization: Bearer $OXINSIDER_API_KEY" \
  "https://api.0xinsider.com/api/v1/traders/0x204f.../position-timeline?condition_id=0x123..."
Each event is a buy or sell with price, notional, and the running average price.

​
What this recipe does not do

There is no per-trader open-positions endpoint and no per-trader push channel. “Watch” means polling the whale-trade feed (or the whale_trades_inserted webhook) and matching addresses, plus the per-market timeline once you know the condition_id. Plan your loop around the feed, not around a subscription to a single wallet.