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.parsedTitle ?? 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.parsedName ?? 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.parsedTitle); // 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";
import type { HIP4Market } from "@outcome.xyz/hip4";

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

const markets = (await adapter.events.fetchMarkets()) as HIP4Market[];

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

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

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

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",
})) as LabelledBinaryMarket[];
const lb = labelled[0];
console.log(lb.sides[0].parsedName); // e.g. "Hypurr"
console.log(lb.sides[1].parsedName); // e.g. "Usain Bolt"

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

// --- priceBucket: multi-bucket price range markets ---
const buckets = (await adapter.events.fetchMarkets({
  type: "priceBucket",
})) as PriceBucketMarket[];
const pb = buckets[0];
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",
})) as MarketsByType;
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",
})) as MarketsByQuestion;
// byQuestion["5"] holds all MultiOutcomeMarket objects under question 5

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