majjha.API Docs
Launch app

Events

An event is a single real-world question that resolves at a point in time (the `strikeDate`). An event groups one or more markets — when `mutuallyExclusive` is true, exactly one of its markets resolves YES.

List events

Public
GET/api/events

Returns a cursor-paginated list of events. Filter by series or status, and optionally inline each event's markets.

Query parameters

  • series_tickerstringqueryoptional

    Only return events belonging to this series.

  • statusstringqueryoptional

    Filter by event status.

    ACTIVECLOSEDRESOLVED
  • with_nested_marketsbooleanqueryoptionaldefault: false

    When true, include a `markets` array on each event.

  • limitintegerqueryoptionaldefault: 20

    Page size. Max 100.

  • cursorstringqueryoptional

    Opaque cursor from the previous page.

Request

cURL
curl "https://api.majjha.com/api/events"

Response

200 OK
{
  "cursor": null,
  "events": [
    {
      "id": "evt_btc5m_1717459200",
      "eventTicker": "BTC-5MIN-25JUN04T0900",
      "seriesTicker": "BTC-5MIN",
      "title": "BTC above $68,500 at 09:05?",
      "mutuallyExclusive": true,
      "strikeDate": "2026-06-04T09:05:00Z",
      "description": "Resolves YES if BTC/USD is at or above the strike at 09:05 UTC.",
      "status": "ACTIVE",
      "createdAt": "2026-06-04T09:00:00Z",
      "updatedAt": "2026-06-04T09:00:00Z"
    }
  ]
}

Get event

Public
GET/api/events/{event_ticker}

Returns a single event by ticker. Optionally inline its markets.

Path parameters

  • event_tickerstringpathrequired

    The event ticker.

Query parameters

  • with_nested_marketsbooleanqueryoptionaldefault: false

    When true, include a `markets` array alongside the event.

Request

cURL
curl "https://api.majjha.com/api/events/{event_ticker}"

Response

200 OK
{
  "event": {
    "id": "evt_btc5m_1717459200",
    "eventTicker": "BTC-5MIN-25JUN04T0900",
    "seriesTicker": "BTC-5MIN",
    "title": "BTC above $68,500 at 09:05?",
    "mutuallyExclusive": true,
    "strikeDate": "2026-06-04T09:05:00Z",
    "description": "Resolves YES if BTC/USD is at or above the strike at 09:05 UTC.",
    "status": "ACTIVE",
    "createdAt": "2026-06-04T09:00:00Z",
    "updatedAt": "2026-06-04T09:00:00Z"
  },
  "markets": [
    {
      "id": "mkt_btc5m_a1",
      "ticker": "BTC-5MIN-25JUN04T0900-Y",
      "eventTicker": "BTC-5MIN-25JUN04T0900",
      "title": "BTC above $68,500 at 09:05?",
      "status": "ACTIVE",
      "lastYesPrice": "0.54",
      "lastNoPrice": "0.46",
      "volume": "12840.00",
      "liquidity": "3200.00"
    }
  ]
}
PreviousSeriesNext Markets