Quickstart

Use curl in your terminal to try the API. Start with sample data, then use a Pro or Max API key to read live data.

1. Try a request without a key

curl "https://0xinsider.com/sandbox/api/v1/leaderboard?limit=5"

You receive an example leaderboard response. The sandbox uses sample data, so you can learn the format without an account or subscription. If you want to try real public data, read the pick ledger:

curl "https://api.0xinsider.com/api/v1/pick-of-the-day/ledger"

The ledger includes published picks and their commitment states. It does not reveal the side of a live sealed pick; the ledger reference explains how to check the proof.

2. Get an API key

Subscribe to Pro or Max for protected live data.
Open Developers and choose Create key.
Save the key when it appears. The full value is shown once.
Store it in an environment variable:

export OXINSIDER_API_KEY="oxi_sk_live_..."

Replace the placeholder with your own key. Keep it out of source code, browser code, logs, and screenshots. See Authentication for OAuth and integration keys.

3. Check the key and account

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

A 200 response means the credential is valid. Check data.entitlement to confirm the account can read paid data; a valid key can still belong to an account whose paid access has expired. If you receive an error:

Response	Next action
`401`	Check that the key is present, complete, and valid.
`402` on a data route	Check the account’s Pro or Max subscription.
`403`	Check that the key or OAuth grant has the required scope.
`429`	Wait as directed by `Retry-After` before trying again.

Errors covers the error body and recovery steps. Account identity explains the diagnostic fields.

4. Read the leaderboard

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

The response’s data array contains tracked S, A, and B wallets. Each row includes an id, grade, score, and P&L information. Copy one id for the next request. An empty array is a valid response; do not assume a first row exists.

5. Open a trader profile

Replace <trader_id> with the id you copied:

curl -H "Authorization: Bearer $OXINSIDER_API_KEY" \
  "https://api.0xinsider.com/api/v1/trader/<trader_id>?expand=strategy"

The path also accepts a wallet address or known Polymarket username. The response includes sync_status, P&L, statistics, and a grade when one is available. Check sync_status before using the numbers. An untracked wallet address returns 200 with sync_status: "unknown" and missing analytics; an unknown username or trader ID returns 404. expand=strategy adds strategy details. Other optional groups include category_strengths, quant_metrics, and trust; Expand explains how to request them.

6. Find a large trade and its market

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

This requests large trades of at least $10,000 from S or A wallets. Copy a row’s market.condition_id, then replace <condition_id> below:

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

sharp_money.net_flow_usd describes signed flow from tracked large trades in the selected time window. sharp_money.top_positions lists the largest positions held by graded S, A, and B wallets. These fields describe observed activity. They do not predict the next price move. See Market flow for parameters and response details.

Use a client in your application

The Python, Go, TypeScript, and Rust pages show installation and complete examples. For a terminal workflow, use the CLI. Here is the leaderboard request in JavaScript without an SDK:

const key = process.env.OXINSIDER_API_KEY;
if (!key) throw new Error("Set OXINSIDER_API_KEY before running this script");

const response = await fetch(
  "https://api.0xinsider.com/api/v1/leaderboard?limit=5",
  { headers: { Authorization: `Bearer ${key}` } }
);
const body = await response.json();
if (!response.ok) {
  throw new Error(`${response.status}: ${body.error.message}`);
}

for (const trader of body.data) {
  console.log(trader.id, trader.grade, trader.pnl);
}

Run authenticated requests on a server or in a local script. Never send your API key to a public browser bundle.

Look up several wallets at once

Use batch trader lookup to read up to 25 profiles in one request. Each item returns its own status, so an unknown wallet or username does not fail every other item. Each item uses one unit of the batch budget.

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

Continue from here

Pagination explains how to read more than one page. Rate limits explains budgets and response headers. The API reference lists every operation and the rules they share.

Getting started

Integrations

Guides

Concepts

1. Try a request without a key

2. Get an API key

3. Check the key and account

4. Read the leaderboard

5. Open a trader profile

6. Find a large trade and its market

Use a client in your application

Look up several wallets at once

Continue from here

​1. Try a request without a key

​2. Get an API key

​3. Check the key and account

​4. Read the leaderboard

​5. Open a trader profile

​6. Find a large trade and its market

​Use a client in your application

​Look up several wallets at once

​Continue from here

1. Try a request without a key

2. Get an API key

3. Check the key and account

4. Read the leaderboard

5. Open a trader profile

6. Find a large trade and its market

Use a client in your application

Look up several wallets at once

Continue from here