GET /api/operator/markets
GET /api/operator/markets/trending
POST /api/operator/markets/{id}/visibility

type MarketStatus = 'open' | 'halted' | 'in_review' | 'resolved' | 'delisted'
type ResolvedOutcome = 'yes' | 'no'
type MarketGeoTag = 'ID' | 'KR' | 'VN' | 'JP' | 'TH' | 'MY' | 'IN' | 'BR' | 'MX' | 'CO' | 'AU'

interface Pagination {
  page: number
  page_size: number
  total: number
  total_pages: number
}

interface MarketListItem {
  id: number
  slug: string
  title: string
  geo_tag: MarketGeoTag | null
  status: MarketStatus
  yes_label: string | null
  no_label: string | null
  yes_percentage: number
  visibility: 'visible' | 'hidden'
  open_at: string | null
  trading_cutoff_ts: string | null
  resolve_deadline_ts: string | null
  estimated_resolve_ts: string | null
  resolved_outcome: ResolvedOutcome | null
  volume_24h: number
  updated_at: string
}

interface MarketListResponse {
  items: MarketListItem[]
  pagination: Pagination
}

{
  "items": [
    {
      "id": 51,
      "slug": "will-indonesia-qualify-for-the-2026-world-cup",
      "title": "Will Indonesia qualify for the 2026 World Cup?",
      "geo_tag": "ID",
      "status": "open",
      "yes_label": "Qualifies",
      "no_label": "Does not qualify",
      "yes_percentage": 51.29,
      "visibility": "visible",
      "open_at": "2026-07-09T00:00:00.000Z",
      "trading_cutoff_ts": "2026-11-15T12:00:00.000Z",
      "resolve_deadline_ts": "2026-11-16T12:00:00.000Z",
      "estimated_resolve_ts": null,
      "resolved_outcome": null,
      "volume_24h": 123456,
      "updated_at": "2026-07-10T08:30:00.000Z"
    }
  ],
  "pagination": {
    "page": 1,
    "page_size": 50,
    "total": 1,
    "total_pages": 1
  }
}

GET /api/operator/markets/trending

type MarketTranslationLocale = 'en' | 'id' | 'zh-CN' | 'es'

interface CategoryOrTagSummary {
  id: number
  slug: string
  name: string
}

interface MarketTranslation {
  title: string
  description: string
  yesLabel: string | null
  noLabel: string | null
}

type MarketTranslations = Partial<
  Record<MarketTranslationLocale, MarketTranslation>
>

interface TrendingMarketCard {
  rank: number
  id: number
  slug: string
  title: string
  description: string | null
  image_url: string | null
  status: 'open'
  geo_tag: MarketGeoTag | null
  yes_label: string
  no_label: string
  yes_price_bps: number
  no_price_bps: number
  yes_percentage: number
  no_percentage: number
  volume_credits: number
  trending_volume_72h_credits: number
  categories: CategoryOrTagSummary[]
  tags: CategoryOrTagSummary[]
  translations: MarketTranslations
  open_at: string | null
  trading_cutoff_ts: string | null
  estimated_resolve_ts: string | null
  resolve_deadline_ts: string | null
  updated_at: string
  market_path: string
}

interface TrendingMarketsResponse {
  items: TrendingMarketCard[]
  meta: {
    source: 'operator_featured_trending' | 'operator_category_trending'
    amount: number
    category: string | null
    operator_geo_tag: MarketGeoTag | null
    included_geo_tags: Array<MarketGeoTag | null>
    locale: string
    generated_at: string
  }
}

{
  "items": [
    {
      "rank": 1,
      "id": 51,
      "slug": "will-indonesia-qualify-for-the-2026-world-cup",
      "title": "Will Indonesia qualify for the 2026 World Cup?",
      "description": "Resolves YES if Indonesia qualifies for the tournament.",
      "image_url": "https://cdn.example.com/markets/51.webp",
      "status": "open",
      "geo_tag": "ID",
      "yes_label": "Qualifies",
      "no_label": "Does not qualify",
      "yes_price_bps": 5129,
      "no_price_bps": 4871,
      "yes_percentage": 51.29,
      "no_percentage": 48.71,
      "volume_credits": 123456,
      "trending_volume_72h_credits": 45678,
      "categories": [
        { "id": 1, "slug": "sports", "name": "Sports" }
      ],
      "tags": [
        { "id": 10, "slug": "football", "name": "Football" }
      ],
      "translations": {
        "id": {
          "title": "Apakah Indonesia akan lolos ke Piala Dunia 2026?",
          "description": "Diselesaikan YA jika Indonesia lolos ke turnamen.",
          "yesLabel": "Lolos",
          "noLabel": "Tidak lolos"
        }
      },
      "open_at": "2026-07-09T00:00:00.000Z",
      "trading_cutoff_ts": "2026-11-15T12:00:00.000Z",
      "estimated_resolve_ts": null,
      "resolve_deadline_ts": "2026-11-16T12:00:00.000Z",
      "updated_at": "2026-07-10T08:30:00.000Z",
      "market_path": "/markets/will-indonesia-qualify-for-the-2026-world-cup"
    }
  ],
  "meta": {
    "source": "operator_featured_trending",
    "amount": 5,
    "category": null,
    "operator_geo_tag": "ID",
    "included_geo_tags": [null, "ID"],
    "locale": "id",
    "generated_at": "2026-07-10T08:31:00.000Z"
  }
}

{ "visible": false }

interface MarketVisibilityResponse {
  id: number
  visibility: 'visible' | 'hidden'
  market_visibility_mode: 'all' | 'allowlist' | 'blocklist'
}

{
  "id": 51,
  "visibility": "hidden",
  "market_visibility_mode": "blocklist"
}