Skip to main content
GET
/
v1
/
polymarket
/
activity
curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.predexon.com/v1/polymarket/activity?user=0x1234...&limit=50"
{
  "activities": [
    {
      "side": "SPLIT",
      "market_slug": "will-donald-trump-win-the-2024-us-presidential-election",
      "condition_id": "0x1a2b3c4d...",
      "shares": 1000000000,
      "shares_normalized": 1000.0,
      "price": 0.62,
      "tx_hash": "0xabc123...",
      "title": "Will Donald Trump win the 2024 Presidential Election?",
      "timestamp": 1704153600,
      "user": "0x1234567890..."
    },
    {
      "side": "REDEEM",
      "market_slug": "will-btc-hit-50k-jan",
      "condition_id": "0x5678efgh...",
      "shares": 500000000,
      "shares_normalized": 500.0,
      "price": 1.0,
      "tx_hash": "0xdef456...",
      "title": "Will Bitcoin hit $50k in January 2024?",
      "timestamp": 1704067200,
      "user": "0x1234567890..."
    }
  ],
  "pagination": {
    "limit": 50,
    "count": 50,
    "pagination_key": "eyJ0aW1lc3RhbXAiOjE3MDQwNjcyMDAsInR4X2hhc2giOiIweGRlZjQ1NiJ9",
    "has_more": true
  }
}

Overview

Query trading activity for a specific wallet address. This includes minting operations (splits), redemptions (merges, redeems), and position changes.
user
string
required
User wallet address (required)
market_slug
string
Filter by market slug
condition_id
string
Filter by condition ID
start_time
integer
Unix timestamp (seconds) for start of range
end_time
integer
Unix timestamp (seconds) for end of range
order
string
default:"desc"
Sort order: asc or desc by timestamp
limit
integer
default:"100"
Number of activities to return (1-500)
pagination_key
string
Pagination key for cursor-based pagination (from previous response)
Only one of market_slug or condition_id can be provided.
activities
array
pagination
object

Activity Types

TypeDescription
SPLITUser deposited collateral to create YES+NO token pairs
MERGEUser combined YES+NO pairs back to collateral
REDEEMUser redeemed winning tokens after market resolution
curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.predexon.com/v1/polymarket/activity?user=0x1234...&limit=50"
{
  "activities": [
    {
      "side": "SPLIT",
      "market_slug": "will-donald-trump-win-the-2024-us-presidential-election",
      "condition_id": "0x1a2b3c4d...",
      "shares": 1000000000,
      "shares_normalized": 1000.0,
      "price": 0.62,
      "tx_hash": "0xabc123...",
      "title": "Will Donald Trump win the 2024 Presidential Election?",
      "timestamp": 1704153600,
      "user": "0x1234567890..."
    },
    {
      "side": "REDEEM",
      "market_slug": "will-btc-hit-50k-jan",
      "condition_id": "0x5678efgh...",
      "shares": 500000000,
      "shares_normalized": 500.0,
      "price": 1.0,
      "tx_hash": "0xdef456...",
      "title": "Will Bitcoin hit $50k in January 2024?",
      "timestamp": 1704067200,
      "user": "0x1234567890..."
    }
  ],
  "pagination": {
    "limit": 50,
    "count": 50,
    "pagination_key": "eyJ0aW1lc3RhbXAiOjE3MDQwNjcyMDAsInR4X2hhc2giOiIweGRlZjQ1NiJ9",
    "has_more": true
  }
}

Understanding Activity Flow

Authorizations

x-api-key
string
header
required

API key for authentication. Get your free key at dashboard.predexon.com

Query Parameters

user
string
required

User wallet address

start_time
integer | null

Unix timestamp (seconds) for start

end_time
integer | null

Unix timestamp (seconds) for end

market_slug
string | null

Filter by market slug

condition_id
string | null

Filter by condition ID

limit
integer
default:100

Number of activities to return

Required range: 1 <= x <= 500
order
enum<string>
default:desc

Sort order: asc or desc

Available options:
asc,
desc
pagination_key
string | null

Pagination key for cursor-based pagination

Response

Successful Response

Activity endpoint response.

activities
Activity · object[]
required
pagination
CursorPagination · object
required

Cursor-based pagination for endpoints that don't support offset.