majjha.developers
Open beta

Public beta: activity uses test Dots with no monetary value. There is no money in or out, and interfaces may change before launch.

Comments

First-class public comment reads for market discussion. Posting/reporting is abuse-limited, moderation-aware, and mirrored as a market subresource for detail pages; this group follows the broader comments API shape used by Polymarket-style integrations.

Get comment

Public
GET/api/comments/{id}

Returns one visible public comment by id.

Path parameters

  • idstringpathrequired

    Comment id.

Request

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

Response

200 OK
{
  "comment": {
    "id": "cmt_a1",
    "market_id": "mkt_btc5m_a1",
    "market_ticker": "BTC-5MIN-25JUN04T0900-Y",
    "market_title": "BTC above $68,500 at 09:05?",
    "user_id": "usr_42",
    "user_name": "Ari",
    "username": "ari",
    "body": "Order book is leaning YES after that candle.",
    "created_at": "2026-06-04T09:03:30Z",
    "updated_at": "2026-06-04T09:03:30Z"
  }
}

Appeal hidden comment

Requires auth
POST/api/comments/{id}/appeal

Creates or updates the authenticated user's open appeal for one of their own hidden comments.

Path parameters

  • idstringpathrequired

    Hidden comment id owned by the authenticated user.

Body parameters

  • reasonstringbodyrequired

    Appeal reason. Max 1000 characters.

Request

cURL
curl -X POST "https://api.majjha.fun/api/comments/{id}/appeal" \
  -H "Authorization: Bearer $MAJJ_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "reason": "This comment was about market liquidity and did not include harassment."
  }'
Request body
{
  "reason": "This comment was about market liquidity and did not include harassment."
}

Response

200 OK
{
  "appeal": {
    "id": "cmta_123",
    "comment_id": "cmt_a1",
    "market_id": "mkt_btc5m_a1",
    "market_ticker": "BTC-5MIN-25JUN04T0900-Y",
    "market_title": "BTC above $68,500 at 09:05?",
    "user_id": "usr_42",
    "user_name": "Ari",
    "username": "ari",
    "body": "Order book is leaning YES after that candle.",
    "reason": "This comment was about market liquidity and did not include harassment.",
    "status": "OPEN",
    "reviewer_email": null,
    "review_reason": null,
    "created_at": "2026-06-04T09:08:30Z",
    "updated_at": "2026-06-04T09:08:30Z",
    "reviewed_at": null
  }
}
  • Hidden comments are not returned by public comment feeds; this endpoint only accepts comment ids owned by the authenticated user.
  • Only one open appeal per user/comment is allowed; resubmitting updates the open appeal reason.

List my comment appeals

Requires auth
GET/api/comments/me/appeals

Returns the authenticated user's comment appeals, newest first.

Query parameters

  • limitintegerqueryoptionaldefault: 30

    Page size. Max 100.

Request

cURL
curl "https://api.majjha.fun/api/comments/me/appeals" \
  -H "Authorization: Bearer $MAJJ_TOKEN"

Response

200 OK
{
  "appeals": [
    {
      "id": "cmta_123",
      "comment_id": "cmt_a1",
      "market_id": "mkt_btc5m_a1",
      "market_ticker": "BTC-5MIN-25JUN04T0900-Y",
      "market_title": "BTC above $68,500 at 09:05?",
      "reason": "This comment was about market liquidity and did not include harassment.",
      "status": "OPEN",
      "created_at": "2026-06-04T09:08:30Z",
      "reviewed_at": null
    }
  ]
}