v1

latestOpenAPI 3.1.02026-08-0492239.1 KB

Users

Get user position timeseries for a specific vault

Returns historical value and ROI data for a single vault position. Default order is asc (oldest first, chart-friendly); pass ?order=desc for newest-first list views. Cursor-paginated — pass meta.next_cursor back as ?next= for the next page (cursor is bound to the order it was created with). Defaults to granularity=day (one UTC-midnight snapshot per day); week returns Monday 00:00 UTC snapshots, month returns first-of-month 00:00 UTC snapshots, and hour returns the raw hourly cadence. Default page size is 1000.

get/v1/users/{wallet_address}/positions/{vault_id}/timeseries

Path parameters

wallet_addressstring required

Ethereum wallet address

vault_idstring required

Vault identifier

Query parameters

startstring

Window start: ISO 8601 date (2026-01-01, read as 00:00:00 UTC) or RFC 3339 timestamp (2026-01-01T00:00:00Z).

endstring

Window end: ISO 8601 date (2026-01-01, read as 00:00:00 UTC) or RFC 3339 timestamp (2026-01-01T00:00:00Z).

nextstring

Opaque cursor from previous meta.next_cursor.

limitinteger

Page size (1–10000, default 1000).

orderstring

Sort direction: asc (default) or desc.

granularitystring

Sampling granularity: day (default), hour, week, or month. Day/week/month buckets start at 00:00 UTC; weeks start Monday and months start on the 1st.

Response

Position timeseries