Skip to main content
GET
/
v1
/
portfolio
/
activities
Get activities
curl --request GET \
  --url https://api.polymarket.us/v1/portfolio/activities
{
  "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
}

Documentation Index

Fetch the complete documentation index at: https://docs-polymarket-us.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

Query Parameters

​
limit
integer<int32>

Maximum number of activities to return

​
cursor
string

Pagination cursor from previous response

​
marketSlug
string

Market slug to filter upon

​
types
enum<string>[]

Types of activities to filter upon

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 the activities

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