Tags

Market tags power topic pages, related-topic discovery, and tag-filtered market lists. Tags are normalized to stable slugs, while display names keep human-friendly casing.

List tags

Public

GET/api/tags

Returns popular tags with market counts.

Query parameters

limitintegerqueryoptionaldefault: 50
Maximum tags to return. Max 100.
offsetintegerqueryoptionaldefault: 0
Offset into the filtered tag list.
orderstringqueryoptionaldefault: activeEventsCount
Sort field. Supports `id`, `slug`, `label`, `createdAt`, `updatedAt`, and `activeEventsCount` aliases.
ascendingbooleanqueryoptionaldefault: false
Sort ascending instead of descending.
include_templatebooleanqueryoptional
Accepted for current Gamma SDK compatibility. Alias: `includeTemplate`.
is_carouselbooleanqueryoptional
Carousel filter. PredictMax tags are not carousel tags, so `true` returns an empty list. Alias: `isCarousel`.

Request

cURL

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

Response

200 OK

{
  "tags": [
    {
      "id": "tag_btc",
      "slug": "bitcoin",
      "name": "Bitcoin",
      "market_count": 24,
      "created_at": "2026-06-04T09:00:00Z",
      "updated_at": "2026-06-04T09:00:00Z"
    }
  ]
}

List tags (Gamma shape)

Public

GET/tags

Current Gamma-compatible tag list alias. Returns a bare array with `id`, `slug`, `label`, moderation/display flags, timestamps, and `activeEventsCount`.

Query parameters

limitintegerqueryoptionaldefault: 50
Maximum tags to return. Max 100.

Request

cURL

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

Response

200 OK

[
  {
    "id": "tag_btc",
    "slug": "bitcoin",
    "label": "Bitcoin",
    "forceShow": false,
    "publishedAt": "2026-06-04T09:00:00Z",
    "createdBy": 0,
    "updatedBy": 0,
    "createdAt": "2026-06-04T09:00:00Z",
    "updatedAt": "2026-06-04T09:00:00Z",
    "forceHide": false,
    "isCarousel": false,
    "activeEventsCount": 24
  }
]

→Detail aliases: `/tags/{id}` and `/tags/slug/{slug}`.
→Related aliases: `/tags/{id}/related-tags`, `/tags/slug/{slug}/related-tags`, and their `/tags` resource variants.

Get tag by id (Gamma shape)

Public

GET/tags/{id}

Returns a single tag as a bare Gamma-compatible tag object.

Path parameters

idstringpathrequired
Tag id or slug.

Request

cURL

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

Response

200 OK

{
  "id": "tag_btc",
  "slug": "bitcoin",
  "label": "Bitcoin",
  "forceShow": false,
  "publishedAt": "2026-06-04T09:00:00+00:00",
  "createdBy": 0,
  "updatedBy": 0,
  "createdAt": "2026-06-04T09:00:00+00:00",
  "updatedAt": "2026-06-04T09:00:00+00:00",
  "forceHide": false,
  "isCarousel": false,
  "activeEventsCount": 24
}

Get tag by slug (Gamma shape)

Public

GET/tags/slug/{slug}

Returns a single tag as a bare Gamma-compatible tag object.

Path parameters

slugstringpathrequired
Tag slug, e.g. `bitcoin`.

Request

cURL

curl "https://api.majjha.fun/tags/slug/{slug}"

Response

200 OK

{
  "id": "tag_btc",
  "slug": "bitcoin",
  "label": "Bitcoin",
  "forceShow": false,
  "publishedAt": "2026-06-04T09:00:00+00:00",
  "createdBy": 0,
  "updatedBy": 0,
  "createdAt": "2026-06-04T09:00:00+00:00",
  "updatedAt": "2026-06-04T09:00:00+00:00",
  "forceHide": false,
  "isCarousel": false,
  "activeEventsCount": 24
}

List related tags by id (Gamma shape)

Public

GET/tags/{id}/related-tags

Returns bare related-tag relationship rows for the given tag. Use the `/tags` resource variant when a client needs full tag objects.

Path parameters

idstringpathrequired
Tag id or slug.

Query parameters

limitintegerqueryoptionaldefault: 12
Maximum related tags. Max 50.
omit_emptybooleanqueryoptional
When true, omit locally empty related tags. Alias: `omitEmpty`.
statusstringqueryoptional
Official Gamma related-tag status filter. PredictMax returns an empty list for `closed` because closed-only related-tag state is not tracked locally.
activeclosedall

Request

cURL

curl "https://api.majjha.fun/tags/{id}/related-tags"

Response

200 OK

[
  {
    "id": "tag_btc:tag_crypto",
    "rank": 1
  }
]

List related tags by slug (Gamma shape)

Public

GET/tags/slug/{slug}/related-tags

Returns bare related-tag relationship rows for the given tag slug. Use the `/tags` resource variant when a client needs full tag objects.

Path parameters

slugstringpathrequired
Tag slug.

Query parameters

limitintegerqueryoptionaldefault: 12
Maximum related tags. Max 50.
omit_emptybooleanqueryoptional
When true, omit locally empty related tags. Alias: `omitEmpty`.
statusstringqueryoptional
Official Gamma related-tag status filter. PredictMax returns an empty list for `closed` because closed-only related-tag state is not tracked locally.
activeclosedall

Request

cURL

curl "https://api.majjha.fun/tags/slug/{slug}/related-tags"

Response

200 OK

[
  {
    "id": "tag_btc:tag_crypto",
    "rank": 1
  }
]

List related tag resources by id (Gamma shape)

Public

GET/tags/{id}/related-tags/tags

Returns full Gamma-compatible tag objects for tags related to the given tag.

Path parameters

idstringpathrequired
Tag id or slug.

Query parameters

limitintegerqueryoptionaldefault: 12
Maximum related tags. Max 50.
omit_emptybooleanqueryoptional
When true, omit locally empty related tags. Alias: `omitEmpty`.
statusstringqueryoptional
Official Gamma related-tag status filter. PredictMax returns an empty list for `closed` because closed-only related-tag state is not tracked locally.
activeclosedall

Request

cURL

curl "https://api.majjha.fun/tags/{id}/related-tags/tags"

Response

200 OK

[
  {
    "id": "tag_crypto",
    "slug": "crypto",
    "label": "Crypto",
    "forceShow": false,
    "publishedAt": "2026-06-04T09:00:00+00:00",
    "createdBy": 0,
    "updatedBy": 0,
    "createdAt": "2026-06-04T09:00:00+00:00",
    "updatedAt": "2026-06-04T09:00:00+00:00",
    "forceHide": false,
    "isCarousel": false,
    "activeEventsCount": 18
  }
]

List related tag resources by slug (Gamma shape)

Public

GET/tags/slug/{slug}/related-tags/tags

Returns full Gamma-compatible tag objects for tags related to the given tag slug.

Path parameters

slugstringpathrequired
Tag slug.

Query parameters

limitintegerqueryoptionaldefault: 12
Maximum related tags. Max 50.
omit_emptybooleanqueryoptional
When true, omit locally empty related tags. Alias: `omitEmpty`.
statusstringqueryoptional
Official Gamma related-tag status filter. PredictMax returns an empty list for `closed` because closed-only related-tag state is not tracked locally.
activeclosedall

Request

cURL

curl "https://api.majjha.fun/tags/slug/{slug}/related-tags/tags"

Response

200 OK

[
  {
    "id": "tag_crypto",
    "slug": "crypto",
    "label": "Crypto",
    "forceShow": false,
    "publishedAt": "2026-06-04T09:00:00+00:00",
    "createdBy": 0,
    "updatedBy": 0,
    "createdAt": "2026-06-04T09:00:00+00:00",
    "updatedAt": "2026-06-04T09:00:00+00:00",
    "forceHide": false,
    "isCarousel": false,
    "activeEventsCount": 18
  }
]

Get tag

Public

GET/api/tags/{slug}

Returns a tag plus related tags that co-occur on the same markets.

Path parameters

slugstringpathrequired
Tag slug, e.g. `bitcoin`.

Request

cURL

curl "https://api.majjha.fun/api/tags/{slug}"

Response

200 OK

{
  "tag": {
    "id": "tag_btc",
    "slug": "bitcoin",
    "name": "Bitcoin",
    "market_count": 24,
    "created_at": "2026-06-04T09:00:00Z",
    "updated_at": "2026-06-04T09:00:00Z"
  },
  "related": [
    { "id": "tag_crypto", "slug": "crypto", "name": "Crypto", "market_count": 18 }
  ]
}

List related tags

Public

GET/api/tags/{slug}/related

Returns tags that share markets with the given tag.

Path parameters

slugstringpathrequired
Tag slug.

Query parameters

limitintegerqueryoptionaldefault: 12
Maximum related tags. Max 50.

Request

cURL

curl "https://api.majjha.fun/api/tags/{slug}/related"

Response

200 OK

{
  "tags": [
    { "id": "tag_crypto", "slug": "crypto", "name": "Crypto", "market_count": 18 }
  ]
}

PreviousSearch Next Series