Get Prediction Market Trades

Get trade history for a prediction market, with optional outcome and time filters.

GET /2/pm/market/trades

Get prediction market trades

cURL

curl --request GET \
  --url https://demo-api.mobula.io/api/2/pm/market/trades

200

{
  "data": [
    {
      "id": "<string>",
      "marketId": "<string>",
      "outcomeId": "<string>",
      "platform": "<string>",
      "type": "buy",
      "priceUSD": 123,
      "sizeToken": 123,
      "amountUSD": 123,
      "date": 123,
      "swapRecipient": "<string>",
      "transactionHash": "<string>"
    }
  ],
  "pagination": {
    "page": 123,
    "offset": 123,
    "limit": 123,
    "pageEntries": 123,
    "totalCount": 123,
    "hasMore": true,
    "nextCursor": "<string>"
  },
  "hostname": "<string>",
  "took": 123
}

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

Query Parameters

platform · string · required

The prediction market platform (e.g., polymarket).

marketId · string · required

The platform-specific market identifier.

outcomeId · string

Filter trades to a specific outcome. If omitted, returns trades for all outcomes.

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).

minAmountUSD · number · default: "0"

Minimum trade value in USD. Filters out trades below this threshold.

limit · number · default: "50"

Number of trades to return (1 to 500).

offset · number · default: "0"

Pagination offset. Ignored when cursor is provided.

cursor · string

Cursor for keyset pagination. Use the nextCursor value from a previous response to fetch the next page. Takes precedence over offset.

sortOrder · string · default: "desc"

Sort direction for trades by date. Possible values: asc, desc.

Response

data · array

Array of trade records.

Show Trade Record

id · string

Trade ID.

marketId · string

Market identifier.

outcomeId · string

Outcome token ID.

platform · string

Platform name.

type · string

Trade type: buy or sell.

priceUSD · number

Execution price (0 to 1).

sizeToken · number

Trade size in tokens.

amountUSD · number

Trade value in USD.

date · number

Trade timestamp in milliseconds.

swapRecipient · string | null

Trader proxy wallet address. Available for backfilled trades, null for real-time trades.

transactionHash · string | null

Transaction hash. Available for backfilled trades, null for real-time trades.

pagination · object

Pagination metadata.

Show Pagination

page · number

Current page number (1-based).

offset · number

Current offset.

limit · number

Requested page size.

pageEntries · number

Number of entries returned in this page.

totalCount · number

Total number of matching trades.

hasMore · boolean

Whether more trades are available.

nextCursor · string | null

Cursor for the next page. Null when no more results. Use this value as the cursor query parameter to fetch the next page.

hostname · string

Server hostname that handled the request.

took · number

Request processing time in milliseconds.

Usage Examples

Offset-based pagination

curl -X GET "https://api.mobula.io/api/2/pm/market/trades?platform=polymarket&marketId=0x1234...&limit=20&minAmountUSD=100"

Cursor-based pagination

# First page
curl -X GET "https://api.mobula.io/api/2/pm/market/trades?platform=polymarket&marketId=0x1234...&limit=50"

# Next page (use nextCursor from previous response)
curl -X GET "https://api.mobula.io/api/2/pm/market/trades?platform=polymarket&marketId=0x1234...&limit=50&cursor=1709913600000:trade-001"

With ISO date range

curl -X GET "https://api.mobula.io/api/2/pm/market/trades?platform=polymarket&marketId=0x1234...&from=2024-03-01T00:00:00Z&to=2024-03-08T00:00:00Z&sortOrder=asc"

Example Response

{
  "data": [
    {
      "id": "trade-001",
      "marketId": "0x1234...",
      "outcomeId": "71321...",
      "platform": "polymarket",
      "type": "buy",
      "priceUSD": 0.35,
      "sizeToken": 1000,
      "amountUSD": 350,
      "date": 1709913600000,
      "swapRecipient": "0xabc...",
      "transactionHash": "0xdef..."
    }
  ],
  "pagination": {
    "page": 1,
    "offset": 0,
    "limit": 50,
    "pageEntries": 1,
    "totalCount": 1,
    "hasMore": false,
    "nextCursor": null
  },
  "hostname": "node-xyz",
  "took": 42
}

Query Parameters

platform · string · required

marketId · string · required

outcomeId · string

from · number string

Start time (Unix ms timestamp or ISO 8601 string)

to · number string

End time (Unix ms timestamp or ISO 8601 string)

minAmountUSD · number · default: 0

limit · number · default: 50

Required range: 1 <= x <= 500

offset · number · default: 0

Pagination offset. Ignored when cursor is provided.

Required range: x >= 0

cursor · string

Cursor for keyset pagination. Use nextCursor from previous response.

sortOrder · enum<string> · default: desc

Sort direction for trades by date.

Available options: asc, desc

Response

200 - application/json

Trade history

data · object[]

Show child attributes

pagination · object

Show child attributes

hostname · string

took · number