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.com/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"
    }
  ]
}

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.com/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"
  }
}