Skip to main content
GET
Get user activity

Query Parameters

limit
integer
default:100

Page size. Values above the maximum are clamped to 500.

Required range: 0 <= x <= 500
offset
integer
default:0

Starting index for pagination. Requests past the cap are rejected with a 400 (never silently clamped). To read history deeper than offset 5000, page inside start/end windows — each window has its own offset budget.

Required range: 0 <= x <= 5000
user
string
required

User Profile Address (0x-prefixed, 40 hex chars)

Pattern: ^0x[a-fA-F0-9]{40}$
Example:

"0x56687bf447db6ffa42ffe2204a05edaa20f55839"

market
string[]

Comma-separated list of condition IDs. Mutually exclusive with eventId.

0x-prefixed 64-hex string

Pattern: ^0x[a-fA-F0-9]{64}$
eventId
integer[]

Comma-separated list of event IDs. Mutually exclusive with market.

Required range: x >= 1
type
enum<string>[]
Available options:
TRADE,
SPLIT,
MERGE,
REDEEM,
REWARD,
CONVERSION,
DEPOSIT,
WITHDRAWAL,
YIELD,
MAKER_REBATE,
TAKER_REBATE,
REFERRAL_REWARD
start
integer

Lower-bound timestamp (epoch seconds) for the activity window. Omit or pass 0 for the default window (most recent ~3 years); pass a positive epoch (e.g. 1) to retrieve full history. With sortDirection=ASC, omitting start already reads from the beginning of the account's history (no default window).

Required range: x >= 0
end
integer

Upper-bound timestamp (epoch seconds) for the activity window. Omit for the default (current time); rows newer than end are excluded.

Required range: x >= 0
sortBy
enum<string>
default:TIMESTAMP
Available options:
TIMESTAMP,
TOKENS,
CASH
sortDirection
enum<string>
default:DESC

DESC (default) returns the newest rows first; ASC the oldest first. Both orders are stable — the same query returns the same rows at any limit/offset, so pages compose without gaps or repeats.

Available options:
ASC,
DESC
side
enum<string>
Available options:
BUY,
SELL

Response

Success

proxyWallet
string

User Profile Address (0x-prefixed, 40 hex chars)

Pattern: ^0x[a-fA-F0-9]{40}$
Example:

"0x56687bf447db6ffa42ffe2204a05edaa20f55839"

timestamp
integer<int64>
conditionId
string

0x-prefixed 64-hex string

Pattern: ^0x[a-fA-F0-9]{64}$
Example:

"0xdd22472e552920b8438158ea7238bfadfa4f736aa4cee91a6b86c39ead110917"

type
enum<string>
Available options:
TRADE,
SPLIT,
MERGE,
REDEEM,
REWARD,
CONVERSION,
DEPOSIT,
WITHDRAWAL,
YIELD,
MAKER_REBATE,
TAKER_REBATE,
REFERRAL_REWARD
size
number
usdcSize
number
transactionHash
string
price
number
asset
string
side
enum<string>
Available options:
BUY,
SELL
outcomeIndex
integer
title
string
slug
string
icon
string
eventSlug
string
outcome
string
name
string
pseudonym
string
bio
string
profileImage
string
profileImageOptimized
string
isCombo
boolean

True when this row is part of a combinatorial (multi-market) position. Flag only — combo detail is not embedded here. The row's conditionId equals the combo's combo_condition_id; pass it to /v1/activity/combos or /v1/positions/combos via market_id to fetch legs and detail. Omitted on non-combo rows.