Expand

expand adds optional fields to a trader response, a market snapshot, or an event replay page. Name only the fields you read: on a trader, an expanded request skips the response cache. A field you did not name is left out of the response rather than returned as null.

Pass the parameter

The parser accepts three forms, and you can mix them in one request.

# Comma-separated
curl -H "Authorization: Bearer $OXINSIDER_API_KEY" \
  "https://api.0xinsider.com/api/v1/trader/swisstony?expand=strategy,categories"

# The key repeated
curl -H "Authorization: Bearer $OXINSIDER_API_KEY" \
  "https://api.0xinsider.com/api/v1/trader/swisstony?expand=strategy&expand=trust"

# The bracket form, which means the same thing
curl -H "Authorization: Bearer $OXINSIDER_API_KEY" \
  "https://api.0xinsider.com/api/v1/trader/swisstony?expand[]=strategy&expand[]=trust"

What you send	What happens
A value the route does not recognize	It is ignored, and the rest of the request runs normally.
An empty value, as in `expand=` or `expand=a,,b`	The empty part is dropped.
A broken percent-encoded value	`400` with `error.param` set to `expand`.
Nothing for a field	That field is absent from the response, not `null`.

Trader values

These four work on Trader and Batch traders.

Value	Fields it adds	What you get
`strategy`	`strategy`	`strategy_type`, and `description` when one is stored. `confidence` is never returned. See Strategy types.
`categories`	`category_strengths`, `category_records`, `category_skill_model`	The wallet’s rank in each category, its record in each category, and how ready the category model is.
`quant_metrics`	`quant_metrics`	9 numbers, returned only when they were computed less than 6 hours ago. See Quant metrics.
`trust`	`trust`	Where each of 19 trader fields came from, how old it is, and how complete it is. See Trust metadata.

category_records includes rows whose own status is insufficient, stale, unknown, or degraded, so a category appearing in the list is not by itself evidence of skill. category_skill_model.status is one of live, insufficient, stale, unknown, or degraded, and it describes the whole model rather than one category. category_strengths is counted from a narrower set of positions than Trader category records: it admits a position only above $20 and with an entry price strictly between 0 and 1. Use category_strengths for rank context, and that route for the wallet’s plain win-loss record. Every value reads rows that were already stored. strategy is one classification row the classifier writes on its own schedule, and nothing is classified while your request runs.

{
  "object": "trader",
  "data": {
    "id": "trd_0x204f72f35326db932158cba6adff0b9a1da95e14",
    "username": "swisstony",
    "grade": "S",
    "strategy": {
      "strategy_type": "swing_trader"
    }
  }
}

Expand a batch

The batch body carries one expand array that applies to every wallet in the request. Send 1 to 25 wallets. An empty array, or one with more than 25 entries, answers 400 for the whole request.

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

Use the batch for many wallets instead of sending one expanded request per wallet. The response keeps your input order and keeps any duplicates you sent, and a wallet that fails comes back as its own row with status set to error.

Expand a market snapshot

Market snapshot accepts expand=trust and nothing else. It adds trust.current_price and trust.spread_bps.

curl -H "Authorization: Bearer $OXINSIDER_API_KEY" \
  "https://api.0xinsider.com/api/v1/market/0x123.../snapshot?expand=trust"

trust.current_price says whether the price is one Polymarket published or a midpoint 0xinsider computed from the two best quotes. Without the expand, those two cases look identical.

Expand an event replay page

Event replay accepts expand=trade and nothing else. It adds a trade object to every event, holding what Whale trade returns for that row.

curl -H "Authorization: Bearer $OXINSIDER_API_KEY" \
  "https://api.0xinsider.com/api/v1/events/feed/since?limit=100&expand=trade"

A page of 100 events then costs one request instead of 101. trade is null for an event whose wallet or market 0xinsider has not ingested yet. meta.replay.expand lists what was applied. expand is not part of what the cursor is tied to, so you can turn it on or off between pages.

What it does not do

Use the trader cache. Any recognized expand value on a trader request skips the 60-second cache, so the request is slower than an unexpanded one.
Classify, rank, or compute anything on demand. A row that has not been written yet stays missing until the job that writes it runs.
Work on any other route. Only Trader, Batch traders, Market snapshot, and Event replay read expand.

Getting started

Integrations

Guides

Concepts

Pass the parameter

Trader values

Expand a batch

Expand a market snapshot

Expand an event replay page

What it does not do

​Pass the parameter

​Trader values

​Expand a batch

​Expand a market snapshot

​Expand an event replay page

​What it does not do

Pass the parameter

Trader values

Expand a batch

Expand a market snapshot

Expand an event replay page

What it does not do