Working with events & markets

"markets": [
  {                                    // ← a GROUP: has "outcomes"
    "marketDisplayName": "Moneyline 3-Way",
    "outcomes": [
      { "id": 32872605, "title": "New Jersey Devils",  /* ... */ },
      { "id": 32872606, "title": "Draw",               /* ... */ },
      { "id": 32872607, "title": "New York Islanders", /* ... */ }
    ]
  },
  {                                    // ← a BARE MARKET: no "outcomes"
    "id": 60497,
    "title": "M6.0+ in California",
    "marketDisplayName": null,
    /* ... */
  }
]

event.markets.map((entry) =>
  entry.outcomes
    ? <BettingLine title={entry.marketDisplayName} markets={entry.outcomes} />
    : <SingleMarket market={entry} />
)

const allMarkets = event.markets.flatMap((m) => m.outcomes ?? [m]);

{ "title": "Bitcoin price today at 5:00 PM EDT?" }

GET /api/events HTTP/1.1
user-timezone: Europe/London

{ "title": "Bitcoin price today at 10:00 PM GMT+1?" }

{
  "metaData": {
    "underlying": "If the last traded price of BTC on $BINANCE$ is between $685 and $689.99, then the market resolves to Yes.",
  }
}

"links": {
  "BINANCE": { "url": "https://www.binance.com/en/markets", "label": "Binance Spot Market" }
}

function renderRuleText(text, links = {}) {
  return text.replace(/\$([A-Z][A-Z0-9_]*)\$/g, (whole, token) => {
    const link = links[token];
    if (!link) return token;                    // fall back to the bare name
    return `<a href="${link.url}">${link.label}</a>`;
  });
}

"rulebook_variables": { "asset": "BNB", "source": "Binance", "rangeLow": "685", "rangeHigh": "689.99" }

"category":    { "id": 36, "name": "Commodities" },
"subcategory": {
  "id": 82, "name": "Gold",
  "parent": { "id": 81, "name": "Metals", "parentId": null }
}

function breadcrumb(event) {
  const chain = [];
  let node = event.subcategory;
  while (node) { chain.unshift(node.name); node = node.parent; }
  return [event.category?.name, ...chain].filter(Boolean).join(' › ');
}

"subcategories": [
  { "cadence": "5min",  "count": 6,  "isVirtual": true },   // ← not a subcategory
  { "cadence": "1hr",   "count": 12, "isVirtual": true },
  { "id": 67, "name": "Bitcoin", "activeEventsCount": 15,
    "cadenceSubcategories": [ { "cadence": "5min", "count": 1, "isVirtual": true } ] }
]

curl 'http://localhost:8083/api/subcategories'

{ "data": { "subcategories": [
  { "id": 67, "name": "Bitcoin",  "categoryId": 34, "parentId": null },
  { "id": 68, "name": "Ethereum", "categoryId": 34, "parentId": null }
] } }

# Every round of the BTC 15-minute series, any status
curl 'http://localhost:8083/api/events?subcategoryId=67&cadence=15min&limit=3'

// Current round (exactly one)
const [current] = (await api('/events', {
  subcategoryId: 67, cadence: '15min', status: 'open', limit: '1',
})).data.events;

// Upcoming rounds, chronological
const upcoming = (await api('/events', {
  subcategoryId: 67, cadence: '15min', isFuture: true,
  sortBy: 'openAt', sortOrder: 'asc', limit: '100',
})).data.events;

// Past rounds: same key, isFuture defaults to false, no status filter
const past = (await api('/events', {
  subcategoryId: 67, cadence: '15min', limit: '30',
})).data.events;

// Order matters: event metaData first, market metaData only as a fallback.
const raw = event?.metaData?.cadence ?? market?.metaData?.cadence;

const SUFFIXES = ['15min', '5min', '1hr', 'daily', 'weekly', 'monthly', 'yearly'];
const fromTemplate = SUFFIXES.find((s) => templateId?.toLowerCase().endsWith(`_${s}`));

GET /events?status=open,pending,live,halted&isFuture=all&page=1&limit=200

function renderEvent(event) {
  const links = event.metaData?.links ?? {};

  return {
    title: renderTokens(event.title, event),                // §3a
    subtitle: renderTokens(event.subtitle, event),          // §3a — don't skip this
    rules: event.rulesSummary
      ? renderRuleText(event.rulesSummary, links)           // §3b
      : null,
    // NB: every contractSpec section is a string EXCEPT `insiderTrading`,
    // which is { title, items[] }. Special-case it or you print [object Object].
    contract: Object.entries(event.metaData?.contractSpec ?? {}).map(([section, val]) =>
      typeof val === 'string'
        ? { section, text: renderRuleText(val, links) }
        : { section, title: val.title, items: val.items.map((t) => renderRuleText(t, links)) },
    ),
    lines: event.markets.map((entry) =>
      entry.outcomes                                        // §2
        ? { name: entry.marketDisplayName, markets: entry.outcomes }
        : { name: entry.title, markets: [entry] },
    ),
  };
}