Skip to main content
GET
/
api
/
v1
/
trader
/
{address}
/
position-timeline
Get a trader's position timeline for one market
curl --request GET \
  --url https://api.0xinsider.com/api/v1/trader/{address}/position-timeline \
  --header 'Authorization: Bearer <token>'
{
  "object": "<string>",
  "data": [
    {
      "id": "<string>",
      "event_timestamp": "2023-11-07T05:31:56Z",
      "action": "buy",
      "outcome_side": "yes",
      "amount_delta": 123,
      "price": 123,
      "usdc_notional": 123,
      "tx_hash": "<string>",
      "running_amount": 123,
      "running_avg_price": 123
    }
  ],
  "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_...

Path Parameters

address
string
required

Trader wallet address (0x...). Case-insensitive — addresses are lowercased server-side.

Query Parameters

condition_id
string
required

Market condition_id. One timeline per (trader, market).

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

Pagination cursor from previous response's next_cursor.

Response

Position timeline page

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