Discover HIP-4 events, categories, and typed markets

const events = await adapter.events.fetchEvents({ active: true, limit: 20 });

import { createHIP4Adapter } from "@outcome.xyz/hip4";

const adapter = createHIP4Adapter({ testnet: false });
await adapter.initialize();

// List active recurring markets, first page
const events = await adapter.events.fetchEvents({
  category: "recurring",
  active: true,
  limit: 10,
  offset: 0,
});

for (const event of events) {
  console.log(event.id, event.title, event.status);
  // e.g. "o1338", "BTC > $69070 (1d)", "active"

  for (const market of event.markets) {
    for (const outcome of market.outcomes) {
      console.log(outcome.name, outcome.tokenId, outcome.price);
      // e.g. "Yes", "#13380", "0.62"
    }
  }
}

const event = await adapter.events.fetchEvent("q5");

// Fetch a question-based event
const questionEvent = await adapter.events.fetchEvent("q5");
console.log(questionEvent.title); // e.g. "Who will win the race?"
console.log(questionEvent.markets.length); // number of competing outcomes

// Fetch a standalone recurring outcome event
const recurringEvent = await adapter.events.fetchEvent("o1338");
console.log(recurringEvent.category); // "recurring"
console.log(recurringEvent.endDate); // "20260311-0300"

const categories = await adapter.events.fetchCategories();

const categories = await adapter.events.fetchCategories();
// [
//   { id: "custom", name: "Custom", slug: "custom" },
//   { id: "recurring", name: "Recurring", slug: "recurring" }
// ]

import { createHIP4Adapter } from "@outcome.xyz/hip4";

const adapter = createHIP4Adapter({ testnet: false });
await adapter.initialize();

const markets = await adapter.events.fetchMarkets();

import type {
  DefaultBinaryMarket,
  LabelledBinaryMarket,
  MultiOutcomeMarket,
  PriceBucketMarket,
} from "@outcome.xyz/hip4";

// --- Flat list of all markets ---
const all = await adapter.events.fetchMarkets();

// --- defaultBinary: recurring price binary (Yes/No sides) ---
const recurring = await adapter.events.fetchMarkets({ type: "defaultBinary" });
const m = recurring[0] as DefaultBinaryMarket;

console.log(m.underlying); // "BTC"
console.log(m.targetPrice); // 69070
console.log(m.expiry); // Date object (UTC)
console.log(m.period); // "1d"
console.log(m.sides[0].coin); // "#17580"  - coin string for side 0
console.log(m.sides[0].asset); // 100017580 - asset ID for order placement
console.log(m.sides[1].name); // "No"
console.log(m.raw); // original HLOutcome

// --- labelledBinary: standalone with custom side labels ---
const labelled = await adapter.events.fetchMarkets({ type: "labelledBinary" });
const lb = labelled[0] as LabelledBinaryMarket;
console.log(lb.sides[0].name); // e.g. "Hypurr"
console.log(lb.sides[1].name); // e.g. "Usain Bolt"

// --- multiOutcome: one of several outcomes under a parent question ---
const multi = await adapter.events.fetchMarkets({ type: "multiOutcome" });
const mo = multi[0] as MultiOutcomeMarket;
console.log(mo.questionId); // 5
console.log(mo.questionName); // "Who wins?"
console.log(mo.isFallback); // false

// --- priceBucket: multi-bucket price range markets ---
const buckets = await adapter.events.fetchMarkets({ type: "priceBucket" });
const pb = buckets[0] as PriceBucketMarket;
console.log(pb.underlying); // "BTC"
console.log(pb.priceThresholds); // [81015.3, 81258.7]
console.log(pb.lowerBound); // null (unbounded) or a price number
console.log(pb.upperBound); // null (unbounded) or a price number
console.log(pb.bucketIndex); // 0, 1, 2 … or -1 for the fallback

// --- Group all markets by type ---
const byType = await adapter.events.fetchMarkets({ groupBy: "type" });
console.log(byType.defaultBinary?.length); // recurring market count
console.log(byType.labelledBinary?.length); // labelled binary count

// --- Group multi-outcome markets by parent question ---
const byQuestion = await adapter.events.fetchMarkets({
  type: "multiOutcome",
  groupBy: "question",
});
// byQuestion["5"] → all MultiOutcomeMarket objects under question 5

// --- Pagination ---
const page2 = await adapter.events.fetchMarkets({ limit: 10, offset: 10 });