Live Crypto Markets

1. Market discovery tells you which venue markets exist for an asset and window.
2. Orderbook depth tells you how much liquidity sits behind the displayed Yes/No odds.
3. Reference prices tell you the current underlying asset price used to evaluate the market.

​

Endpoint map

​

What you get

• Deterministic windows grouped by asset, quoteAsset, duration, windowStart, and windowEnd.
• Venue market rows for each window, including outcomes, midpoint-style market odds, metrics, routeability flags, and reference-price metadata.
• Optional per-outcome orderbookDepth with buy/sell levels, notional totals, average and worst sweep prices, and fill-completeness fields.
• Fresh USD reference prices with softRefreshMs, hardMaxAgeMs, ageMs, stale, and target-level error fields so your UI can degrade cleanly.
• Cross-venue comparison fields for reference prices and up/down outcome prices.

​

Cadence filters

import { RECURRENCE_CADENCES, MarketStatus } from "@agg-build/sdk";

console.log(RECURRENCE_CADENCES);
// ["PT5M", "PT10M", "PT15M", "PT30M", "PT1H", "PT4H", "P1D", "P1W", "P1M", "P1Y"]

const { data: events } = await client.getVenueEvents({
  status: [MarketStatus.open],
  recurrence: ["PT5M", "PT15M", "PT30M", "PT1H", "PT4H"],
  limit: 50,
});

​

1. Create the client

import { createAggClient } from "@agg-build/sdk";

const client = createAggClient({
  baseUrl: "https://api.agg.market",
  appId: "your-app-id",
});

​

2. List recurring crypto windows

const windows = await client.listRecurringCryptoMarkets({
  assets: ["BTC", "ETH"],
  durations: ["PT15M", "PT30M", "PT1H"],
  window: "current",
  status: [MarketStatus.open],
});

curl -G "https://api.agg.market/crypto/recurring-markets" \
  -H "x-app-id: YOUR_APP_ID" \
  --data-urlencode "assets=BTC" \
  --data-urlencode "assets=ETH" \
  --data-urlencode "durations=PT15M" \
  --data-urlencode "durations=PT30M" \
  --data-urlencode "durations=PT1H" \
  --data-urlencode "window=current" \
  --data-urlencode "status=open"

• asset, quoteAsset, duration, windowStart, and windowEnd
• markets[], one item per venue market in that window
• per-market outcomes[] with market odds such as midpoint, bestBid, and bestAsk
• per-market resolution, which can be passed back when polling reference prices

​

3. Add depth for visible markets

const windowsWithDepth = await client.listRecurringCryptoMarkets({
  assets: ["BTC", "ETH"],
  durations: ["PT5M", "PT15M"],
  window: "current",
  status: [MarketStatus.open],
  limit: 20,
  includeOrderbookDepth: true,
  orderbookDepth: 15,
  orderbookDepthAmountUsd: 1000,
});

for (const windowMarket of windowsWithDepth.data) {
  for (const market of windowMarket.markets) {
    for (const outcome of market.outcomes) {
      const depth = outcome.orderbookDepth;
      if (!depth) continue;

      console.log(outcome.label, {
        amountUsd: depth.amountUsd,
        buyLevels: depth.buy.levels.length,
        sellLevels: depth.sell.levels.length,
        buyAverage: depth.buy.avgPrice,
        sellAverage: depth.sell.avgPrice,
      });
    }
  }
}

​

4. Poll reference prices

const prices = await client.getCryptoReferencePrices({
  windowMarkets: windows.data,
});

for (const row of prices.data) {
  if (row.error) {
    console.warn(row.venueMarketId, row.error.code, row.error.message);
    continue;
  }

  console.log(row.venueMarketId, {
    asset: row.asset,
    price: row.normalized,
    fetchedAt: row.fetchedAt,
    ageMs: row.ageMs,
  });
}

async function pollReferencePrices() {
  const response = await client.getCryptoReferencePrices({ windowMarkets: windows.data });

  renderReferencePrices(response.data);

  window.setTimeout(pollReferencePrices, response.softRefreshMs);
}

void pollReferencePrices();

​

5. Match prices back to markets

const byVenueMarketId = new Map(
  prices.data
    .filter((row) => !row.error && row.venueMarketId)
    .map((row) => [row.venueMarketId!, row]),
);

for (const windowMarket of windows.data) {
  for (const market of windowMarket.markets) {
    const reference = byVenueMarketId.get(market.venueMarketId);

    console.log({
      venue: market.venue,
      question: market.question,
      underlying: reference?.normalized ?? null,
      upMidpoint: market.outcomes.find((o) => o.label.toLowerCase() === "up")?.midpoint,
      downMidpoint: market.outcomes.find((o) => o.label.toLowerCase() === "down")?.midpoint,
    });
  }
}

​

API reference

​

Trading behavior

• market.routeable
• market.splitOrdersAllowed
• outcome.routeable
• outcome.splitOrdersAllowed

​

Integration notes

• Reference prices are USD-only (quoteAsset: "USD") and are separate from prediction-market odds.
• listRecurringCryptoMarkets supports deterministic crypto durations: PT5M, PT15M, PT30M, PT1H, PT4H, and P1D, plus aliases 5m, 15m, 30m, 1h, 4h, and 1d.
• getCryptoReferencePrices accepts up to 100 targets. For active views, pass the visible windows or venue market ids rather than polling every discovered market.
• Prefer getCryptoReferencePrices for live reference-price polling. The discovery endpoint can include reference prices, but the dedicated polling endpoint is built for fresh active views.
• Use includeOrderbookDepth only for visible rows that need liquidity context. Depth is capped at 15 levels per side, and orderbookDepthAmountUsd must be greater than 0.
• Treat rows with error, stale: true, or normalized: null as unavailable for display.
• source.confidence can be verified, inferred, or missing. Show low-confidence or missing sources conservatively in production trading experiences.

​

Recommended UI flow

1. Call listRecurringCryptoMarkets for the current window and render the market cards.
2. Include orderbookDepth only for rows where the user needs liquidity or sweep context.
3. Call getCryptoReferencePrices for the visible windows.
4. Display market odds, orderbook depth, and reference prices as separate values.
5. Poll reference prices using softRefreshMs while the view is visible.
6. Stop polling when the user leaves the view or the window status is no longer open.

​

FAQ

​

Are reference prices the same as market prices?

​

Which crypto windows are supported?

​

What should I do when a reference price is stale or unavailable?

​

Related