Skip to main content
GET
/
api
/
v1
/
positions
cURL
curl -sS \
  -H 'Authorization: Bearer $OXI_SK' \
  'https://api.0xinsider.com/api/v1/positions'
{
  "object": "list",
  "data": [],
  "has_more": false,
  "next_cursor": null,
  "total": 0,
  "meta": {
    "request_id": "req_example",
    "cached": false
  }
}
Current positions across traders or markets. Each row carries the trader, market, current value, side, and trust-metadata fields (source, freshness, completeness) so you can tell a live provider-backed value from a cached or partial one. 
curl -H "Authorization: Bearer $OXINSIDER_API_KEY" \
  "https://api.0xinsider.com/api/v1/positions?trader=0x863134d00841b2e200492805a01e1e2f5defaa53&limit=50"
For per-fill history (running amount and average entry price), use Position Timeline. When a value is unavailable from the provider, don’t flatten it to 0. See Trust metadata.

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.

Headers

​
If-None-Match
string

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

Query Parameters

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

Pagination cursor from previous response's next_cursor.

​
min_size
number
default:100

Minimum current position value in USD.

​
category
string

Exact match against provider-backed market_canonical.category.

​
min_grade
enum<string>

Minimum trader grade allowlist. A matches S and A; B matches S, A, B; etc.

Available options:
S,
A,
B,
C,
D,
F
​
side
enum<string>

Filter by the binary outcome side. yes maps to outcome_index=0, no to outcome_index=1.

Available options:
yes,
no

Response

Page of positions

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