> **For coding agents and LLMs:** This is one Social Fetch marketing page (markdown export). For API orientation start with [`/llms.txt`](https://www.socialfetch.dev/llms.txt); for auth and crawl rules use [`/agents.txt`](https://www.socialfetch.dev/agents.txt); for every operation use [`/llms-endpoints.txt`](https://www.socialfetch.dev/llms-endpoints.txt).

## This page

- **On-site (HTML):** <https://www.socialfetch.dev/platforms/polymarket/users-wallet-activity>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/polymarket/users-wallet-activity.mdx>

---

# Polymarket Wallet Activity API

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

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

## Request

- **Endpoint:** `GET /v1/polymarket/users/{wallet}/activity`
- **Credits:** 1 credit
Failed requests are free
- **Input:** by wallet
- **Full reference:** [docs](https://www.socialfetch.dev/docs/api/v1/polymarket/users/wallet/activity/get)
- **Platform page:** [/platforms/polymarket](https://www.socialfetch.dev/platforms/polymarket)

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