@0xarchive/sdk 0.9.0 → 0.9.2

package/dist/index.d.ts

@@ -363,6 +363,8 @@ interface Candle {
 interface CandleHistoryParams extends CursorPaginationParams {
     /** Candle interval (default: 1h) */
     interval?: CandleInterval;
+    /** Maximum number of results to return (default: 100, max: 10000 for candles) */
+    limit?: number;
 }
 /** Pre-aggregated liquidation volume bucket */
 interface LiquidationVolume {
@@ -734,6 +736,77 @@ interface WsEventHandlers {
     onMessage?: (message: WsServerMessage) => void;
     onStateChange?: (state: WsConnectionState) => void;
 }
+/** SIWE challenge message returned by the challenge endpoint */
+interface SiweChallenge {
+    /** The SIWE message to sign with personal_sign (EIP-191) */
+    message: string;
+    /** Single-use nonce (expires after 10 minutes) */
+    nonce: string;
+}
+/** Result of creating a free-tier account via wallet signature */
+interface Web3SignupResult {
+    /** The generated API key */
+    apiKey: string;
+    /** Account tier (e.g., 'free') */
+    tier: string;
+    /** The wallet address that owns this key */
+    walletAddress: string;
+}
+/** An API key record returned by the keys endpoint */
+interface Web3ApiKey {
+    /** Unique key ID (UUID) */
+    id: string;
+    /** Key name */
+    name: string;
+    /** First characters of the key for identification */
+    keyPrefix: string;
+    /** Whether the key is currently active */
+    isActive: boolean;
+    /** Last usage timestamp (ISO 8601) */
+    lastUsedAt?: string;
+    /** Creation timestamp (ISO 8601) */
+    createdAt: string;
+}
+/** List of API keys for a wallet */
+interface Web3KeysList {
+    /** All API keys belonging to this wallet */
+    keys: Web3ApiKey[];
+    /** The wallet address */
+    walletAddress: string;
+}
+/** Result of revoking an API key */
+interface Web3RevokeResult {
+    /** Confirmation message */
+    message: string;
+    /** The wallet address that owned the key */
+    walletAddress: string;
+}
+/** x402 payment details returned by subscribe (402 response) */
+interface Web3PaymentRequired {
+    /** Amount in smallest unit (e.g., "49000000" for $49 USDC) */
+    amount: string;
+    /** Payment asset (e.g., "USDC") */
+    asset: string;
+    /** Blockchain network (e.g., "base") */
+    network: string;
+    /** Address to send payment to */
+    payTo: string;
+    /** Token contract address */
+    assetAddress: string;
+}
+/** Result of a successful x402 subscription */
+interface Web3SubscribeResult {
+    /** The generated API key */
+    apiKey: string;
+    /** Subscription tier */
+    tier: string;
+    /** Expiration timestamp (ISO 8601) */
+    expiresAt: string;
+    /** The wallet address that owns the subscription */
+    walletAddress: string;
+    /** On-chain transaction hash */
+    txHash?: string;
+}
 /**
  * API error response
  */
@@ -1049,6 +1122,10 @@ declare class HttpClient {
     constructor(options: HttpClientOptions);
     /** Whether validation is enabled */
     get validationEnabled(): boolean;
+    /** Base URL for raw requests (used by web3 subscribe) */
+    getBaseUrl(): string;
+    /** Timeout in ms for raw requests (used by web3 subscribe) */
+    getTimeout(): number;
     /**
      * Make a GET request to the API
      *
@@ -1057,6 +1134,14 @@ declare class HttpClient {
      * @param schema - Optional Zod schema for validation (used when validation is enabled)
      */
     get<T>(path: string, params?: Record<string, unknown>, schema?: z.ZodType<T>): Promise<T>;
+    /**
+     * Make a POST request to the API
+     *
+     * @param path - API endpoint path
+     * @param body - JSON request body
+     * @param schema - Optional Zod schema for validation (used when validation is enabled)
+     */
+    post<T>(path: string, body?: Record<string, unknown>, schema?: z.ZodType<T>): Promise<T>;
 }
 
 /**
@@ -1695,7 +1780,7 @@ declare class OpenInterestResource {
  *   start: Date.now() - 86400000,
  *   end: Date.now(),
  *   interval: '1h',
- *   limit: 1000
+ *   limit: 10000
  * });
  *
  * // Get all pages
@@ -1706,7 +1791,7 @@ declare class OpenInterestResource {
  *     end: Date.now(),
  *     interval: '1h',
  *     cursor: result.nextCursor,
- *     limit: 1000
+ *     limit: 10000
  *   });
  *   allCandles.push(...result.data);
  * }
@@ -1977,6 +2062,82 @@ declare class DataQualityResource {
     sla(params?: SlaParams): Promise<SlaResponse>;
 }
 
+/**
+ * Wallet-based authentication: get API keys via SIWE signature.
+ *
+ * No API key is required for these endpoints. Use an Ethereum wallet to
+ * create a free-tier account, list keys, or revoke keys — all programmatically.
+ *
+ * @example
+ * ```typescript
+ * const client = new OxArchive({ apiKey: 'placeholder' });
+ *
+ * // Step 1: Get a challenge
+ * const challenge = await client.web3.challenge('0x742d35Cc6634C0532925a3b844Bc9e7595f2bD18');
+ *
+ * // Step 2: Sign the message with your wallet, then submit
+ * const result = await client.web3.signup(challenge.message, signature);
+ * console.log(`API key: ${result.apiKey}`);
+ * ```
+ */
+declare class Web3Resource {
+    private http;
+    constructor(http: HttpClient);
+    /**
+     * Get a SIWE challenge message to sign.
+     *
+     * @param address - Ethereum wallet address
+     * @returns SIWE message and nonce. Sign the message with personal_sign (EIP-191).
+     */
+    challenge(address: string): Promise<SiweChallenge>;
+    /**
+     * Create a free-tier account and get an API key.
+     *
+     * @param message - The SIWE message from {@link challenge}
+     * @param signature - Hex-encoded signature from personal_sign
+     * @returns API key, tier, and wallet address
+     */
+    signup(message: string, signature: string): Promise<Web3SignupResult>;
+    /**
+     * List all API keys for the authenticated wallet.
+     *
+     * @param message - The SIWE message from {@link challenge}
+     * @param signature - Hex-encoded signature from personal_sign
+     * @returns List of API keys and wallet address
+     */
+    listKeys(message: string, signature: string): Promise<Web3KeysList>;
+    /**
+     * Revoke a specific API key.
+     *
+     * @param message - The SIWE message from {@link challenge}
+     * @param signature - Hex-encoded signature from personal_sign
+     * @param keyId - UUID of the key to revoke
+     * @returns Confirmation message and wallet address
+     */
+    revokeKey(message: string, signature: string, keyId: string): Promise<Web3RevokeResult>;
+    /**
+     * Get pricing info for a paid subscription (x402 flow, step 1).
+     *
+     * Returns the payment details needed to sign a USDC transfer on Base.
+     * After signing, pass the payment signature to {@link subscribe}.
+     *
+     * @param tier - Subscription tier: 'build' ($49/mo) or 'pro' ($199/mo)
+     * @returns Payment details (amount, asset, network, pay-to address)
+     */
+    subscribeQuote(tier: 'build' | 'pro'): Promise<Web3PaymentRequired>;
+    /**
+     * Complete a paid subscription with a signed x402 payment (step 2).
+     *
+     * Requires a payment signature from signing a USDC transfer (EIP-3009)
+     * for the amount returned by {@link subscribeQuote}.
+     *
+     * @param tier - Subscription tier: 'build' or 'pro'
+     * @param paymentSignature - Signed x402 payment (from EIP-3009 USDC transfer on Base)
+     * @returns API key, tier, expiration, and wallet address
+     */
+    subscribe(tier: 'build' | 'pro', paymentSignature: string): Promise<Web3SubscribeResult>;
+}
+
 /**
  * Hyperliquid exchange client
  *
@@ -2085,7 +2246,30 @@ declare class Hip3Client {
      * OHLCV candle data
      */
     readonly candles: CandlesResource;
+    private http;
     constructor(http: HttpClient);
+    /**
+     * Get per-coin data freshness across all data types
+     *
+     * @param coin - The coin symbol (case-sensitive, e.g., 'km:US500')
+     * @returns Per-coin freshness with last_updated and lag_ms for each data type
+     */
+    freshness(coin: string): Promise<CoinFreshness>;
+    /**
+     * Get combined market summary (price, funding, OI) in one call
+     *
+     * @param coin - The coin symbol (case-sensitive, e.g., 'km:US500')
+     * @returns Combined market summary
+     */
+    summary(coin: string): Promise<CoinSummary>;
+    /**
+     * Get mark/oracle/mid price history (projected from OI data)
+     *
+     * @param coin - The coin symbol (case-sensitive, e.g., 'km:US500')
+     * @param params - Time range, cursor, and interval parameters
+     * @returns CursorResponse with price snapshots
+     */
+    priceHistory(coin: string, params: PriceHistoryParams): Promise<CursorResponse<PriceSnapshot[]>>;
 }
 /**
  * Lighter.xyz exchange client
@@ -2126,7 +2310,30 @@ declare class LighterClient {
      * OHLCV candle data
      */
     readonly candles: CandlesResource;
+    private http;
     constructor(http: HttpClient);
+    /**
+     * Get per-coin data freshness across all data types
+     *
+     * @param coin - The coin symbol (e.g., 'BTC', 'ETH')
+     * @returns Per-coin freshness with last_updated and lag_ms for each data type
+     */
+    freshness(coin: string): Promise<CoinFreshness>;
+    /**
+     * Get combined market summary (price, funding, OI) in one call
+     *
+     * @param coin - The coin symbol (e.g., 'BTC', 'ETH')
+     * @returns Combined market summary
+     */
+    summary(coin: string): Promise<CoinSummary>;
+    /**
+     * Get mark/oracle price history (projected from OI data)
+     *
+     * @param coin - The coin symbol (e.g., 'BTC', 'ETH')
+     * @param params - Time range, cursor, and interval parameters
+     * @returns CursorResponse with price snapshots
+     */
+    priceHistory(coin: string, params: PriceHistoryParams): Promise<CursorResponse<PriceSnapshot[]>>;
 }
 
 /**
@@ -2180,6 +2387,10 @@ declare class OxArchive {
      * Data quality metrics: status, coverage, incidents, latency, SLA
      */
     readonly dataQuality: DataQualityResource;
+    /**
+     * Wallet-based auth: get API keys via SIWE signature
+     */
+    readonly web3: Web3Resource;
     /**
      * @deprecated Use client.hyperliquid.orderbook instead
      */
@@ -5032,4 +5243,4 @@ type ValidatedCandle = z.infer<typeof CandleSchema>;
 type ValidatedLiquidation = z.infer<typeof LiquidationSchema>;
 type ValidatedWsServerMessage = z.infer<typeof WsServerMessageSchema>;
 
-export { type ApiError, type ApiMeta, ApiMetaSchema, type ApiResponse, ApiResponseSchema, type Candle, CandleArrayResponseSchema, type CandleHistoryParams, type CandleInterval, CandleIntervalSchema, CandleSchema, type ClientOptions, type CoinFreshness, CoinFreshnessResponseSchema, CoinFreshnessSchema, type CoinSummary, CoinSummaryResponseSchema, CoinSummarySchema, type CompletenessMetrics, type CoverageGap, type CoverageResponse, type CursorResponse, type DataCadence, type DataFreshness, type DataTypeCoverage, type DataTypeFreshnessInfo, DataTypeFreshnessInfoSchema, type DataTypeStatus, type ExchangeCoverage, type ExchangeLatency, type ExchangeStatus, type FundingHistoryParams, type FundingRate, FundingRateArrayResponseSchema, FundingRateResponseSchema, FundingRateSchema, type GetOrderBookParams, type GetTradesCursorParams, Hip3Client, type Hip3Instrument, HyperliquidClient, type Incident, type IncidentSeverityValue, type IncidentStatusValue, type IncidentsResponse, type Instrument, InstrumentArrayResponseSchema, InstrumentResponseSchema, InstrumentSchema, type InstrumentType, InstrumentTypeSchema, type LatencyResponse, LighterClient, type LighterGranularity, type LighterInstrument, type Liquidation, LiquidationArrayResponseSchema, type LiquidationHistoryParams, LiquidationSchema, LiquidationSideSchema, type LiquidationVolume, LiquidationVolumeArrayResponseSchema, type LiquidationVolumeParams, LiquidationVolumeSchema, type LiquidationsByUserParams, type ListIncidentsParams, type OiFundingInterval, type OpenInterest, OpenInterestArrayResponseSchema, type OpenInterestHistoryParams, OpenInterestResponseSchema, OpenInterestSchema, type OrderBook, OrderBookArrayResponseSchema, type OrderBookHistoryParams, OrderBookReconstructor, OrderBookResponseSchema, OrderBookSchema, type OrderbookDelta, OxArchive, OxArchiveError, OxArchiveWs, type Pagination, type PriceHistoryParams, type PriceLevel, PriceLevelSchema, type PriceSnapshot, PriceSnapshotArrayResponseSchema, PriceSnapshotSchema, type ReconstructOptions, type ReconstructedOrderBook, type RestApiLatency, type SlaActual, type SlaParams, type SlaResponse, type SlaTargets, type StatusResponse, type SymbolCoverageOptions, type SymbolCoverageResponse, type SymbolDataTypeCoverage, type SystemStatusValue, type TickData, type TickHistoryParams, type Timestamp, type TimestampedRecord, TimestampedRecordSchema, type Trade, TradeArrayResponseSchema, type TradeDirection, TradeDirectionSchema, TradeSchema, type TradeSide, TradeSideSchema, type ValidatedApiMeta, type ValidatedCandle, type ValidatedFundingRate, type ValidatedInstrument, type ValidatedLiquidation, type ValidatedOpenInterest, type ValidatedOrderBook, type ValidatedPriceLevel, type ValidatedTrade, type ValidatedWsServerMessage, type WebSocketLatency, type WsChannel, WsChannelSchema, type WsClientMessage, type WsConnectionState, WsConnectionStateSchema, type WsData, WsDataSchema, type WsError, WsErrorSchema, type WsEventHandlers, type WsGapDetected, type WsHistoricalBatch, WsHistoricalBatchSchema, type WsHistoricalData, WsHistoricalDataSchema, type WsHistoricalTickData, type WsOptions, type WsPing, type WsPong, WsPongSchema, type WsReplay, type WsReplayCompleted, WsReplayCompletedSchema, type WsReplayPause, type WsReplayPaused, WsReplayPausedSchema, type WsReplayResume, type WsReplayResumed, WsReplayResumedSchema, type WsReplaySeek, type WsReplaySnapshot, WsReplaySnapshotSchema, type WsReplayStarted, WsReplayStartedSchema, type WsReplayStop, type WsReplayStopped, WsReplayStoppedSchema, type WsServerMessage, WsServerMessageSchema, type WsStream, type WsStreamCompleted, WsStreamCompletedSchema, type WsStreamProgress, WsStreamProgressSchema, type WsStreamStarted, WsStreamStartedSchema, type WsStreamStop, type WsStreamStopped, WsStreamStoppedSchema, type WsSubscribe, type WsSubscribed, WsSubscribedSchema, type WsUnsubscribe, type WsUnsubscribed, WsUnsubscribedSchema, OxArchive as default, reconstructFinal, reconstructOrderBook };
+export { type ApiError, type ApiMeta, ApiMetaSchema, type ApiResponse, ApiResponseSchema, type Candle, CandleArrayResponseSchema, type CandleHistoryParams, type CandleInterval, CandleIntervalSchema, CandleSchema, type ClientOptions, type CoinFreshness, CoinFreshnessResponseSchema, CoinFreshnessSchema, type CoinSummary, CoinSummaryResponseSchema, CoinSummarySchema, type CompletenessMetrics, type CoverageGap, type CoverageResponse, type CursorResponse, type DataCadence, type DataFreshness, type DataTypeCoverage, type DataTypeFreshnessInfo, DataTypeFreshnessInfoSchema, type DataTypeStatus, type ExchangeCoverage, type ExchangeLatency, type ExchangeStatus, type FundingHistoryParams, type FundingRate, FundingRateArrayResponseSchema, FundingRateResponseSchema, FundingRateSchema, type GetOrderBookParams, type GetTradesCursorParams, Hip3Client, type Hip3Instrument, HyperliquidClient, type Incident, type IncidentSeverityValue, type IncidentStatusValue, type IncidentsResponse, type Instrument, InstrumentArrayResponseSchema, InstrumentResponseSchema, InstrumentSchema, type InstrumentType, InstrumentTypeSchema, type LatencyResponse, LighterClient, type LighterGranularity, type LighterInstrument, type Liquidation, LiquidationArrayResponseSchema, type LiquidationHistoryParams, LiquidationSchema, LiquidationSideSchema, type LiquidationVolume, LiquidationVolumeArrayResponseSchema, type LiquidationVolumeParams, LiquidationVolumeSchema, type LiquidationsByUserParams, type ListIncidentsParams, type OiFundingInterval, type OpenInterest, OpenInterestArrayResponseSchema, type OpenInterestHistoryParams, OpenInterestResponseSchema, OpenInterestSchema, type OrderBook, OrderBookArrayResponseSchema, type OrderBookHistoryParams, OrderBookReconstructor, OrderBookResponseSchema, OrderBookSchema, type OrderbookDelta, OxArchive, OxArchiveError, OxArchiveWs, type Pagination, type PriceHistoryParams, type PriceLevel, PriceLevelSchema, type PriceSnapshot, PriceSnapshotArrayResponseSchema, PriceSnapshotSchema, type ReconstructOptions, type ReconstructedOrderBook, type RestApiLatency, type SiweChallenge, type SlaActual, type SlaParams, type SlaResponse, type SlaTargets, type StatusResponse, type SymbolCoverageOptions, type SymbolCoverageResponse, type SymbolDataTypeCoverage, type SystemStatusValue, type TickData, type TickHistoryParams, type Timestamp, type TimestampedRecord, TimestampedRecordSchema, type Trade, TradeArrayResponseSchema, type TradeDirection, TradeDirectionSchema, TradeSchema, type TradeSide, TradeSideSchema, type ValidatedApiMeta, type ValidatedCandle, type ValidatedFundingRate, type ValidatedInstrument, type ValidatedLiquidation, type ValidatedOpenInterest, type ValidatedOrderBook, type ValidatedPriceLevel, type ValidatedTrade, type ValidatedWsServerMessage, type Web3ApiKey, type Web3KeysList, type Web3PaymentRequired, type Web3RevokeResult, type Web3SignupResult, type Web3SubscribeResult, type WebSocketLatency, type WsChannel, WsChannelSchema, type WsClientMessage, type WsConnectionState, WsConnectionStateSchema, type WsData, WsDataSchema, type WsError, WsErrorSchema, type WsEventHandlers, type WsGapDetected, type WsHistoricalBatch, WsHistoricalBatchSchema, type WsHistoricalData, WsHistoricalDataSchema, type WsHistoricalTickData, type WsOptions, type WsPing, type WsPong, WsPongSchema, type WsReplay, type WsReplayCompleted, WsReplayCompletedSchema, type WsReplayPause, type WsReplayPaused, WsReplayPausedSchema, type WsReplayResume, type WsReplayResumed, WsReplayResumedSchema, type WsReplaySeek, type WsReplaySnapshot, WsReplaySnapshotSchema, type WsReplayStarted, WsReplayStartedSchema, type WsReplayStop, type WsReplayStopped, WsReplayStoppedSchema, type WsServerMessage, WsServerMessageSchema, type WsStream, type WsStreamCompleted, WsStreamCompletedSchema, type WsStreamProgress, WsStreamProgressSchema, type WsStreamStarted, WsStreamStartedSchema, type WsStreamStop, type WsStreamStopped, WsStreamStoppedSchema, type WsSubscribe, type WsSubscribed, WsSubscribedSchema, type WsUnsubscribe, type WsUnsubscribed, WsUnsubscribedSchema, OxArchive as default, reconstructFinal, reconstructOrderBook };

package/dist/index.js

@@ -136,6 +136,14 @@ var HttpClient = class {
   get validationEnabled() {
     return this.validate;
   }
+  /** Base URL for raw requests (used by web3 subscribe) */
+  getBaseUrl() {
+    return this.baseUrl;
+  }
+  /** Timeout in ms for raw requests (used by web3 subscribe) */
+  getTimeout() {
+    return this.timeout;
+  }
   /**
    * Make a GET request to the API
    *
@@ -206,6 +214,66 @@ var HttpClient = class {
       );
     }
   }
+  /**
+   * Make a POST request to the API
+   *
+   * @param path - API endpoint path
+   * @param body - JSON request body
+   * @param schema - Optional Zod schema for validation (used when validation is enabled)
+   */
+  async post(path, body, schema) {
+    const url = `${this.baseUrl}${path}`;
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+    try {
+      const response = await fetch(url, {
+        method: "POST",
+        headers: {
+          "X-API-Key": this.apiKey,
+          "Content-Type": "application/json"
+        },
+        body: body ? JSON.stringify(body) : void 0,
+        signal: controller.signal
+      });
+      clearTimeout(timeoutId);
+      const rawData = await response.json();
+      const data = transformKeys(rawData);
+      if (!response.ok) {
+        const error = data;
+        const apiResponse = data;
+        throw new OxArchiveError(
+          error.error || `Request failed with status ${response.status}`,
+          response.status,
+          apiResponse.meta?.requestId
+        );
+      }
+      if (this.validate && schema) {
+        const result = schema.safeParse(data);
+        if (!result.success) {
+          const apiResponse = data;
+          throw new OxArchiveError(
+            `Response validation failed: ${result.error.message}`,
+            422,
+            apiResponse.meta?.requestId
+          );
+        }
+        return result.data;
+      }
+      return data;
+    } catch (error) {
+      clearTimeout(timeoutId);
+      if (error instanceof OxArchiveError) {
+        throw error;
+      }
+      if (error instanceof Error && error.name === "AbortError") {
+        throw new OxArchiveError(`Request timeout after ${this.timeout}ms`, 408);
+      }
+      throw new OxArchiveError(
+        error instanceof Error ? error.message : "Unknown error",
+        500
+      );
+    }
+  }
 };
 
 // src/schemas.ts
@@ -1477,6 +1545,147 @@ var DataQualityResource = class {
   }
 };
 
+// src/resources/web3.ts
+var Web3Resource = class {
+  constructor(http) {
+    this.http = http;
+  }
+  /**
+   * Get a SIWE challenge message to sign.
+   *
+   * @param address - Ethereum wallet address
+   * @returns SIWE message and nonce. Sign the message with personal_sign (EIP-191).
+   */
+  async challenge(address) {
+    return this.http.post("/v1/auth/web3/challenge", { address });
+  }
+  /**
+   * Create a free-tier account and get an API key.
+   *
+   * @param message - The SIWE message from {@link challenge}
+   * @param signature - Hex-encoded signature from personal_sign
+   * @returns API key, tier, and wallet address
+   */
+  async signup(message, signature) {
+    return this.http.post("/v1/web3/signup", { message, signature });
+  }
+  /**
+   * List all API keys for the authenticated wallet.
+   *
+   * @param message - The SIWE message from {@link challenge}
+   * @param signature - Hex-encoded signature from personal_sign
+   * @returns List of API keys and wallet address
+   */
+  async listKeys(message, signature) {
+    return this.http.post("/v1/web3/keys", { message, signature });
+  }
+  /**
+   * Revoke a specific API key.
+   *
+   * @param message - The SIWE message from {@link challenge}
+   * @param signature - Hex-encoded signature from personal_sign
+   * @param keyId - UUID of the key to revoke
+   * @returns Confirmation message and wallet address
+   */
+  async revokeKey(message, signature, keyId) {
+    return this.http.post("/v1/web3/keys/revoke", {
+      message,
+      signature,
+      key_id: keyId
+    });
+  }
+  /**
+   * Get pricing info for a paid subscription (x402 flow, step 1).
+   *
+   * Returns the payment details needed to sign a USDC transfer on Base.
+   * After signing, pass the payment signature to {@link subscribe}.
+   *
+   * @param tier - Subscription tier: 'build' ($49/mo) or 'pro' ($199/mo)
+   * @returns Payment details (amount, asset, network, pay-to address)
+   */
+  async subscribeQuote(tier) {
+    const url = `${this.http.getBaseUrl()}/v1/web3/subscribe`;
+    const timeout = this.http.getTimeout();
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), timeout);
+    try {
+      const response = await fetch(url, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({ tier }),
+        signal: controller.signal
+      });
+      clearTimeout(timeoutId);
+      const rawData = await response.json();
+      const data = transformKeys(rawData);
+      if (response.status === 402) {
+        return data.payment;
+      }
+      throw new OxArchiveError(
+        data.error || `Unexpected status ${response.status}`,
+        response.status
+      );
+    } catch (error) {
+      clearTimeout(timeoutId);
+      if (error instanceof OxArchiveError) throw error;
+      if (error instanceof Error && error.name === "AbortError") {
+        throw new OxArchiveError(`Request timeout after ${timeout}ms`, 408);
+      }
+      throw new OxArchiveError(
+        error instanceof Error ? error.message : "Unknown error",
+        500
+      );
+    }
+  }
+  /**
+   * Complete a paid subscription with a signed x402 payment (step 2).
+   *
+   * Requires a payment signature from signing a USDC transfer (EIP-3009)
+   * for the amount returned by {@link subscribeQuote}.
+   *
+   * @param tier - Subscription tier: 'build' or 'pro'
+   * @param paymentSignature - Signed x402 payment (from EIP-3009 USDC transfer on Base)
+   * @returns API key, tier, expiration, and wallet address
+   */
+  async subscribe(tier, paymentSignature) {
+    const url = `${this.http.getBaseUrl()}/v1/web3/subscribe`;
+    const timeout = this.http.getTimeout();
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), timeout);
+    try {
+      const response = await fetch(url, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          "payment-signature": paymentSignature
+        },
+        body: JSON.stringify({ tier }),
+        signal: controller.signal
+      });
+      clearTimeout(timeoutId);
+      const rawData = await response.json();
+      const data = transformKeys(rawData);
+      if (!response.ok) {
+        throw new OxArchiveError(
+          data.error || "Subscribe failed",
+          response.status
+        );
+      }
+      return data;
+    } catch (error) {
+      clearTimeout(timeoutId);
+      if (error instanceof OxArchiveError) throw error;
+      if (error instanceof Error && error.name === "AbortError") {
+        throw new OxArchiveError(`Request timeout after ${timeout}ms`, 408);
+      }
+      throw new OxArchiveError(
+        error instanceof Error ? error.message : "Unknown error",
+        500
+      );
+    }
+  }
+};
+
 // src/exchanges.ts
 var HyperliquidClient = class {
   /**
@@ -1596,7 +1805,9 @@ var Hip3Client = class {
    * OHLCV candle data
    */
   candles;
+  http;
   constructor(http) {
+    this.http = http;
     const basePath = "/v1/hyperliquid/hip3";
     const coinTransform = (c) => c;
     this.instruments = new Hip3InstrumentsResource(http, basePath, coinTransform);
@@ -1606,6 +1817,52 @@ var Hip3Client = class {
     this.openInterest = new OpenInterestResource(http, basePath, coinTransform);
     this.candles = new CandlesResource(http, basePath, coinTransform);
   }
+  /**
+   * Get per-coin data freshness across all data types
+   *
+   * @param coin - The coin symbol (case-sensitive, e.g., 'km:US500')
+   * @returns Per-coin freshness with last_updated and lag_ms for each data type
+   */
+  async freshness(coin) {
+    const response = await this.http.get(
+      `/v1/hyperliquid/hip3/freshness/${coin}`,
+      void 0,
+      this.http.validationEnabled ? CoinFreshnessResponseSchema : void 0
+    );
+    return response.data;
+  }
+  /**
+   * Get combined market summary (price, funding, OI) in one call
+   *
+   * @param coin - The coin symbol (case-sensitive, e.g., 'km:US500')
+   * @returns Combined market summary
+   */
+  async summary(coin) {
+    const response = await this.http.get(
+      `/v1/hyperliquid/hip3/summary/${coin}`,
+      void 0,
+      this.http.validationEnabled ? CoinSummaryResponseSchema : void 0
+    );
+    return response.data;
+  }
+  /**
+   * Get mark/oracle/mid price history (projected from OI data)
+   *
+   * @param coin - The coin symbol (case-sensitive, e.g., 'km:US500')
+   * @param params - Time range, cursor, and interval parameters
+   * @returns CursorResponse with price snapshots
+   */
+  async priceHistory(coin, params) {
+    const response = await this.http.get(
+      `/v1/hyperliquid/hip3/prices/${coin}`,
+      params,
+      this.http.validationEnabled ? PriceSnapshotArrayResponseSchema : void 0
+    );
+    return {
+      data: response.data,
+      nextCursor: response.meta.nextCursor
+    };
+  }
 };
 var LighterClient = class {
   /**
@@ -1632,7 +1889,9 @@ var LighterClient = class {
    * OHLCV candle data
    */
   candles;
+  http;
   constructor(http) {
+    this.http = http;
     const basePath = "/v1/lighter";
     this.orderbook = new OrderBookResource(http, basePath);
     this.trades = new TradesResource(http, basePath);
@@ -1641,6 +1900,52 @@ var LighterClient = class {
     this.openInterest = new OpenInterestResource(http, basePath);
     this.candles = new CandlesResource(http, basePath);
   }
+  /**
+   * Get per-coin data freshness across all data types
+   *
+   * @param coin - The coin symbol (e.g., 'BTC', 'ETH')
+   * @returns Per-coin freshness with last_updated and lag_ms for each data type
+   */
+  async freshness(coin) {
+    const response = await this.http.get(
+      `/v1/lighter/freshness/${coin.toUpperCase()}`,
+      void 0,
+      this.http.validationEnabled ? CoinFreshnessResponseSchema : void 0
+    );
+    return response.data;
+  }
+  /**
+   * Get combined market summary (price, funding, OI) in one call
+   *
+   * @param coin - The coin symbol (e.g., 'BTC', 'ETH')
+   * @returns Combined market summary
+   */
+  async summary(coin) {
+    const response = await this.http.get(
+      `/v1/lighter/summary/${coin.toUpperCase()}`,
+      void 0,
+      this.http.validationEnabled ? CoinSummaryResponseSchema : void 0
+    );
+    return response.data;
+  }
+  /**
+   * Get mark/oracle price history (projected from OI data)
+   *
+   * @param coin - The coin symbol (e.g., 'BTC', 'ETH')
+   * @param params - Time range, cursor, and interval parameters
+   * @returns CursorResponse with price snapshots
+   */
+  async priceHistory(coin, params) {
+    const response = await this.http.get(
+      `/v1/lighter/prices/${coin.toUpperCase()}`,
+      params,
+      this.http.validationEnabled ? PriceSnapshotArrayResponseSchema : void 0
+    );
+    return {
+      data: response.data,
+      nextCursor: response.meta.nextCursor
+    };
+  }
 };
 
 // src/client.ts
@@ -1660,6 +1965,10 @@ var OxArchive = class {
    * Data quality metrics: status, coverage, incidents, latency, SLA
    */
   dataQuality;
+  /**
+   * Wallet-based auth: get API keys via SIWE signature
+   */
+  web3;
   /**
    * @deprecated Use client.hyperliquid.orderbook instead
    */
@@ -1698,6 +2007,7 @@ var OxArchive = class {
     this.hyperliquid = new HyperliquidClient(this.http);
     this.lighter = new LighterClient(this.http);
     this.dataQuality = new DataQualityResource(this.http);
+    this.web3 = new Web3Resource(this.http);
     const legacyBase = "/v1/hyperliquid";
     this.orderbook = new OrderBookResource(this.http, legacyBase);
     this.trades = new TradesResource(this.http, legacyBase);