Skip to main content
GET
/
activity
Get user activity
curl --request GET \
  --url https://data-api.polymarket.com/activity
[
  {
    "proxyWallet": "0x56687bf447db6ffa42ffe2204a05edaa20f55839",
    "timestamp": 123,
    "conditionId": "0xdd22472e552920b8438158ea7238bfadfa4f736aa4cee91a6b86c39ead110917",
    "type": "TRADE",
    "size": 123,
    "usdcSize": 123,
    "transactionHash": "<string>",
    "price": 123,
    "asset": "<string>",
    "side": "BUY",
    "outcomeIndex": 123,
    "title": "<string>",
    "slug": "<string>",
    "icon": "<string>",
    "eventSlug": "<string>",
    "outcome": "<string>",
    "name": "<string>",
    "pseudonym": "<string>",
    "bio": "<string>",
    "profileImage": "<string>",
    "profileImageOptimized": "<string>"
  }
]

Documentation Index

Fetch the complete documentation index at: https://docs.polymarket.com/llms.txt

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

Query Parameters

​
limit
integer
default:100
Required range: 0 <= x <= 500
​
offset
integer
default:0
Required range: 0 <= x <= 10000
​
user
string
required

User Profile Address (0x-prefixed, 40 hex chars)

Pattern: ^0x[a-fA-F0-9]{40}$
Example:

"0x56687bf447db6ffa42ffe2204a05edaa20f55839"

​
market
string[]

Comma-separated list of condition IDs. Mutually exclusive with eventId.

0x-prefixed 64-hex string

Pattern: ^0x[a-fA-F0-9]{64}$
​
eventId
integer[]

Comma-separated list of event IDs. Mutually exclusive with market.

Required range: x >= 1
​
type
enum<string>[]
Available options:
TRADE,
SPLIT,
MERGE,
REDEEM,
REWARD,
CONVERSION,
MAKER_REBATE,
REFERRAL_REWARD
​
start
integer
Required range: x >= 0
​
end
integer
Required range: x >= 0
​
sortBy
enum<string>
default:TIMESTAMP
Available options:
TIMESTAMP,
TOKENS,
CASH
​
sortDirection
enum<string>
default:DESC
Available options:
ASC,
DESC
​
side
enum<string>
Available options:
BUY,
SELL

Response

Success

​
proxyWallet
string

User Profile Address (0x-prefixed, 40 hex chars)

Pattern: ^0x[a-fA-F0-9]{40}$
Example:

"0x56687bf447db6ffa42ffe2204a05edaa20f55839"

​
timestamp
integer<int64>
​
conditionId
string

0x-prefixed 64-hex string

Pattern: ^0x[a-fA-F0-9]{64}$
Example:

"0xdd22472e552920b8438158ea7238bfadfa4f736aa4cee91a6b86c39ead110917"

​
type
enum<string>
Available options:
TRADE,
SPLIT,
MERGE,
REDEEM,
REWARD,
CONVERSION,
MAKER_REBATE,
REFERRAL_REWARD
​
size
number
​
usdcSize
number
​
transactionHash
string
​
price
number
​
asset
string
​
side
enum<string>
Available options:
BUY,
SELL
​
outcomeIndex
integer
​
title
string
​
slug
string
​
icon
string
​
eventSlug
string
​
outcome
string
​
name
string
​
pseudonym
string
​
bio
string
​
profileImage
string
​
profileImageOptimized
string