Skip to main content
GET
Get user activity

查询参数

limit
integer
默认值:100

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

必填范围: 0 <= x <= 500
offset
integer
默认值: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.

必填范围: 0 <= x <= 5000
user
string
必填

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

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

"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.

必填范围: x >= 1
type
enum<string>[]

Comma-separated list of activity types to include. DEPOSIT and WITHDRAWAL records also require excludeDepositsWithdrawals=false.

可用选项:
TRADE,
SPLIT,
MERGE,
REDEEM,
REWARD,
CONVERSION,
DEPOSIT,
WITHDRAWAL,
YIELD,
MAKER_REBATE,
TAKER_REBATE,
REFERRAL_REWARD
excludeDepositsWithdrawals
boolean
默认值:true

Excludes deposit and withdrawal records. The default true applies even when type requests those records, so to get deposits and withdrawals you must pass false.

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).

必填范围: 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.

必填范围: x >= 0
sortBy
enum<string>
默认值:TIMESTAMP
可用选项:
TIMESTAMP,
TOKENS,
CASH
sortDirection
enum<string>
默认值: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.

可用选项:
ASC,
DESC
side
enum<string>
可用选项:
BUY,
SELL

响应

Success

proxyWallet
string

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

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

"0x56687bf447db6ffa42ffe2204a05edaa20f55839"

timestamp
integer<int64>
conditionId
string

0x-prefixed 64-hex string

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

"0xdd22472e552920b8438158ea7238bfadfa4f736aa4cee91a6b86c39ead110917"

type
enum<string>
可用选项:
TRADE,
SPLIT,
MERGE,
REDEEM,
REWARD,
CONVERSION,
DEPOSIT,
WITHDRAWAL,
YIELD,
MAKER_REBATE,
TAKER_REBATE,
REFERRAL_REWARD
size
number

Token amount for this row. On REDEEM rows it is the number of tokens burned for this row's outcome, so redeeming both sides of a market returns one row per outcome instead of a single combined row.

usdcSize
number

USDC amount for this row. On REDEEM rows it is the payout for this row's outcome and is 0 for a losing outcome; the rows of one redemption sum to the total payout.

transactionHash
string
price
number
asset
string

Token ID this row refers to. Populated on REDEEM rows with the token that row settles. Empty when the row is not token-specific.

side
enum<string>
可用选项:
BUY,
SELL
outcomeIndex
integer

Zero-based index of this row's outcome in the market's outcomes array, so outcome always equals outcomes[outcomeIndex]. On REDEEM rows it identifies the outcome the row settles, not the market's winning outcome. 999 means the outcome could not be determined, in which case outcome is empty.

title
string
slug
string
icon
string

Market artwork. Falls back to the market image, then to the parent event's icon and image, when the market has no icon of its own. Empty on CONVERSION rows.

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.