Skip to main content
GET
Get trader activity
Use this endpoint to pull a wallet’s buy, sell, and redeem activity across Polymarket markets, newest first. Each item identifies the action (actionType), market (marketTitle, marketSlug), price and size (price, size), and number of shares moved (netSharesTransferred). Prices are decimals from 0 to 1, so "0.78" means 78 cents per share.
Results are paginated. When the response includes a nextCursor, pass it back as the cursor query parameter to fetch the next page. When nextCursor is null, you’ve reached the end.

Filtering

You can narrow results with any combination of:
  • marketIds: Comma-separated market IDs, such as ?marketIds=2707644,2682268.
  • txHash: A single transaction hash. The API converts it to lowercase.
  • fromBlock / toBlock: A block-height range.
  • fromTimestamp / toTimestamp: A time range in Unix seconds.

Authorizations

Authorization
string
header
required

Paste your Orbscan API key here. The Bearer prefix is added automatically.

Path Parameters

address
string
required

The wallet address to query.

Example:

"0x6a72f61820b26b1fe4d956e17b6dc2a1ea3033ee"

Query Parameters

marketIds
string

Comma-separated market IDs to filter to (e.g. ?marketIds=1,2).

Example:

"2707644,2682268"

txHash
string

Filter to a single transaction hash. The value is automatically lower-cased before matching.

Example:

"0x71bf46c3089e2349a62ec6b93638522e8cc635a9836f1308ac7621ce1ecbb609"

fromBlock
integer

Only include activity at or after this block height.

toBlock
integer

Only include activity at or before this block height.

fromTimestamp
integer<int64>

Only include activity at or after this Unix timestamp, in seconds.

Example:

1782700000

toTimestamp
integer<int64>

Only include activity at or before this Unix timestamp, in seconds.

cursor
string

Pagination cursor. Pass the nextCursor (a base64 string) returned by the previous page to fetch the next page.

limit
integer
default:20

Number of records per page. Defaults to 20, maximum 100. Values above 100 are capped at 100.

Required range: x >= 1

Response

Successful response

message
enum<string>
required
Available options:
OK
Example:

"OK"

status_code
enum<string>
required
Available options:
1
Example:

"1"

data
object
required