Skip to main content
GET
Get user activity
获取单个钱包在 Polymarket 上的链上活动——这是按地址查询,而不是全市场成交流。user 参数为必填。适合用于还原某个交易者做过什么——仓位拆分、合并和赎回,包含数量、价格以及完成结算的交易;还可用 market_slug、condition_id 以及 start_time / end_time(Unix 秒)区间进一步收窄。 返回 activities[],包含 side(MERGE / SPLIT / REDEEM)、market_slug、condition_id、shares、price、timestamp 和 tx_hash,并附带 pagination 对象,其中的 key 可作为 pagination_key 回传。 如需全市场价格而不是单个钱包的历史,请使用 get_polymarket_markets。
第一次用? 把任意 MCP 客户端指向 https://mcp.aisa.one/mcp —— Claude Code、 Codex、Cursor、VS Code 都可以。鉴权走 OAuth:客户端打开浏览器,你点一次 Allow,不需要粘贴任何 key。各客户端的具体命令和每次调用的价格见 aisa.one/zh-cn/mcp。
在你的 agent 里把这个端点跑起来 →

授权

Authorization
string
header
必填

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

查询参数

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
eventId
integer[]

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

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

limit
integer
默认值:100

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

必填范围: 0 <= x <= 500
market
string[]

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

0x-prefixed 64-hex string

Pattern: ^0x[a-fA-F0-9]{64}$
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
side
enum<string>
可用选项:
BUY,
SELL
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
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
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
user
string
必填

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

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

"0x56687bf447db6ffa42ffe2204a05edaa20f55839"

响应

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.