Skip to main content
GET
/
api
/
v1
/
trader
/
{address}
/
position-timeline
cURL
curl -sS \
  -H 'Authorization: Bearer $OXI_SK' \
  'https://api.0xinsider.com/api/v1/trader/{address}/position-timeline'
{
  "object": "list",
  "data": [],
  "has_more": false,
  "next_cursor": null,
  "total": 0,
  "meta": {
    "request_id": "req_example",
    "cached": false
  }
}
Per-market fill history for one trader. Each fill carries a server-computed running amount and average entry price, so you can see how a position was built or unwound without recomputing it client-side. 
curl -H "Authorization: Bearer $OXINSIDER_API_KEY" \
  "https://api.0xinsider.com/api/v1/trader/0x863134d00841b2e200492805a01e1e2f5defaa53/position-timeline?condition_id=0xabc..."
If you hold a username, a trd_-prefixed trader id, or the integer internal trader id instead of the wallet address, use Get Trader Position Timeline, which resolves all four identity shapes and returns a byte-identical body.

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.

Path Parameters

​
address
string
required

Trader wallet address (0x...) or trd_-prefixed trader ID emitted by this API. Case-insensitive wallet 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