List Polymarket user activity
List a Polymarket wallet's trades, splits, merges and redemptions.
Headers
Get your API keyAPI key (`sfk_...`)
Wallet address: 0x followed by 40 hex digits.
pattern: ^0x[0-9a-fA-F]{40}$
Only this kind of activity.
one of: TRADE, SPLIT, MERGE, REDEEM, REWARD, CONVERSION, YIELD, MAKER_REBATE
Only activity in this market.
pattern: ^0x[0-9a-fA-F]{64}$
Only activity at or after this time, unix seconds.
≥ 1 · ≤ 4102444800
Only activity at or before this time, unix seconds.
≥ 1 · ≤ 4102444800
Items per page, 1–1000. Default: 100.
≥ 1 · ≤ 1000
Pass `page.nextCursor` from the previous response to get the next page. Keep the other filters the same.
min 1 chars · max 6000 chars
Endpoint-specific response payload.
`found` on success. A wallet with no activity, or one that does not exist, returns an empty list.
one of: found, not_found
The wallet asked for.
Newest first.
`TRADE`, `SPLIT`, `MERGE`, `REDEEM`, `REWARD` and so on.
When it happened (ISO-8601, UTC).
`BUY` or `SELL` for trades.
Price (0 to 1) for trades.
Shares involved. A number, or an exact decimal string when the value has more digits than a number can hold.
Dollar value of the activity. A number, or an exact decimal string when the value has more digits than a number can hold.
Outcome name.
Position of the outcome in the market.
Outcome token id.
Condition id of the market.
The market a trade happened in.
Market question.
Market slug.
Event slug.
Icon URL.
Transaction hash on the Polygon chain.
Pagination state for the current page.
Whether another page is available.
Cursor to pass in the next request when more pages exist; null on the last page.
Metadata describing the request and billing outcome.
Unique request identifier for tracing this API call.
min 1 chars
Credits charged for this request.
≥ 0
Public API version that served the response.
one of: v1
Code example
curl "https://api.socialfetch.dev/v1/polymarket/users/0x56687bf447db6ffa42ffe2204a05edaa20f55839/activity?type=TRADE&limit=10" \
-H "x-api-key: YOUR_API_KEY"Responses
Polymarket user activity.