Skip to main content
GET
/
api
/
v1
/
large-positions
cURL
curl -sS \
  -H 'Authorization: Bearer $OXI_SK' \
  'https://api.0xinsider.com/api/v1/large-positions?min_grade=A&limit=10'
{
  "object": "list",
  "data": [],
  "has_more": false,
  "next_cursor": null,
  "meta": {
    "request_id": "req_example",
    "cached": false
  }
}
The largest current open positions held by graded traders, value-descending, with opaque cursor pagination. Polymarket-only by design: the scanner filters on platform = 'polymarket', so a Kalshi or unknown condition_id filter returns an empty list rather than fabricated rows. Useful filters:
  • min_size=25000: floor on position value in USD.
  • min_grade=A: minimum trader grade.
  • category=crypto: provider-backed market category.
  • condition_id=...: scope to one market. Accepts the raw provider condition_id or the mkt_-prefixed market id.
curl -H "Authorization: Bearer $OXINSIDER_API_KEY" \
  "https://api.0xinsider.com/api/v1/large-positions?min_grade=A&min_size=25000&limit=50"
The API key already proves an active subscription, so authed callers get full access with no teaser cap. Cursor-paginated: pass next_cursor from one response as cursor on the next. See Pagination.

Authorizations

Authorization
string
header
required

API key: Authorization: Bearer oxi_sk_live_... for live data (requires an active Insider subscription), or oxi_sk_test_... for sandbox/test mode (free account, deterministic fixture data, no live rows). Both key classes use the same paths; the prefix selects live vs sandbox.

Query Parameters

limit
integer
default:20
Required range: 1 <= x <= 100
cursor
string

Opaque pagination cursor from a previous response.

min_size
number

Minimum position value in USD.

Required range: x >= 0
category
string

Filter by provider-backed market category.

min_grade
enum<string>

Minimum trader grade.

Available options:
S,
A,
B,
C,
D,
F
condition_id
string

Scope to one market. Accepts the raw provider condition_id or the mkt_-prefixed market id (round-trips a value from a list response). Polymarket-only; a Kalshi or unknown id returns [].

Response

Large positions list

object
string
required
Allowed value: "list"
data
object[]
required
has_more
boolean
required
meta
object
required
next_cursor
string | null

Opaque cursor for the next page; absent on the last page.

total
integer | null

Total ranked rows when the read model exposes a count; may be absent.