Series

A series is a recurring family of events that share a template — for example `BTC 5-minute close`. Each series groups many events over time. Series are the top of the market hierarchy: Series → Events → Markets.

List series

Public

GET/api/series

Returns a cursor-paginated list of series, optionally filtered by category.

Query parameters

categorystringqueryoptional
Filter by category slug (e.g. `crypto`).
limitintegerqueryoptionaldefault: 20
Page size. Max 100.
cursorstringqueryoptional
Opaque cursor from the previous page's `cursor` field.

Request

cURL

curl "https://api.majjha.fun/api/series"

Response

200 OK

{
  "cursor": "eyJpZCI6ICJzZXJfMDQyIn0",
  "series": [
    {
      "id": "ser_btc5m",
      "ticker": "BTC-5MIN",
      "title": "Bitcoin 5-minute close",
      "categoryId": "cat_crypto",
      "category_name": "Crypto",
      "category_slug": "crypto",
      "frequency": "5m",
      "tags": ["bitcoin", "crypto", "high-frequency"],
      "description": "Will BTC close above the strike at the end of each 5-minute window?",
      "event_count": 288,
      "createdAt": "2026-06-01T00:00:00Z",
      "updatedAt": "2026-06-04T09:00:00Z"
    }
  ]
}

List series (Gamma shape)

Public

GET/series

Returns series as a bare array using the current Gamma SDK response shape. Native PredictMax cursor envelopes remain under `/api/series`.

Query parameters

limitintegerqueryoptionaldefault: 20
Page size. Max 100.
offsetintegerqueryoptionaldefault: 0
Rows to skip.
recurrencestringqueryoptional
Optional frequency filter, e.g. `daily`, `weekly`, or `monthly`.
slugstringqueryoptional
Optional repeated or comma-separated series ticker/id filter.
categories_idsstring[]queryoptional
Optional repeated or comma-separated category ids/slugs. Alias: `categoriesIds`.
categories_labelsstring[]queryoptional
Optional repeated or comma-separated category labels/slugs. Alias: `categoriesLabels`.
closedbooleanqueryoptionaldefault: false
When true, returns no rows because PredictMax has no closed Gamma series rows yet.
include_chatbooleanqueryoptional
Accepted for Gamma compatibility; chat payloads are not embedded in series rows.
exclude_eventsbooleanqueryoptional
Accepted for Gamma compatibility; series rows do not embed events.
orderstringqueryoptionaldefault: createdAt
Sort key. Accepts `id`, `ticker`, `slug`, `title`, `recurrence`, `seriesType`, `updatedAt`, `event_count`, or `createdAt`.
ascendingbooleanqueryoptionaldefault: false
Sort ascending instead of descending.

Request

cURL

curl "https://api.majjha.fun/series"

Response

200 OK

[
  {
    "id": "ser_btc5m",
    "ticker": "BTC-5MIN",
    "slug": "BTC-5MIN",
    "title": "Bitcoin 5-minute close",
    "seriesType": "5m",
    "recurrence": "5m",
    "description": "Will BTC close above the strike at the end of each 5-minute window?",
    "active": true,
    "closed": false,
    "createdAt": "2026-06-01T00:00:00+00:00",
    "updatedAt": "2026-06-04T09:00:00+00:00",
    "tags": [
      { "id": "bitcoin", "slug": "bitcoin", "label": "bitcoin" }
    ]
  }
]

→Compatibility aliases: `/api/gamma/series` and `/series/{id}`.

Get series (Gamma shape)

Public

GET/series/{id}

Returns one series by id or ticker as a bare Gamma-compatible series object.

Path parameters

idstringpathrequired
Series id or ticker.

Request

cURL

curl "https://api.majjha.fun/series/{id}"

Response

200 OK

{
  "id": "ser_btc5m",
  "ticker": "BTC-5MIN",
  "slug": "BTC-5MIN",
  "title": "Bitcoin 5-minute close",
  "seriesType": "5m",
  "recurrence": "5m",
  "description": "Will BTC close above the strike at the end of each 5-minute window?",
  "active": true,
  "closed": false,
  "archived": false,
  "createdAt": "2026-06-01T00:00:00+00:00",
  "updatedAt": "2026-06-04T09:00:00+00:00",
  "commentsEnabled": true,
  "volume": "0",
  "liquidity": "0",
  "tags": [
    { "id": "bitcoin", "slug": "bitcoin", "label": "bitcoin" }
  ]
}

Get series comment count (Gamma shape)

Public

GET/series/{id}/comments/count

Returns the count of visible market comments across events in the series using the current Gamma-compatible `{ count }` envelope.

Path parameters

idstringpathrequired
Series id or ticker.

Request

cURL

curl "https://api.majjha.fun/series/{id}/comments/count"

Response

200 OK

{
  "count": 128
}

→Compatibility alias: `/api/gamma/series/{id}/comments/count`.

Get series summary (Gamma shape)

Public

GET/series-summary/{id}

Returns a compact Gamma-compatible summary for a series, including event dates and ISO event weeks.

Path parameters

idstringpathrequired
Series id or ticker.

Request

cURL

curl "https://api.majjha.fun/series-summary/{id}"

Response

200 OK

{
  "id": "ser_btc5m",
  "title": "Bitcoin 5-minute close",
  "slug": "BTC-5MIN",
  "eventDates": ["2026-06-04", "2026-06-05"],
  "eventWeeks": [23],
  "earliest_open_week": 23,
  "earliest_open_date": "2026-06-04"
}

→Compatibility alias: `/api/gamma/series-summary/{id}`.

Get series summary by slug (Gamma shape)

Public

GET/series-summary/slug/{slug}

Returns the same compact series summary by ticker/slug.

Path parameters

slugstringpathrequired
Series slug or ticker.

Request

cURL

curl "https://api.majjha.fun/series-summary/slug/{slug}"

Response

200 OK

{
  "id": "ser_btc5m",
  "title": "Bitcoin 5-minute close",
  "slug": "BTC-5MIN",
  "eventDates": ["2026-06-04"],
  "eventWeeks": [23],
  "earliest_open_week": 23,
  "earliest_open_date": "2026-06-04"
}

→Compatibility alias: `/api/gamma/series-summary/slug/{slug}`.

Get series

Public

GET/api/series/{series_ticker}

Returns a single series by its ticker, including its category and event count.

Path parameters

series_tickerstringpathrequired
The series ticker, e.g. `BTC-5MIN`.

Request

cURL

curl "https://api.majjha.fun/api/series/{series_ticker}"

Response

200 OK

{
  "series": {
    "id": "ser_btc5m",
    "ticker": "BTC-5MIN",
    "title": "Bitcoin 5-minute close",
    "categoryId": "cat_crypto",
    "category_name": "Crypto",
    "category_slug": "crypto",
    "frequency": "5m",
    "tags": ["bitcoin", "crypto", "high-frequency"],
    "description": "Will BTC close above the strike at the end of each 5-minute window?",
    "event_count": 288,
    "createdAt": "2026-06-01T00:00:00Z",
    "updatedAt": "2026-06-04T09:00:00Z"
  }
}

PreviousTags Next Events