Skip to main content
GET
/
v1
/
portfolio
/
activities
Get activities
curl --request GET \
  --url https://api.polymarket.us/v1/portfolio/activities \
  --header 'X-PM-Access-Key: <api-key>' \
  --header 'X-PM-Signature: <api-key>' \
  --header 'X-PM-Timestamp: <api-key>'
{
  "activities": [
    {
      "type": "ACTIVITY_TYPE_TRADE",
      "trade": {
        "id": "<string>",
        "marketSlug": "<string>",
        "state": "TRADE_STATE_NEW",
        "createTime": "2023-11-07T05:31:56Z",
        "updateTime": "2023-11-07T05:31:56Z",
        "price": {
          "value": "123.45",
          "currency": "<string>"
        },
        "qty": "<string>",
        "isAggressor": true,
        "costBasis": {
          "value": "123.45",
          "currency": "<string>"
        },
        "realizedPnl": {
          "value": "123.45",
          "currency": "<string>"
        }
      },
      "positionResolution": {
        "marketSlug": "<string>",
        "beforePosition": {
          "netPosition": "<string>",
          "qtyBought": "<string>",
          "qtySold": "<string>",
          "cost": {
            "value": "123.45",
            "currency": "<string>"
          },
          "realized": {
            "value": "123.45",
            "currency": "<string>"
          },
          "bodPosition": "<string>",
          "expired": true,
          "updateTime": "2023-11-07T05:31:56Z",
          "marketMetadata": {
            "slug": "<string>",
            "icon": "<string>",
            "title": "<string>",
            "outcome": "<string>",
            "eventSlug": "<string>"
          },
          "cashValue": {
            "value": "123.45",
            "currency": "<string>"
          },
          "qtyAvailable": "<string>"
        },
        "afterPosition": {
          "netPosition": "<string>",
          "qtyBought": "<string>",
          "qtySold": "<string>",
          "cost": {
            "value": "123.45",
            "currency": "<string>"
          },
          "realized": {
            "value": "123.45",
            "currency": "<string>"
          },
          "bodPosition": "<string>",
          "expired": true,
          "updateTime": "2023-11-07T05:31:56Z",
          "marketMetadata": {
            "slug": "<string>",
            "icon": "<string>",
            "title": "<string>",
            "outcome": "<string>",
            "eventSlug": "<string>"
          },
          "cashValue": {
            "value": "123.45",
            "currency": "<string>"
          },
          "qtyAvailable": "<string>"
        },
        "updateTime": "2023-11-07T05:31:56Z",
        "tradeId": "<string>",
        "side": "POSITION_RESOLUTION_SIDE_LONG"
      },
      "accountBalanceChange": {
        "transactionId": "<string>",
        "status": "ACCOUNT_BALANCE_CHANGE_STATUS_PENDING",
        "amount": {
          "value": "123.45",
          "currency": "<string>"
        },
        "updateTime": "2023-11-07T05:31:56Z",
        "createTime": "2023-11-07T05:31:56Z"
      }
    }
  ],
  "nextCursor": "<string>",
  "eof": true
}

Authorizations

​
X-PM-Access-Key
string
header
required

Your API key ID (UUID). Generate at polymarket.us/developer.

​
X-PM-Timestamp
string
header
required

Unix timestamp in milliseconds. Must be within 30 seconds of server time.

​
X-PM-Signature
string
header
required

Base64-encoded Ed25519 signature of timestamp + method + path. See Authentication for details.

Query Parameters

​
limit
integer<int32>

Maximum number of activities to return per page. Use with cursor for pagination. Default: 100. Example: 50

​
cursor
string

Pagination cursor from a previous response's nextCursor field. Use to fetch the next page of results. Omit for the first request

​
marketSlug
string

Filter activities by a specific market slug. Returns only activities (trades, resolutions) related to that market. Example: will-team-a-win

​
types
enum<string>[]

Filter by activity types. When specified, only returns activities of the selected types. TRADE (order executions), POSITION_RESOLUTION (market settlements), ACCOUNT_DEPOSIT/WITHDRAWAL (fund transfers)

Available options:
ACTIVITY_TYPE_TRADE,
ACTIVITY_TYPE_POSITION_RESOLUTION,
ACTIVITY_TYPE_ACCOUNT_DEPOSIT,
ACTIVITY_TYPE_ACCOUNT_ADVANCED_DEPOSIT,
ACTIVITY_TYPE_ACCOUNT_WITHDRAWAL,
ACTIVITY_TYPE_REFERRAL_BONUS,
ACTIVITY_TYPE_TRANSFER
​
sortOrder
enum<string>

Sort order for activities by timestamp. DESCENDING returns newest first (default), ASCENDING returns oldest first

Available options:
SORT_ORDER_DESCENDING,
SORT_ORDER_ASCENDING

Response

List of activities

​
activities
object[]

List of activities

​
nextCursor
string

Pagination cursor for next page

​
eof
boolean

True if this is the last page