Skip to main content
GET
List one wallet's sports and esports markets
Use this endpoint for the rows on a wallet’s profile positions table, including markets that have settled. Positions is the live board and still leaves resolved markets out. status=closed is the profile’s Closed tab and the default. status=open is the Open tab. status=all returns both in one time order, newest last trade first. The endpoint needs a Pro or Max key.

Parameters

Which rows each status returns

A row is in open when the position is still live, its stored cost is at least $0.10, and the market has no winner. A row is in closed when the position is no longer live, or the market has a winner, or the live position’s stored cost is under $0.10. A live position with no winner and no stored cost is returned only for status=all.

Key response fields

Rows are ordered by last_trade_at descending, then condition_id descending. A row with no last_trade_at comes after every dated row, as on the profile. has_more is true when another page exists. next_cursor is absent on the last page. There is no total count.

Example

Send the returned next_cursor as cursor with the same status. A cursor from another status returns 400 with param cursor. An unknown status returns 400 with param status.

What it does not return

  • Markets outside sports and esports.
  • The wallet address on each row. You already named the wallet.
  • A total count of matching markets.
  • The live positions board. That stays GET /api/v1/positions, which still leaves resolved markets out.
  • A wallet 0xinsider has no record of. That returns 404.

Caching

Save the response’s ETag and send it in If-None-Match on your next request. If nothing has 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).

Scopes

read

Read markets, traders, large trades, positions, reports, search, the event stream and every MCP tool

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

status
enum<string>
default:closed

open, closed (default) or all. closed is the profile Closed tab. all is one time order, newest last trade first, not open rows before closed rows.

Available options:
open,
closed,
all
limit
integer
default:20

Markets per page. Default 20, at most 100.

Required range: 1 <= x <= 100
cursor
string

next_cursor from the previous page. It is bound to the same status.

Response

One page of the wallet's sports and esports markets.

object
string
required
Allowed value: "list"
data
object[]
required
meta
object
required
has_more
boolean
required
next_cursor
string
total
integer