Skip to main content
GET
/
api
/
v1
/
positions
List current positions (positions-board feed)
curl --request GET \
  --url https://api.0xinsider.com/api/v1/positions \
  --header 'Authorization: Bearer <token>'
{
  "object": "<string>",
  "data": [
    {
      "id": "<string>",
      "platform": "polymarket",
      "wallet": "<string>",
      "side": "YES",
      "shares": 123,
      "current_value_usd": 123,
      "freshness": "fresh",
      "trader": {
        "id": "<string>",
        "address": "<string>",
        "is_new_wallet": true,
        "username": "<string>",
        "grade": "S",
        "win_rate": 123,
        "pnl": 123,
        "markets": 123,
        "wallet_age_days": 123
      },
      "market": {
        "id": "<string>",
        "condition_id": "<string>",
        "title": "<string>",
        "slug": "<string>",
        "event_slug": "<string>",
        "category": "<string>",
        "outcome_label": "<string>",
        "end_date": "2023-11-07T05:31:56Z"
      },
      "avg_price": 123,
      "initial_value_usd": 123,
      "cash_pnl": 123,
      "realized_pnl": 123,
      "last_reconciled_at": "2023-11-07T05:31:56Z"
    }
  ],
  "has_more": true,
  "meta": {
    "request_id": "<string>",
    "cached": true,
    "cache_age_s": 123
  },
  "next_cursor": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://docs.0xinsider.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

Authorization
string
header
required

API key: Authorization: Bearer oxi_sk_live_...

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