@arbiterapi/sdk 0.1.0

package/dist/index.cjs

@@ -0,0 +1,151 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  ArbiterClient: () => ArbiterClient,
+  ArbiterError: () => ArbiterError,
+  AuthenticationError: () => AuthenticationError,
+  BadRequestError: () => BadRequestError,
+  NotFoundError: () => NotFoundError
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/errors.ts
+var ArbiterError = class extends Error {
+  constructor(message, status, body) {
+    super(message);
+    this.status = status;
+    this.body = body;
+    this.name = "ArbiterError";
+  }
+};
+var NotFoundError = class extends ArbiterError {
+  constructor(message, body) {
+    super(message, 404, body);
+    this.name = "NotFoundError";
+  }
+};
+var BadRequestError = class extends ArbiterError {
+  constructor(message, body) {
+    super(message, 400, body);
+    this.name = "BadRequestError";
+  }
+};
+var AuthenticationError = class extends ArbiterError {
+  constructor(message, body) {
+    super(message, 401, body);
+    this.name = "AuthenticationError";
+  }
+};
+
+// src/client.ts
+var DEFAULT_BASE_URL = "https://api.arbiterapi.com";
+var ArbiterClient = class {
+  apiKey;
+  baseUrl;
+  constructor(config) {
+    this.apiKey = config.apiKey;
+    this.baseUrl = (config.baseUrl ?? DEFAULT_BASE_URL).replace(/\/+$/, "");
+  }
+  // ── Internal fetch helper ──
+  async request(path, params) {
+    const url = new URL(`${this.baseUrl}${path}`);
+    if (params) {
+      for (const [k, v] of Object.entries(params)) {
+        if (v !== void 0) url.searchParams.set(k, String(v));
+      }
+    }
+    const res = await fetch(url.toString(), {
+      headers: { "X-API-Key": this.apiKey }
+    });
+    if (!res.ok) {
+      const body = await res.json().catch(() => null);
+      const msg = body?.detail ?? res.statusText;
+      if (res.status === 401 || res.status === 403)
+        throw new AuthenticationError(msg, body);
+      if (res.status === 400) throw new BadRequestError(msg, body);
+      if (res.status === 404) throw new NotFoundError(msg, body);
+      throw new ArbiterError(msg, res.status, body);
+    }
+    return res.json();
+  }
+  // ── Public API ──
+  /** Health check (no auth required) */
+  async health() {
+    const res = await fetch(`${this.baseUrl}/health`);
+    return res.json();
+  }
+  /** Markets namespace */
+  markets = {
+    list: (params) => this.request("/v1/markets", params),
+    get: (marketId) => this.request(`/v1/markets/${encodeURIComponent(marketId)}`),
+    search: (params) => this.request("/v1/markets/search", params),
+    price: (marketId, params) => this.request(`/v1/markets/${encodeURIComponent(marketId)}/price`, params),
+    orderbook: (marketId) => this.request(`/v1/markets/${encodeURIComponent(marketId)}/orderbook`),
+    orderbookHistory: (marketId, params) => this.request(
+      `/v1/markets/${encodeURIComponent(marketId)}/orderbook/history`,
+      params
+    ),
+    trades: (marketId, params) => this.request(
+      `/v1/markets/${encodeURIComponent(marketId)}/trades`,
+      params
+    ),
+    candles: (marketId, params) => {
+      const query = {};
+      if (params?.interval) query.interval = params.interval;
+      if (params?.start) {
+        query.start_ts = params.start instanceof Date ? Math.floor(params.start.getTime() / 1e3) : params.start;
+      }
+      if (params?.end) {
+        query.end_ts = params.end instanceof Date ? Math.floor(params.end.getTime() / 1e3) : params.end;
+      }
+      return this.request(
+        `/v1/markets/${encodeURIComponent(marketId)}/candles`,
+        query
+      );
+    }
+  };
+  /** Events namespace */
+  events = {
+    list: (params) => this.request("/v1/events", params),
+    get: (slug) => this.request(`/v1/events/${encodeURIComponent(slug)}`)
+  };
+  /** Cross-platform matching namespace */
+  matching = {
+    list: (params) => this.request("/v1/matching-markets", params)
+  };
+  /** Wallets namespace (Polymarket) */
+  wallets = {
+    get: (address, params) => this.request(`/v1/wallets/${address}`, params),
+    trades: (address, params) => this.request(`/v1/wallets/${address}/trades`, params),
+    positions: (address, params) => this.request(`/v1/wallets/${address}/positions`, params),
+    pnl: (address) => this.request(`/v1/wallets/${address}/pnl`),
+    activity: (address, params) => this.request(`/v1/wallets/${address}/activity`, params)
+  };
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ArbiterClient,
+  ArbiterError,
+  AuthenticationError,
+  BadRequestError,
+  NotFoundError
+});

package/dist/index.d.cts

@@ -0,0 +1,299 @@
+/** Platform identifiers */
+type Platform = "polymarket" | "kalshi";
+/** Market lifecycle status */
+type MarketStatus = "open" | "closed" | "resolved";
+/** Candle interval for OHLCV data */
+type CandleInterval = "1m" | "5m" | "15m" | "1h" | "4h" | "1d";
+/** Market outcome with current price */
+interface Outcome {
+    label: string;
+    price: number;
+    price_cents: number;
+}
+/** Where a market is listed */
+interface PlatformListing {
+    platform: Platform;
+    native_id: string;
+    url?: string;
+    best_bid?: number;
+    best_ask?: number;
+    volume_24h?: number;
+}
+/** Unified market object — the core data type */
+interface Market {
+    id: string;
+    slug: string;
+    question: string;
+    description?: string;
+    status: MarketStatus;
+    outcomes: Outcome[];
+    platforms: PlatformListing[];
+    volume_24h: number;
+    volume_total?: number;
+    open_interest?: number;
+    created_at?: number;
+    close_time?: number;
+    tags: string[];
+    category?: string;
+}
+/** A single price level in the orderbook */
+interface PriceLevel {
+    price: number;
+    size: number;
+    platform: Platform;
+}
+/** Orderbook snapshot */
+interface OrderBook {
+    market_id: string;
+    bids: PriceLevel[];
+    asks: PriceLevel[];
+    spread: number;
+    mid_price: number;
+    timestamp_ms: number;
+}
+/** A single trade */
+interface Trade {
+    id: string;
+    market_id: string;
+    platform: Platform;
+    price: number;
+    size: number;
+    side: string;
+    timestamp_ms: number;
+    native_trade_id?: string;
+}
+/** Paginated trades response */
+interface TradesResponse {
+    market_id: string;
+    trades: Trade[];
+    cursor?: string;
+    has_more: boolean;
+}
+/** OHLCV candle */
+interface Candle {
+    timestamp_ms: number;
+    open: number;
+    high: number;
+    low: number;
+    close: number;
+    volume?: number;
+}
+/** Candle response with metadata */
+interface CandleResponse {
+    market_id: string;
+    interval: CandleInterval;
+    candles: Candle[];
+}
+/** Health check response */
+interface HealthResponse {
+    status: string;
+    redis: boolean;
+    exchanges: {
+        polymarket: boolean;
+        kalshi: boolean;
+    };
+}
+interface ListMarketsParams {
+    platform?: Platform;
+    status?: MarketStatus;
+    tag?: string;
+    min_volume?: number;
+    q?: string;
+    limit?: number;
+    offset?: number;
+}
+interface SearchMarketsParams {
+    q: string;
+    platform?: Platform;
+    status?: MarketStatus;
+    category?: string;
+    tag?: string;
+    min_volume?: number;
+    start_ts?: number;
+    end_ts?: number;
+    sort_by?: "volume" | "created_at";
+    limit?: number;
+    offset?: number;
+}
+interface GetTradesParams {
+    limit?: number;
+    cursor?: string;
+}
+interface GetCandlesParams {
+    interval?: CandleInterval;
+    start?: Date | number;
+    end?: Date | number;
+}
+interface PriceResponse {
+    market_id: string;
+    price: number;
+    at_time: number;
+    timestamp_ms: number;
+    platform: string;
+    source: string;
+}
+interface GetPriceParams {
+    at_time?: number;
+}
+interface OrderBookSnapshot {
+    market_id: string;
+    bids: PriceLevel[];
+    asks: PriceLevel[];
+    spread: number;
+    mid_price: number;
+    bid_depth?: number;
+    ask_depth?: number;
+    timestamp_ms: number;
+}
+interface OrderBookHistoryResponse {
+    market_id: string;
+    snapshots: OrderBookSnapshot[];
+    cursor?: string;
+    has_more: boolean;
+}
+interface GetOrderBookHistoryParams {
+    start_ts?: number;
+    end_ts?: number;
+    limit?: number;
+    cursor?: string;
+}
+interface Event {
+    slug: string;
+    title: string;
+    status: string;
+    markets: Market[];
+    market_count: number;
+    total_volume_24h: number;
+    total_volume?: number;
+    platforms: string[];
+    category?: string;
+    tags: string[];
+}
+interface EventsResponse {
+    events: Event[];
+    total: number;
+    limit: number;
+    offset: number;
+}
+interface ListEventsParams {
+    platform?: Platform;
+    status?: MarketStatus;
+    q?: string;
+    min_volume?: number;
+    limit?: number;
+    offset?: number;
+}
+interface MatchedMarket {
+    polymarket: Market;
+    kalshi: Market;
+    score: number;
+    confidence: "high" | "medium";
+}
+interface MatchingResponse {
+    matches: MatchedMarket[];
+    total: number;
+}
+interface GetMatchingParams {
+    min_score?: number;
+    confidence?: "high" | "medium";
+    q?: string;
+    limit?: number;
+    offset?: number;
+}
+interface WalletProfile {
+    address: string;
+    proxy_wallet: string;
+    pseudonym?: string;
+    bio?: string;
+    profile_image?: string;
+    platform: string;
+    portfolio_value?: any;
+}
+interface GetWalletTradesParams {
+    limit?: number;
+    offset?: number;
+    side?: "BUY" | "SELL";
+}
+interface GetWalletPositionsParams {
+    limit?: number;
+    sort_by?: "CURRENT" | "CASHPNL" | "PERCENTPNL" | "INITIAL" | "SIZE";
+    redeemable?: boolean;
+}
+interface WalletPnL {
+    address: string;
+    proxy_wallet: string;
+    total_pnl: number;
+    total_realized_pnl: number;
+    total_initial_value: number;
+    total_current_value: number;
+    positions_count: number;
+    winning_positions: number;
+    losing_positions: number;
+    platform: string;
+}
+interface GetWalletActivityParams {
+    limit?: number;
+    offset?: number;
+    activity_type?: "TRADE" | "SPLIT" | "MERGE" | "REDEEM" | "REWARD" | "CONVERSION";
+}
+/** SDK configuration */
+interface ArbiterConfig {
+    apiKey: string;
+    baseUrl?: string;
+}
+
+declare class ArbiterClient {
+    private apiKey;
+    private baseUrl;
+    constructor(config: ArbiterConfig);
+    private request;
+    /** Health check (no auth required) */
+    health(): Promise<HealthResponse>;
+    /** Markets namespace */
+    markets: {
+        list: (params?: ListMarketsParams) => Promise<Market[]>;
+        get: (marketId: string) => Promise<Market>;
+        search: (params: SearchMarketsParams) => Promise<Market[]>;
+        price: (marketId: string, params?: GetPriceParams) => Promise<PriceResponse>;
+        orderbook: (marketId: string) => Promise<OrderBook>;
+        orderbookHistory: (marketId: string, params?: GetOrderBookHistoryParams) => Promise<OrderBookHistoryResponse>;
+        trades: (marketId: string, params?: GetTradesParams) => Promise<TradesResponse>;
+        candles: (marketId: string, params?: GetCandlesParams) => Promise<CandleResponse>;
+    };
+    /** Events namespace */
+    events: {
+        list: (params?: ListEventsParams) => Promise<EventsResponse>;
+        get: (slug: string) => Promise<Event>;
+    };
+    /** Cross-platform matching namespace */
+    matching: {
+        list: (params?: GetMatchingParams) => Promise<MatchingResponse>;
+    };
+    /** Wallets namespace (Polymarket) */
+    wallets: {
+        get: (address: string, params?: {
+            with_metrics?: boolean;
+        }) => Promise<WalletProfile>;
+        trades: (address: string, params?: GetWalletTradesParams) => Promise<any[]>;
+        positions: (address: string, params?: GetWalletPositionsParams) => Promise<any[]>;
+        pnl: (address: string) => Promise<WalletPnL>;
+        activity: (address: string, params?: GetWalletActivityParams) => Promise<any[]>;
+    };
+}
+
+declare class ArbiterError extends Error {
+    status: number;
+    body?: unknown | undefined;
+    constructor(message: string, status: number, body?: unknown | undefined);
+}
+declare class NotFoundError extends ArbiterError {
+    constructor(message: string, body?: unknown);
+}
+declare class BadRequestError extends ArbiterError {
+    constructor(message: string, body?: unknown);
+}
+declare class AuthenticationError extends ArbiterError {
+    constructor(message: string, body?: unknown);
+}
+
+export { ArbiterClient, type ArbiterConfig, ArbiterError, AuthenticationError, BadRequestError, type Candle, type CandleInterval, type CandleResponse, type GetCandlesParams, type GetTradesParams, type HealthResponse, type ListMarketsParams, type Market, type MarketStatus, NotFoundError, type OrderBook, type Outcome, type Platform, type PlatformListing, type PriceLevel, type SearchMarketsParams, type Trade, type TradesResponse };

package/dist/index.d.ts

@@ -0,0 +1,299 @@
+/** Platform identifiers */
+type Platform = "polymarket" | "kalshi";
+/** Market lifecycle status */
+type MarketStatus = "open" | "closed" | "resolved";
+/** Candle interval for OHLCV data */
+type CandleInterval = "1m" | "5m" | "15m" | "1h" | "4h" | "1d";
+/** Market outcome with current price */
+interface Outcome {
+    label: string;
+    price: number;
+    price_cents: number;
+}
+/** Where a market is listed */
+interface PlatformListing {
+    platform: Platform;
+    native_id: string;
+    url?: string;
+    best_bid?: number;
+    best_ask?: number;
+    volume_24h?: number;
+}
+/** Unified market object — the core data type */
+interface Market {
+    id: string;
+    slug: string;
+    question: string;
+    description?: string;
+    status: MarketStatus;
+    outcomes: Outcome[];
+    platforms: PlatformListing[];
+    volume_24h: number;
+    volume_total?: number;
+    open_interest?: number;
+    created_at?: number;
+    close_time?: number;
+    tags: string[];
+    category?: string;
+}
+/** A single price level in the orderbook */
+interface PriceLevel {
+    price: number;
+    size: number;
+    platform: Platform;
+}
+/** Orderbook snapshot */
+interface OrderBook {
+    market_id: string;
+    bids: PriceLevel[];
+    asks: PriceLevel[];
+    spread: number;
+    mid_price: number;
+    timestamp_ms: number;
+}
+/** A single trade */
+interface Trade {
+    id: string;
+    market_id: string;
+    platform: Platform;
+    price: number;
+    size: number;
+    side: string;
+    timestamp_ms: number;
+    native_trade_id?: string;
+}
+/** Paginated trades response */
+interface TradesResponse {
+    market_id: string;
+    trades: Trade[];
+    cursor?: string;
+    has_more: boolean;
+}
+/** OHLCV candle */
+interface Candle {
+    timestamp_ms: number;
+    open: number;
+    high: number;
+    low: number;
+    close: number;
+    volume?: number;
+}
+/** Candle response with metadata */
+interface CandleResponse {
+    market_id: string;
+    interval: CandleInterval;
+    candles: Candle[];
+}
+/** Health check response */
+interface HealthResponse {
+    status: string;
+    redis: boolean;
+    exchanges: {
+        polymarket: boolean;
+        kalshi: boolean;
+    };
+}
+interface ListMarketsParams {
+    platform?: Platform;
+    status?: MarketStatus;
+    tag?: string;
+    min_volume?: number;
+    q?: string;
+    limit?: number;
+    offset?: number;
+}
+interface SearchMarketsParams {
+    q: string;
+    platform?: Platform;
+    status?: MarketStatus;
+    category?: string;
+    tag?: string;
+    min_volume?: number;
+    start_ts?: number;
+    end_ts?: number;
+    sort_by?: "volume" | "created_at";
+    limit?: number;
+    offset?: number;
+}
+interface GetTradesParams {
+    limit?: number;
+    cursor?: string;
+}
+interface GetCandlesParams {
+    interval?: CandleInterval;
+    start?: Date | number;
+    end?: Date | number;
+}
+interface PriceResponse {
+    market_id: string;
+    price: number;
+    at_time: number;
+    timestamp_ms: number;
+    platform: string;
+    source: string;
+}
+interface GetPriceParams {
+    at_time?: number;
+}
+interface OrderBookSnapshot {
+    market_id: string;
+    bids: PriceLevel[];
+    asks: PriceLevel[];
+    spread: number;
+    mid_price: number;
+    bid_depth?: number;
+    ask_depth?: number;
+    timestamp_ms: number;
+}
+interface OrderBookHistoryResponse {
+    market_id: string;
+    snapshots: OrderBookSnapshot[];
+    cursor?: string;
+    has_more: boolean;
+}
+interface GetOrderBookHistoryParams {
+    start_ts?: number;
+    end_ts?: number;
+    limit?: number;
+    cursor?: string;
+}
+interface Event {
+    slug: string;
+    title: string;
+    status: string;
+    markets: Market[];
+    market_count: number;
+    total_volume_24h: number;
+    total_volume?: number;
+    platforms: string[];
+    category?: string;
+    tags: string[];
+}
+interface EventsResponse {
+    events: Event[];
+    total: number;
+    limit: number;
+    offset: number;
+}
+interface ListEventsParams {
+    platform?: Platform;
+    status?: MarketStatus;
+    q?: string;
+    min_volume?: number;
+    limit?: number;
+    offset?: number;
+}
+interface MatchedMarket {
+    polymarket: Market;
+    kalshi: Market;
+    score: number;
+    confidence: "high" | "medium";
+}
+interface MatchingResponse {
+    matches: MatchedMarket[];
+    total: number;
+}
+interface GetMatchingParams {
+    min_score?: number;
+    confidence?: "high" | "medium";
+    q?: string;
+    limit?: number;
+    offset?: number;
+}
+interface WalletProfile {
+    address: string;
+    proxy_wallet: string;
+    pseudonym?: string;
+    bio?: string;
+    profile_image?: string;
+    platform: string;
+    portfolio_value?: any;
+}
+interface GetWalletTradesParams {
+    limit?: number;
+    offset?: number;
+    side?: "BUY" | "SELL";
+}
+interface GetWalletPositionsParams {
+    limit?: number;
+    sort_by?: "CURRENT" | "CASHPNL" | "PERCENTPNL" | "INITIAL" | "SIZE";
+    redeemable?: boolean;
+}
+interface WalletPnL {
+    address: string;
+    proxy_wallet: string;
+    total_pnl: number;
+    total_realized_pnl: number;
+    total_initial_value: number;
+    total_current_value: number;
+    positions_count: number;
+    winning_positions: number;
+    losing_positions: number;
+    platform: string;
+}
+interface GetWalletActivityParams {
+    limit?: number;
+    offset?: number;
+    activity_type?: "TRADE" | "SPLIT" | "MERGE" | "REDEEM" | "REWARD" | "CONVERSION";
+}
+/** SDK configuration */
+interface ArbiterConfig {
+    apiKey: string;
+    baseUrl?: string;
+}
+
+declare class ArbiterClient {
+    private apiKey;
+    private baseUrl;
+    constructor(config: ArbiterConfig);
+    private request;
+    /** Health check (no auth required) */
+    health(): Promise<HealthResponse>;
+    /** Markets namespace */
+    markets: {
+        list: (params?: ListMarketsParams) => Promise<Market[]>;
+        get: (marketId: string) => Promise<Market>;
+        search: (params: SearchMarketsParams) => Promise<Market[]>;
+        price: (marketId: string, params?: GetPriceParams) => Promise<PriceResponse>;
+        orderbook: (marketId: string) => Promise<OrderBook>;
+        orderbookHistory: (marketId: string, params?: GetOrderBookHistoryParams) => Promise<OrderBookHistoryResponse>;
+        trades: (marketId: string, params?: GetTradesParams) => Promise<TradesResponse>;
+        candles: (marketId: string, params?: GetCandlesParams) => Promise<CandleResponse>;
+    };
+    /** Events namespace */
+    events: {
+        list: (params?: ListEventsParams) => Promise<EventsResponse>;
+        get: (slug: string) => Promise<Event>;
+    };
+    /** Cross-platform matching namespace */
+    matching: {
+        list: (params?: GetMatchingParams) => Promise<MatchingResponse>;
+    };
+    /** Wallets namespace (Polymarket) */
+    wallets: {
+        get: (address: string, params?: {
+            with_metrics?: boolean;
+        }) => Promise<WalletProfile>;
+        trades: (address: string, params?: GetWalletTradesParams) => Promise<any[]>;
+        positions: (address: string, params?: GetWalletPositionsParams) => Promise<any[]>;
+        pnl: (address: string) => Promise<WalletPnL>;
+        activity: (address: string, params?: GetWalletActivityParams) => Promise<any[]>;
+    };
+}
+
+declare class ArbiterError extends Error {
+    status: number;
+    body?: unknown | undefined;
+    constructor(message: string, status: number, body?: unknown | undefined);
+}
+declare class NotFoundError extends ArbiterError {
+    constructor(message: string, body?: unknown);
+}
+declare class BadRequestError extends ArbiterError {
+    constructor(message: string, body?: unknown);
+}
+declare class AuthenticationError extends ArbiterError {
+    constructor(message: string, body?: unknown);
+}
+
+export { ArbiterClient, type ArbiterConfig, ArbiterError, AuthenticationError, BadRequestError, type Candle, type CandleInterval, type CandleResponse, type GetCandlesParams, type GetTradesParams, type HealthResponse, type ListMarketsParams, type Market, type MarketStatus, NotFoundError, type OrderBook, type Outcome, type Platform, type PlatformListing, type PriceLevel, type SearchMarketsParams, type Trade, type TradesResponse };

package/dist/index.js

@@ -0,0 +1,120 @@
+// src/errors.ts
+var ArbiterError = class extends Error {
+  constructor(message, status, body) {
+    super(message);
+    this.status = status;
+    this.body = body;
+    this.name = "ArbiterError";
+  }
+};
+var NotFoundError = class extends ArbiterError {
+  constructor(message, body) {
+    super(message, 404, body);
+    this.name = "NotFoundError";
+  }
+};
+var BadRequestError = class extends ArbiterError {
+  constructor(message, body) {
+    super(message, 400, body);
+    this.name = "BadRequestError";
+  }
+};
+var AuthenticationError = class extends ArbiterError {
+  constructor(message, body) {
+    super(message, 401, body);
+    this.name = "AuthenticationError";
+  }
+};
+
+// src/client.ts
+var DEFAULT_BASE_URL = "https://api.arbiterapi.com";
+var ArbiterClient = class {
+  apiKey;
+  baseUrl;
+  constructor(config) {
+    this.apiKey = config.apiKey;
+    this.baseUrl = (config.baseUrl ?? DEFAULT_BASE_URL).replace(/\/+$/, "");
+  }
+  // ── Internal fetch helper ──
+  async request(path, params) {
+    const url = new URL(`${this.baseUrl}${path}`);
+    if (params) {
+      for (const [k, v] of Object.entries(params)) {
+        if (v !== void 0) url.searchParams.set(k, String(v));
+      }
+    }
+    const res = await fetch(url.toString(), {
+      headers: { "X-API-Key": this.apiKey }
+    });
+    if (!res.ok) {
+      const body = await res.json().catch(() => null);
+      const msg = body?.detail ?? res.statusText;
+      if (res.status === 401 || res.status === 403)
+        throw new AuthenticationError(msg, body);
+      if (res.status === 400) throw new BadRequestError(msg, body);
+      if (res.status === 404) throw new NotFoundError(msg, body);
+      throw new ArbiterError(msg, res.status, body);
+    }
+    return res.json();
+  }
+  // ── Public API ──
+  /** Health check (no auth required) */
+  async health() {
+    const res = await fetch(`${this.baseUrl}/health`);
+    return res.json();
+  }
+  /** Markets namespace */
+  markets = {
+    list: (params) => this.request("/v1/markets", params),
+    get: (marketId) => this.request(`/v1/markets/${encodeURIComponent(marketId)}`),
+    search: (params) => this.request("/v1/markets/search", params),
+    price: (marketId, params) => this.request(`/v1/markets/${encodeURIComponent(marketId)}/price`, params),
+    orderbook: (marketId) => this.request(`/v1/markets/${encodeURIComponent(marketId)}/orderbook`),
+    orderbookHistory: (marketId, params) => this.request(
+      `/v1/markets/${encodeURIComponent(marketId)}/orderbook/history`,
+      params
+    ),
+    trades: (marketId, params) => this.request(
+      `/v1/markets/${encodeURIComponent(marketId)}/trades`,
+      params
+    ),
+    candles: (marketId, params) => {
+      const query = {};
+      if (params?.interval) query.interval = params.interval;
+      if (params?.start) {
+        query.start_ts = params.start instanceof Date ? Math.floor(params.start.getTime() / 1e3) : params.start;
+      }
+      if (params?.end) {
+        query.end_ts = params.end instanceof Date ? Math.floor(params.end.getTime() / 1e3) : params.end;
+      }
+      return this.request(
+        `/v1/markets/${encodeURIComponent(marketId)}/candles`,
+        query
+      );
+    }
+  };
+  /** Events namespace */
+  events = {
+    list: (params) => this.request("/v1/events", params),
+    get: (slug) => this.request(`/v1/events/${encodeURIComponent(slug)}`)
+  };
+  /** Cross-platform matching namespace */
+  matching = {
+    list: (params) => this.request("/v1/matching-markets", params)
+  };
+  /** Wallets namespace (Polymarket) */
+  wallets = {
+    get: (address, params) => this.request(`/v1/wallets/${address}`, params),
+    trades: (address, params) => this.request(`/v1/wallets/${address}/trades`, params),
+    positions: (address, params) => this.request(`/v1/wallets/${address}/positions`, params),
+    pnl: (address) => this.request(`/v1/wallets/${address}/pnl`),
+    activity: (address, params) => this.request(`/v1/wallets/${address}/activity`, params)
+  };
+};
+export {
+  ArbiterClient,
+  ArbiterError,
+  AuthenticationError,
+  BadRequestError,
+  NotFoundError
+};

package/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "@arbiterapi/sdk",
+  "version": "0.1.0",
+  "description": "TypeScript SDK for the Arbiter prediction market API",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": ["dist"],
+  "scripts": {
+    "build": "tsup src/index.ts --format esm,cjs --dts",
+    "dev": "tsup src/index.ts --format esm,cjs --dts --watch",
+    "typecheck": "tsc --noEmit"
+  },
+  "devDependencies": {
+    "tsup": "^8.0.0",
+    "typescript": "^5.5.0"
+  },
+  "keywords": ["prediction-markets", "polymarket", "kalshi", "api"],
+  "license": "MIT"
+}