Get Prediction Categories

Get all prediction market categories with market counts and volume stats.

GET /2/pm/categories

Get Prediction Categories

cURL

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

200

{
  "data": [
    {}
  ]
}

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

Query Parameters

limit · number · default: "50"

Number of categories to return.

offset · number · default: "0"

Pagination offset.

Response

data · array

Array of category objects.

Show Category

id · string

Category identifier.

name · string

Category display name.

marketsCount · number

Total number of markets in this category.

activeMarketsCount · number

Number of currently active markets.

volume24hUSD · number

24h volume across all markets in this category.

totalVolumeUSD · number

All-time volume across all markets in USD.

pagination · object

Pagination metadata.

Show Pagination

page · number

Current page number (1-indexed).

offset · number

Current offset.

limit · number

Requested page size.

pageEntries · number

Number of entries in current page.

hostname · string

Server node identifier.

took · number

Request processing time in milliseconds.

Usage Example

curl -X GET "https://api.mobula.io/api/2/pm/categories"

Example Response

{
  "data": [
    { "id": "politics", "name": "Politics", "marketsCount": 450, "activeMarketsCount": 120, "volume24hUSD": 5200000, "totalVolumeUSD": 890000000 },
    { "id": "crypto", "name": "Crypto", "marketsCount": 320, "activeMarketsCount": 85, "volume24hUSD": 3100000, "totalVolumeUSD": 450000000 },
    { "id": "sports", "name": "Sports", "marketsCount": 180, "activeMarketsCount": 60, "volume24hUSD": 1800000, "totalVolumeUSD": 220000000 }
  ],
  "pagination": {
    "page": 1,
    "offset": 0,
    "limit": 50,
    "pageEntries": 3
  },
  "hostname": "node-xyz",
  "took": 42
}

Query Parameters

limit · integer · default: 50

Page size (1-100).

Required range: 1 <= x <= 100

offset · integer · default: 0

Pagination offset.

Required range: x >= 0

Response

200 - application/json

Categories list

data · object[]