List Polymarket trades
List Polymarket trades across all markets or one wallet.
Headers
Get your API keyAPI key (`sfk_...`)
Only this wallet's trades. Without it the list is the live tape across all markets.
pattern: ^0x[0-9a-fA-F]{40}$
Only trades in this event.
pattern: ^\d{1,10}$
Only trades on this side.
one of: BUY, SELL
Only trades of at least this many US dollars.
≥ 0 · ≤ 1000000000000
Only trades at or after this time, unix seconds.
≥ 1 · ≤ 4102444800
Only trades 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; `not_found` when the market does not exist. A market that exists with no trades yet returns an empty list.
one of: found, not_found
Newest first.
Transaction hash on the Polygon chain.
When the trade happened (ISO-8601, UTC).
`BUY` or `SELL`.
Price as a probability between 0 and 1.
Shares traded. A number, or an exact decimal string when the value has more digits than a number can hold.
Outcome name, for example `Yes`.
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.
The public profile attached to a wallet.
The trader's wallet address (public on the Polygon chain).
Chosen username, as Polymarket sends it. Null when the trader has not set one. Present even when the holder does not show it on their own profile (see `usernamePublic`).
Whether the holder shows the chosen username publicly on their profile. Null when Polymarket does not say, as on the trade tape.
Auto-generated name such as `Velvety-Relief`.
Profile bio.
Profile image URL.
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/trades?limit=10" \
-H "x-api-key: YOUR_API_KEY"Responses
Polymarket trades.