Get Trending Prediction Markets

Get the most trending prediction markets ranked by volume change and activity.

GET /2/pm/trending

Get Trending Prediction Markets

cURL

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

200

{
  "data": [
    {}
  ]
}

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

Query Parameters

period · string · default: "24h"

Trending period. Possible values: 1h, 24h, 7d, 30d.

filters · string

JSON object with optional filter fields: platforms (comma-separated or array of platform names), categories (comma-separated or array of category names). Example: {"platforms":"polymarket","categories":"crypto"}.

limit · number · default: "20"

Number of markets to return (1 to 100).

offset · number · default: "0"

Pagination offset.

Response

data · array

Array of trending market results (extends search results with trending data).

Show Trending Market

platform · string

Platform name.

marketId · string

Market identifier.

slug · string

URL-friendly slug.

question · string

Market question.

category · string

Market category.

status · string

Market status.

volume24hUSD · number | null

24h trading volume in USD.

totalVolumeUSD · number | null

All-time trading volume in USD.

liquidityUSD · number | null

Current liquidity in USD.

endDate · string | null

Market end date (ISO 8601).

createdAt · string

Market creation timestamp.

logo · string

Market logo URL.

tradesCount · number

Total number of trades.

trendingScore · number | null

Computed trending score.

volumeChange24hPercentage · number | null

Volume change percentage over 24h.

rank · number | null

Trending rank.

eventId · string | null

Parent event identifier, if this market belongs to a grouped event (e.g., “Peru Presidential Election Winner”). null for standalone markets. Use with /api/2/pm/event/details to fetch the full event.

eventSlug · string | null

Parent event URL-friendly slug. null for standalone markets.

eventTitle · string | null

Parent event title. null for standalone markets.

outcomes · array

Array of outcome summaries.

Show Outcome Summary

outcomeId · string

Outcome token ID.

label · string

Outcome label.

priceUSD · number

Current price (0 to 1).

pagination · object

Pagination metadata.

Show Pagination

page · number

Current page number (1-based).

offset · number

Current offset.

limit · number

Page size limit.

pageEntries · number

Number of entries in the current page.

hostname · string

Server hostname that handled the request.

took · number

Time taken in milliseconds.

Usage Example

curl -X GET "https://api.mobula.io/api/2/pm/trending?period=24h&limit=10"

Example Response

{
  "data": [
    {
      "platform": "polymarket",
      "marketId": "0x1234...",
      "slug": "will-eth-reach-10k-2026",
      "question": "Will ETH reach $10,000 by end of 2026?",
      "category": "crypto",
      "status": "active",
      "volume24hUSD": 45000,
      "totalVolumeUSD": 1250000,
      "liquidityUSD": 320000,
      "endDate": "2026-12-31T23:59:59.000Z",
      "createdAt": "2026-01-15T00:00:00.000Z",
      "logo": "https://polymarket.com/images/market.png",
      "tradesCount": 8500,
      "trendingScore": 92.5,
      "volumeChange24hPercentage": 156.3,
      "rank": 1,
      "outcomes": [
        { "outcomeId": "71321...", "label": "Yes", "priceUSD": 0.35 },
        { "outcomeId": "71322...", "label": "No", "priceUSD": 0.65 }
      ]
    }
  ],
  "pagination": {
    "page": 1,
    "offset": 0,
    "limit": 20,
    "pageEntries": 1
  },
  "hostname": "node-xyz",
  "took": 42
}

Query Parameters

period · enum<string> · default: 24h

Trending window.

Available options: 1h, 24h, 7d, 30d

filters · string

JSON-encoded filter object with optional platforms and categories string arrays.

Example:

"{\"categories\":[\"Politics\"]}"

limit · integer · default: 20

Page size (1-100).

Required range: 1 <= x <= 100

offset · integer · default: 0

Pagination offset.

Required range: x >= 0

Response

200 - application/json

Trending markets list

data · object[]