Expanding Responses

Trader responses stay lean by default. The expensive fields, strategy classification, per-category performance, quant metrics, and trust metadata, are left out unless you ask for them. The expand parameter pulls them in. This keeps the common path fast. Expanded fields skip the cache and read fresh, so request them only when you need them.

How to pass it

expand is repeatable. Use a comma-separated list or repeat the bracketed key:

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

# Repeated bracket form
curl -H "Authorization: Bearer $OXINSIDER_API_KEY" \
  "https://api.0xinsider.com/api/v1/trader/0x204f...?expand[]=strategy&expand[]=trust"

Unknown values are ignored, so a forward-compatible client can safely pass options an older API build does not recognize.

The four expand values

Available on GET /api/v1/trader/{address} and POST /api/v1/traders/batch:

Value	Adds field	What it contains
`strategy`	`strategy`	The trader’s ML strategy classification: `strategy_type`, an optional `description`, and `confidence`. See Strategy types.
`categories`	`category_strengths`	Per-category performance, keyed by category: rank within the category, total P&L, markets traded, wins, losses, and win rate.
`quant_metrics`	`quant_metrics`	A fixed set of nine curated risk and performance metrics, including the `smart_score` and `copy_score` headline scores. See Quant metrics.
`trust`	`trust`	Field-level trust metadata: source, freshness, reconciliation, and completeness for each derived field.

Example

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

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

Market snapshots

GET /api/v1/market/{condition_id}/snapshot accepts expand=trust only. It adds trust metadata for the snapshot’s current_price and spread_bps. The trader-only values (strategy, categories, quant_metrics) do not apply to markets.

Cost

Expanded fields read live instead of from cache, so an expanded request is heavier than a plain one. Two habits keep this cheap:

Request only the expansions you use on a given screen.
For many traders at once, use POST /api/v1/traders/batch with a single expand set rather than one expanded request per trader.

Getting Started

Guides

Concepts

How to pass it

The four expand values

Example

Market snapshots

Cost

​How to pass it

​The four expand values

​Example

​Market snapshots

​Cost

How to pass it

The four expand values

Example

Market snapshots

Cost