Skip to main content
GET
Get trader category win records
Use this endpoint to check a wallet’s settled results in each category. It returns wins, decided, and win_rate, ordered by the busiest category first. For the wallet’s ranking against other wallets in each category, request Trader with expand=categories and read category_strengths.

Parameters

Key response fields

Example

What it does not return

  • A category or game the wallet has no settled market in. The entry is omitted, so absent means no record and never a 0% record.
  • A percentage under 5 decided markets. The counts stay and win_rate is null, so you can inspect the sample size without treating a small sample as a published rate.
  • A game as a filter of its own. Ask for esports and read games.
  • The same numbers as category_strengths. That field counts only positions over $20 with an entry price between 0 and 1, so its sample and win rate can differ.
  • A 200 for a wallet that does not resolve. That returns 404. A wallet 0xinsider knows but that has no settled market gets a 200 and an empty records array.

Caching

Save the response’s ETag and send it in If-None-Match on your next request. If the record has not changed, the server returns 304 Not Modified with no body.

Authorizations

Authorization
string
header
required

Legacy default or named integration API key, or OAuth 2.1 access token, in the Authorization header as Bearer oxi_sk_live_... or Bearer oxi_at_.... Default keys retain full access; integration keys are limited to their approved read, webhooks, export and usage scopes and expire within 90 days. All credentials share the owner's account limits. Data calls require an active Pro subscription and return live data. A 401 carries WWW-Authenticate: Bearer resource_metadata="https://api.0xinsider.com/.well-known/oauth-protected-resource" (RFC 6750 section 3, RFC 9728).

Headers

X-Query-Validation
enum<string>

Opt into strict query-name validation. The default is compatible: unknown names are ignored and reported in X-Query-Ignored. With strict, an unknown name returns 400 bad_request with error.reason unknown_query_parameter before the handler runs, including when its percent escape is incomplete.

Available options:
strict
If-None-Match
string

Conditional GET validator from a previous ETag. Matching values return 304 Not Modified with an empty body.

Path Parameters

address
string
required

Wallet address (0x...), username, or trd_-prefixed trader id.

Query Parameters

category
string

Filter to one canonical category, matched through the same rollup every other category surface uses: soccer, EPL and champions league all reach Soccer, every esports label folds into Esports, and football is AMERICAN football and reaches Football. A filter that reaches Esports returns the Esports record with all of its games; a game is not a filter of its own, so ask for esports and read games. A value that matches no record answers 200 with an empty records array, never 404.

Response

Trader category win records

object
string
required
Allowed value: "trader_category_records"
data
object
required
meta
object
required