Quickstart

Generate a key, confirm it works, then run a real “follow the smartest traders” workflow.

1. Generate your API key

API access is bundled with the Insider subscription; current pricing is on that page.

Subscribe to Pro

Pick the Insider plan on Pricing.

Generate your key

On Developers, click Generate Key. It’s shown once, so copy it now. You can regenerate a lost key, but the old one stops working.

Keys look like oxi_sk_live_ followed by 64 hex characters.

Export it once so the rest of this page just works:

export OXINSIDER_API_KEY="oxi_sk_live_..."

2. Confirm the key works

curl -H "Authorization: Bearer $OXINSIDER_API_KEY" \
  https://api.0xinsider.com/api/v1/health

{
  "object": "health",
  "data": { "status": "ok", "db": true, "cache": true },
  "meta": { "request_id": "req_abc123", "cached": false }
}

status: "ok" means you’re wired up.

Browser apps can call REST endpoints under https://api.0xinsider.com/api/v1/* directly from any origin with Authorization: Bearer ...; do not send cookies or credentials: "include". Remote MCP at /api/v1/mcp still validates Origin against the 0xinsider/localhost allowlist. Browser JavaScript can read X-RateLimit-*, Retry-After, ETag, X-Request-Id, X-Request-Cost, X-Batch-RateLimit-*, Mcp-Session-Id, and X-Mcp-Error-Code response headers. Account/key-management routes such as /api/keys stay first-party-only and credentialed.

3. Follow the smartest traders

Not “who’s #1,” but “what are the best traders doing right now, and am I early?”

Step A: Pull the top 5 S-grade traders

curl -H "Authorization: Bearer $OXINSIDER_API_KEY" \
  "https://api.0xinsider.com/api/v1/leaderboard?limit=5"

Each entry has the wallet address (id), grade, score, P&L, and strategy. Pick one to follow.

Step B: Look up that trader’s full profile

The trader endpoint takes a wallet address or a known username:

curl -H "Authorization: Bearer $OXINSIDER_API_KEY" \
  "https://api.0xinsider.com/api/v1/trader/0x863134d00841b2e200492805a01e1e2f5defaa53"

You get their realized P&L, win rate, category strengths, and current open positions.

Step C: See what whales are buying now

A-grade or better, last 50 trades:

curl -H "Authorization: Bearer $OXINSIDER_API_KEY" \
  "https://api.0xinsider.com/api/v1/whale-trades?min_grade=A&limit=50"

Layer filters. A-grade or better, crypto only, $10k+ notional:

curl -H "Authorization: Bearer $OXINSIDER_API_KEY" \
  "https://api.0xinsider.com/api/v1/whale-trades?min_grade=A&category=crypto&min_size=10000&limit=50"

Step D: Drill into one market

Grab the condition_id from a trade you like (raw hex, not the prefixed mkt_... form), then:

curl -H "Authorization: Bearer $OXINSIDER_API_KEY" \
  "https://api.0xinsider.com/api/v1/market/<condition_id>/intel"

Market Intel returns the smart-money breakdown: buy volume vs sell volume from graded traders, top positions, and which side has conviction. The loop: leaderboard -> trader profile -> whale trades -> market intel. Wire it to a cron, a chatbot, or a dashboard.

Same workflow, in code

const KEY = process.env.OXINSIDER_API_KEY;
const headers = { Authorization: `Bearer ${KEY}` };

const top = await fetch(
  "https://api.0xinsider.com/api/v1/leaderboard?limit=5",
  { headers }
).then(r => r.json());

const topId = top.data[0].id.replace(/^trd_/, "");

const trader = await fetch(
  `https://api.0xinsider.com/api/v1/trader/${topId}`,
  { headers }
).then(r => r.json());

const whales = await fetch(
  "https://api.0xinsider.com/api/v1/whale-trades?min_grade=A&limit=50",
  { headers }
).then(r => r.json());

console.log({ top: top.data[0], trader: trader.data, whales: whales.data.length });

import os, requests

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

top = requests.get(f"{BASE}/leaderboard", params={"limit": 5}, headers=H).json()
top_id = top["data"][0]["id"].removeprefix("trd_")

trader = requests.get(f"{BASE}/trader/{top_id}", headers=H).json()
whales = requests.get(
    f"{BASE}/whale-trades",
    params={"min_grade": "A", "limit": 50},
    headers=H,
).json()

print(top["data"][0], trader["data"]["grade"], len(whales["data"]))

Lower the call count with a batch endpoint

Already have the wallet addresses or usernames you care about? Fetch them in one call:

curl -H "Authorization: Bearer $OXINSIDER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"traders": ["0xabc...", "0xdef...", "0x123..."]}' \
  "https://api.0xinsider.com/api/v1/traders/batch"

Batch reads return the same per-item shape, with per-item error fields when an address fails. They count against a separate batch-item rate-limit budget. See Rate Limits.

Local MCP Server

Skip the HTTP plumbing. Give your AI agent the same tools directly.

TypeScript Client

Use the repo-owned source client with typed errors and expand helpers.

Trader Grades

What S, A, B, C, D, F actually mean.

Errors & Rate Limits

What to do when a request fails.

Getting Started

Guides

Concepts

1. Generate your API key

2. Confirm the key works

3. Follow the smartest traders

Step A: Pull the top 5 S-grade traders

Step B: Look up that trader’s full profile

Step C: See what whales are buying now

Step D: Drill into one market

Same workflow, in code

Lower the call count with a batch endpoint

Next

Local MCP Server

TypeScript Client

Trader Grades

Errors & Rate Limits

​1. Generate your API key

​2. Confirm the key works

​3. Follow the smartest traders

​Step A: Pull the top 5 S-grade traders

​Step B: Look up that trader’s full profile

​Step C: See what whales are buying now

​Step D: Drill into one market

​Same workflow, in code

​Lower the call count with a batch endpoint

​Next

Local MCP Server

TypeScript Client

Trader Grades

Errors & Rate Limits

1. Generate your API key

2. Confirm the key works

3. Follow the smartest traders

Step A: Pull the top 5 S-grade traders

Step B: Look up that trader’s full profile

Step C: See what whales are buying now

Step D: Drill into one market

Same workflow, in code

Lower the call count with a batch endpoint

Next