TypeScript SDK

import { Ironflow } from "@ironflowsh/sdk";

const client = new Ironflow("if_your_api_key");

// Optional: custom base URL or source
const client = new Ironflow("if_your_api_key", {
  baseUrl: "https://api.ironflow.sh",
  source: "hyperliquid",
});

// Liveness probe (no auth required)
const health = await client.healthz();        // { status: "ok" }

// Public component status + freshness
const status = await client.status();

// Rolling-window API + pipeline + synthetic metrics (no auth required)
const metrics = await client.statusMetrics();
console.log(metrics.api.latency_p99_ms, metrics.pipeline.events_per_sec);

// Uptime / freshness timeline — "24h" (default) or "7d"
const history = await client.statusHistory("7d");
console.log(history.uptime_percent, history.points.length);

// Every active market across all classes + issuers
const all = await client.markets();

// Filter by class and/or issuer
const perps    = await client.markets({ market_class: "perp" });
const spot     = await client.markets({ market_class: "spot" });
const outcomes = await client.markets({ market_class: "prediction" }); // HIP-4 binary outcomes
const native   = await client.markets({ issuer: "" });        // native non-builder only
const flxOnly  = await client.markets({ issuer: "flx" });     // HIP-3 builder

// Each row carries the full v3 identity tuple, so it joins with /v1/* responses:
//   { market_id, source, market_class, issuer,
//     base_asset, quote_asset, base_market, display_symbol,
//     hl_coin, active_from_ms }

// Trades
const trades = await client.trades("BTC-PERP", { limit: 100 });
const fills  = await client.fills({ address: "0xabc", market: "BTC-PERP" });
const candles = await client.candles("BTC-PERP", "1h", { limit: 24 });

// More endpoints
const funding = await client.funding("BTC-PERP");
const oi      = await client.openInterest("BTC-PERP");
const marks   = await client.markPrices("BTC-PERP");

// Felix Exchange's natural-gas perp
const gas = await client.trades("flx:GAS-PERP", { limit: 100 });

// XYZ's NVDA-PERP
const nvda = await client.trades("xyz:NVDA-PERP", { limit: 100 });
for (const trade of nvda.data) {
  console.log(trade.issuer, trade.base_market, trade.price);
  // → "xyz" "NVDA-PERP" "881.20"
}

// Latest trades on the "Yes" side of the BTC-above-$78,213 daily binary
const ticks = await client.trades("BTC-78213-20260503-Yes", { limit: 10 });
for (const t of ticks.data) {
  console.log(`Yes @ ${t.price}, size ${t.size}`); // price ∈ (0, 1)
}

// Historical fills on the same market
const yes = await client.fills({ address: "0xabc", market: "BTC-78213-20260503-Yes" });

// Resolution metadata (target price, expiry, period) lives on /v1/markets
const outcomes = await client.markets({ market_class: "prediction" });
console.log(outcomes[0].metadata); // { class: "priceBinary", underlying: "BTC", expiry, targetPrice, period, ... }

let page = await client.trades("BTC-PERP", { limit: 1000 });

while (true) {
  for (const trade of page.data) {
    process(trade);
  }
  if (!page.hasMore) break;
  page = await page.next();
}

const ops = await client.vaultOperations({ vault: "0xvault_address" });

// List predefined + custom cohorts
const cohorts = await client.listCohorts();

// Create custom cohort
await client.createCohort({ name: "my_wallets", addresses: ["0xabc", "0xdef"] });

// Get addresses
const addrs = await client.cohortAddresses("top_pnl_30d");

// Delete
await client.deleteCohort("my_wallets");

const flows    = await client.netFlows({ interval: "1d", limit: 7 });
const levels   = await client.liquidationLevels("BTC-PERP", { bucket_size: 100 });
const orderFlow = await client.orderFlow();
const vaults   = await client.vaultLeaderboard({ limit: 10 });
const funding  = await client.fundingStats("BTC-PERP", { interval: "1d" });

import { Ironflow, RateLimitError, AuthError, TierError, IronflowError } from "@ironflowsh/sdk";

try {
  const page = await client.trades("BTC-PERP");
} catch (err) {
  if (err instanceof RateLimitError) {
    await sleep(err.retryAfterMs);
  } else if (err instanceof AuthError) {
    console.error("Invalid API key");
  } else if (err instanceof TierError) {
    console.error("Feature not available on your tier");
  } else if (err instanceof IronflowError) {
    console.error(err.code, err.status, err.message);
  }
}

import type {
  Trade, BookSnapshot, BookLevel, Candle,
  FundingRate, Liquidation, OpenInterest, MarkPrice,
  Deposit, Withdrawal, OrderStatus, VaultOperation,
  Trigger, CreateTriggerRequest, TriggerRule,
  CohortInfo, CohortAddresses,
  NetFlow, LiquidationLevel, OrderFlow,
  VaultLeaderboardEntry, FundingStats,
  Market, MarketsResponse, MarketsOptions,
  StatusResponse, StatusMetricsResponse, StatusHistoryResponse, UptimePoint,
  MeResponse, HealthResponse,
  QueryOptions, CandleOptions, AnalyticsOptions,
} from "@ironflowsh/sdk";