GET /v1/trader/{address}/activity — Trader History

Use this endpoint to pull a wallet’s complete trading history — every Buy, Sell, and Redeem action across all Polymarket markets the wallet has touched, ordered newest-first. Each record tells you what happened, which market it occurred in, at what price and size, and how much USDC moved as a result. This endpoint is the starting point for portfolio analysis, PnL reconstruction, or auditing a specific trader’s on-chain activity.

Request

GET https://orbscan.com/open-api/v1/trader/{address}/activity

Path Parameters

string

required

The wallet address to query. Must be a valid Ethereum-style address.Example: 0x6a72f61820b26b1fe4d956e17b6dc2a1ea3033ee

Query Parameters

array

Filter results to one or more market IDs. Repeat the parameter to pass multiple values — for example, ?marketIds=2707644&marketIds=2682268. Each value is a string market ID as returned by Polymarket.

string

Filter to a single transaction hash. The value is automatically lower-cased before matching, so you can pass either mixed- or lower-case hashes.Example: 0x71bf46c3089e2349a62ec6b93638522e8cc635a9836f1308ac7621ce1ecbb609

integer

Only return activity at or after this block height.

integer

Only return activity at or before this block height.

integer

Only return activity at or after this Unix timestamp, in seconds (int64).Example: 1782700000

integer

Only return activity at or before this Unix timestamp, in seconds (int64).

string

Pagination cursor. Pass the nextCursor value (an opaque base64 string) returned by the previous response to fetch the next page. Omit this parameter to start from the first (most recent) page.

integer

Number of records to return per page. Defaults to 50. Maximum is 100; values above 100 are capped automatically.

Example Request

curl -G "https://orbscan.com/open-api/v1/trader/0x6a72f61820b26b1fe4d956e17b6dc2a1ea3033ee/activity" \
  --data-urlencode "limit=50" \
  -H "Authorization: Bearer YOUR_API_KEY"

import requests

address = "0x6a72f61820b26b1fe4d956e17b6dc2a1ea3033ee"
url = f"https://orbscan.com/open-api/v1/trader/{address}/activity"

params = {
    "limit": 50,
}

headers = {
    "Authorization": "Bearer YOUR_API_KEY",
}

response = requests.get(url, params=params, headers=headers)
print(response.json())

Response

boolean

true when the request succeeds, false otherwise.

string

Application-level status code. "0" indicates success.

string

Human-readable status message, for example "success".

object

Container for the paginated results.

Show data fields

ActivityItem[]

Array of activity records, ordered newest-first.

Show ActivityItem fields

integer

Unix timestamp (seconds) of when the action occurred.

string

Human-readable action label. One of Buy, Sell, or Redeem.

string

Record category returned by the API, for example SUMMARY (a trade) or REDEEMS (a redemption).

integer

Numeric action code. 0 = Buy, 1 = Redeem, and so on.

number

Price per share in cents (range 0–100). A value of 78.0 means 78¢ per share.

number

Number of shares involved in this action.

number

Fee charged for this action, in USDC.

number

Gross USDC value of the action before fees.

number

Net USDC change for the wallet. Positive means USDC left the wallet — for example, spending USDC on a buy. Negative means USDC entered the wallet — for example, receiving USDC from a redeem or sell.

string

On-chain transaction hash for this action. Feed this directly into the Get Transaction endpoint to inspect individual fills.

string

Polymarket outcome token ID.

string

Polymarket market ID.

string

URL-friendly slug for the market.

string

URL-friendly slug for the parent event.

string

On-chain condition ID for this market.

string

Human-readable title of the market.

string

Which outcome the trade is on. Either Yes or No.

integer

Zero-based index of the outcome: 0 = Yes, 1 = No.

string

URL of the market’s logo image.

string

The wallet address that was queried.

string | null

Whether the trader was a MAKER or TAKER in this trade. null for non-trade actions such as redeems.

string | null

Opaque base64 cursor for the next page. Pass this as the cursor query parameter in your next request. null means you have reached the last page.

Example Response

{
  "success": true,
  "code": "0",
  "message": "success",
  "data": {
    "items": [
      {
        "time": 1782861128,
        "action": "Redeem",
        "recordType": "REDEEMS",
        "actionType": 1,
        "price": 100.0,
        "quantity": 5.0,
        "fee": 0.0,
        "grossValue": 5.0,
        "transferNetAmount": -5.0,
        "txHash": "0x71bf46c3089e2349a62ec6b93638522e8cc635a9836f1308ac7621ce1ecbb609",
        "tokenId": "91355094557016369228768123360298492968992168419338047915199416797057852525950",
        "marketId": "2707644",
        "marketSlug": "fifwc-fra-swe-2026-06-30-fra",
        "eventSlug": "fifwc-fra-swe-2026-06-30",
        "conditionId": "0x378f7b5c668014d9f6c42c305ec83902f3c8f6c770b336363aed0076ce6ce1c9",
        "marketTitle": "Will France win on 2026-06-30?",
        "positionSide": "Yes",
        "outcomeIndex": 0,
        "logo": "https://polymarket-upload.s3.us-east-2.amazonaws.com/soccer-ball.png",
        "trader": "0x6a72f61820b26b1fe4d956e17b6dc2a1ea3033ee",
        "liquidityRole": null
      },
      {
        "time": 1782765956,
        "action": "Buy",
        "recordType": "SUMMARY",
        "actionType": 0,
        "price": 78.0,
        "quantity": 5.0,
        "fee": 0.02574,
        "grossValue": 3.9,
        "transferNetAmount": 5.0,
        "txHash": "0xbf15dbfb9d3b8b1f5210a582ca78deb73bf77372cb43d8e15edb323750461b1c",
        "tokenId": "91355094557016369228768123360298492968992168419338047915199416797057852525950",
        "marketId": "2707644",
        "marketSlug": "fifwc-fra-swe-2026-06-30-fra",
        "eventSlug": "fifwc-fra-swe-2026-06-30",
        "conditionId": "0x378f7b5c668014d9f6c42c305ec83902f3c8f6c770b336363aed0076ce6ce1c9",
        "marketTitle": "Will France win on 2026-06-30?",
        "positionSide": "Yes",
        "outcomeIndex": 0,
        "logo": "https://polymarket-upload.s3.us-east-2.amazonaws.com/soccer-ball.png",
        "trader": "0x6a72f61820b26b1fe4d956e17b6dc2a1ea3033ee",
        "liquidityRole": "TAKER"
      }
    ],
    "nextCursor": "MTc4Mjc2NTk1Nnw4OTM3Mzk3NHwxNzR8MHhiZjE1..."
  }
}

Filtering

Combine any of the query parameters below to narrow the results returned. All filters are optional and can be used together.

marketIds — restrict results to one or more specific markets. Repeat the parameter for each market ID you want: ?marketIds=2707644&marketIds=2682268. This is useful when you need the history for a wallet within a particular market.
txHash — retrieve the activity record(s) for a single on-chain transaction. Helpful when you already have a hash from an explorer and want the decoded Polymarket context.
fromBlock / toBlock — bound the query by block height. For example, ?fromBlock=88000000&toBlock=88500000 returns only activity within that block range.
fromTimestamp / toTimestamp — bound the query by time. Values are Unix timestamps in seconds. For example, ?fromTimestamp=1782700000&toTimestamp=1782900000 returns activity within a roughly 2.3-day window.

All price values are in cents, not dollars. A price of 78.0 means 78¢ per share, not $78. Divide by 100 to convert to dollars.

Overview

Endpoints

GET /v1/trader/{address}/activity — Trader History

Request

Path Parameters

Query Parameters

Example Request

Response

Example Response

Filtering

​Request

​Path Parameters

​Query Parameters

​Example Request

​Response

​Example Response

​Filtering

Request

Path Parameters

Query Parameters

Example Request

Response

Example Response

Filtering