Skip to main content
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 ($89/mo).
1

Sign up or log in

0xinsider.com/sign-up
2

Subscribe to Insider

Pick the Insider plan on Pricing.
3

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 });

​
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.

​
Next

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.