Skip to main content
GET
cURL
Use this endpoint to see who is moving money in one market right now. It returns the wallets with the largest net buying and the largest net selling over the window, and the window’s totals over every wallet that traded. These are the same numbers the Wallets In / Out panel shows a Pro viewer on the 0xinsider market page, and they are live. A wallet’s net is its buys minus its sells across both outcomes, in USD. A net buyer is not necessarily on the Yes side. To see which outcome a wallet holds, use Market holders.

Parameters

Key response fields

Example

Freshness

The numbers are cached for 60 seconds. Send the last ETag as If-None-Match, and you get a 304 with an empty body when nothing changed.

What it does not return

  • A market 0xinsider does not track. That is a 404 with error.param condition_id. A market outside sports and esports is a 404 with error.reason market_out_of_scope.
  • Windows other than 24 hours and 7 days.
  • More than 25 wallets per side. The summary counts cover the rest.

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

condition_id
string
required

Market condition ID. Accepts the raw provider-backed condition_id returned by /api/v1/markets/search or /api/v1/markets/explore, or the mkt_-prefixed market.id emitted by V1 responses.

Query Parameters

window
enum<string>
default:24h

The window the nets are summed over, ending at the read's clock: 24h (the default) or 7d.

Available options:
24h,
7d

Response

The market's net buyers and sellers

object
string
required
Allowed value: "market_wallets_in_out"
data
object
required

One market's net buyers and net sellers over a 24h or 7d window, as the market page's wallets in/out panel shows a Pro viewer.

meta
object
required