Get Prediction Activity

Get a wallet’s prediction market trading activity (buys, sells, redemptions).

GET /2/wallet/pm/activity

Get Prediction Activity

cURL

curl --request GET \
  --url https://pm-api-prod-eu.mobula.io/api/2/wallet/pm/activity

200

{
  "data": [
    {}
  ]
}

Alpha — This endpoint is part of the Prediction Markets API, currently in early access. May change without notice.

Query Parameters

wallet · string · required

The wallet address to get activity for.

platforms · string

Comma-separated list of platforms to filter by.

types · string

Comma-separated list of activity types (e.g., buy,sell).

from · string | number

Start time. Accepts Unix timestamp in milliseconds (e.g., 1709913600000) or ISO 8601 string (e.g., 2024-03-01T00:00:00Z).

to · string | number

End time. Accepts Unix timestamp in milliseconds (e.g., 1709913600000) or ISO 8601 string (e.g., 2024-03-01T00:00:00Z).

limit · number · default: "50"

Number of activities to return (1 to 100).

page · number · default: "1"

Page number (1-indexed).

offset · number · default: "0"

Pagination offset (alternative to page).

order · string · default: "desc"

Sort order: asc or desc.

cursorHash · string

Transaction hash to anchor cursor pagination from.

cursorDirection · string · default: "before"

Cursor direction: before or after.

Response

data · array

Array of wallet activity records.

Show Activity Record

activityId · string

Activity ID.

type · string

Activity type (buy, sell, etc.).

platform · string

Platform name.

marketId · string

Market identifier.

outcomeId · string

Outcome token ID.

question · string

Market question.

label · string

Outcome label.

sizeToken · number

Number of tokens traded.

priceUSD · number

Execution price.

amountUSD · number

Trade value in USD.

txHash · string

Transaction hash.

txDateMs · number

Activity timestamp in milliseconds.

txDateIso · string

Activity timestamp in ISO 8601 format.

pagination · object

Pagination metadata.

Show Pagination

page · number

Current page number.

offset · number

Current offset.

limit · number

Results per page.

pageEntries · number

Number of entries in this page.

hostname · string

Server node identifier.

took · number

Request processing time in milliseconds.

Usage Example

curl -X GET "https://api.mobula.io/api/2/wallet/pm/activity?wallet=0xYourWalletAddress&types=buy,sell&limit=20"

Example Response

{
  "data": [
    {
      "activityId": "act-001",
      "type": "buy",
      "platform": "polymarket",
      "marketId": "0x1234...",
      "outcomeId": "71321...",
      "question": "Will ETH reach $10,000 by end of 2026?",
      "label": "Yes",
      "sizeToken": 100,
      "priceUSD": 0.35,
      "amountUSD": 35,
      "txHash": "0xdef456...",
      "txDateMs": 1709913600000,
      "txDateIso": "2024-03-08T16:00:00.000Z"
    }
  ],
  "pagination": {
    "page": 1,
    "offset": 0,
    "limit": 20,
    "pageEntries": 1
  },
  "hostname": "node-xyz",
  "took": 42
}

Query Parameters

wallet · string · required

User EOA wallet address. The API resolves the matching Safe trading account internally.

Example:

"0x0000000000000000000000000000000000000001"

platforms · string

Comma-separated platform filter (e.g. polymarket).

types · string

Comma-separated activity type filter (e.g. buy,sell).

from · string

Start of the time window (ISO date or Unix timestamp).

to · string

End of the time window (ISO date or Unix timestamp).

limit · integer · default: 50

Page size (1-100).

Required range: 1 <= x <= 100

page · integer · default: 1

1-based page index (alternative to offset).

Required range: x >= 1

offset · integer · default: 0

Pagination offset.

Required range: x >= 0

order · enum<string> · default: desc

Available options: asc, desc

cursorHash · string

Opaque cursor hash for keyset pagination.

cursorDirection · enum<string> · default: before

Available options: before, after

Response

200 - application/json

Activity list

data · object[]