Social Fetch
Start for freeStart free
Polymarket hub

Polymarket Wallet Activity API

Every action by a wallet, from trades and splits to rewards and redemptions.

GET /v1/polymarket/users/{wallet}/activity

1 credit Failed requests are free

Try in playgroundFull API docs

About this endpoint

GET /v1/polymarket/users/{wallet}/activity returns data.activity, newest first. Each row has type, at, side (BUY or SELL for trades), price, shares, usdcSize, outcome, outcomeIndex, tokenId, conditionId, market and transactionHash.

type filters to one of TRADE, SPLIT, MERGE, REDEEM, REWARD, CONVERSION, YIELD or MAKER_REBATE. conditionId narrows to one market, from and to are unix seconds, and limit is 1 to 1000 and defaults to 100. A wallet with no activity returns a found answer with an empty list.

Polymarket Wallet Activity API FAQ

How is this different from the trades tape?

This route includes non-trade actions such as splits, merges, redemptions and rewards, and it is pinned to one wallet. The global and market trade routes return fills only.

What is usdcSize?

The dollar value of the activity. For a trade it is shares times price; for a reward or redemption it is the value moved. It is not always the same as the market's total volume.

Can I filter one market?

Pass conditionId with 0x and 64 hex digits. Combine it with type to see only trades or only redemptions in that market.

What does lookupStatus mean on this route?

found means the object or list was returned. not_found means no matching object exists. HTTP 200 only means the request finished, so branch on data.lookupStatus before storing a row.

How much does this route cost?

Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged: that field is the billing source of truth.

Other Polymarket endpoints