@pear-protocol/hyperliquid-sdk 0.0.74 → 0.0.75

package/dist/clients/kalshi.d.ts

@@ -0,0 +1,87 @@
+import type { ApiResponse } from '../types';
+export interface KalshiPriceRange {
+    start: string;
+    end: string;
+    step: string;
+}
+export interface KalshiMveLeg {
+    event_ticker: string;
+    market_ticker: string;
+    side: string;
+}
+export interface KalshiMarket {
+    ticker: string;
+    event_ticker: string;
+    market_type: 'binary' | string;
+    title: string;
+    subtitle: string;
+    yes_sub_title: string;
+    no_sub_title: string;
+    created_time: string;
+    open_time: string;
+    close_time: string;
+    expiration_time: string;
+    latest_expiration_time: string;
+    settlement_timer_seconds: number;
+    status: 'initialized' | 'open' | 'closed' | 'settled' | string;
+    response_price_units: 'usd_cent' | string;
+    yes_bid: number;
+    yes_bid_dollars: string;
+    yes_ask: number;
+    yes_ask_dollars: string;
+    no_bid: number;
+    no_bid_dollars: string;
+    no_ask: number;
+    no_ask_dollars: string;
+    last_price: number;
+    last_price_dollars: string;
+    volume: number;
+    volume_24h: number;
+    result: 'yes' | 'no' | null;
+    can_close_early: boolean;
+    open_interest: number;
+    notional_value: number;
+    notional_value_dollars: string;
+    previous_yes_bid: number;
+    previous_yes_bid_dollars: string;
+    previous_yes_ask: number;
+    previous_yes_ask_dollars: string;
+    previous_price: number;
+    previous_price_dollars: string;
+    liquidity: number;
+    liquidity_dollars: string;
+    expiration_value: string;
+    tick_size: number;
+    rules_primary: string;
+    rules_secondary: string;
+    price_level_structure: string;
+    price_ranges: KalshiPriceRange[];
+    expected_expiration_time: string;
+    settlement_value: number;
+    settlement_value_dollars: string;
+    settlement_ts: string;
+    fee_waiver_expiration_time: string;
+    early_close_condition: string;
+    strike_type: 'greater' | 'less' | 'between' | string;
+    floor_strike: number;
+    cap_strike: number;
+    functional_strike: string;
+    custom_strike: Record<string, unknown>;
+    mve_collection_ticker: string;
+    mve_selected_legs: KalshiMveLeg[];
+    primary_participant_key: string;
+    is_provisional: boolean;
+}
+export interface KalshiMarketsResponse {
+    markets: KalshiMarket[];
+    cursor: string;
+}
+export interface GetKalshiMarketsParams {
+    limit?: number;
+    cursor?: string;
+    tickers?: string[];
+    event_ticker?: string;
+    series_ticker?: string;
+    status?: string;
+}
+export declare function getKalshiMarkets(params?: GetKalshiMarketsParams): Promise<ApiResponse<KalshiMarketsResponse>>;

package/dist/clients/positions.d.ts

@@ -1,7 +1,8 @@
-import type { ApiResponse } from "../types";
+import type { ApiResponse, ExternalFillDto } from "../types";
 import type { CancelTwapResponseDto } from "./orders";
-export type ExecutionType = "MARKET" | "LIMIT" | "TWAP" | "LADDER" | "LIMIT_BTCDOM";
-export type TpSlThresholdType = "PERCENTAGE" | "DOLLAR" | "POSITION_VALUE";
+export type ExecutionType = "MARKET" | "TRIGGER" | "TWAP" | "LADDER" | "TP" | "SL" | "SPOT_MARKET" | "SPOT_LIMIT" | "SPOT_TWAP";
+export type TriggerType = "PRICE" | "PRICE_RATIO" | "WEIGHTED_RATIO" | "BTC_DOM" | "CROSS_ASSET_PRICE" | "PREDICTION_MARKET_OUTCOME";
+export type TpSlThresholdType = "PERCENTAGE" | "DOLLAR" | "POSITION_VALUE" | "PRICE" | "PRICE_RATIO" | "WEIGHTED_RATIO";
 export interface PairAssetInput {
     asset: string;
     weight?: number;
@@ -9,6 +10,9 @@ export interface PairAssetInput {
 export interface TpSlThresholdInput {
     type: TpSlThresholdType;
     value: number;
+    isTrailing?: boolean;
+    trailingDeltaValue?: number;
+    trailingActivationValue?: number;
 }
 export interface LadderConfigInput {
     ratioStart: number;
@@ -22,8 +26,11 @@ export interface CreatePositionRequestInput {
     usdValue: number;
     longAssets?: PairAssetInput[];
     shortAssets?: PairAssetInput[];
-    triggerValue?: number;
+    triggerValue?: string | number;
+    triggerType?: TriggerType;
     direction?: "MORE_THAN" | "LESS_THAN";
+    assetName?: string;
+    marketCode?: string;
     twapDuration?: number;
     twapIntervalSeconds?: number;
     randomizeExecution?: boolean;
@@ -32,24 +39,9 @@ export interface CreatePositionRequestInput {
     takeProfit?: TpSlThresholdInput | null;
     stopLoss?: TpSlThresholdInput | null;
 }
-export type PositionResponseStatus = "SUCCESS" | "FAILED" | "PENDING" | "PARTIALLY_FILLED" | "OPEN";
-export interface PositionAssetSummaryDto {
-    asset: string;
-    side: "LONG" | "SHORT";
-    size: number;
-    entryRatio: number;
-    usdValue: number;
-    orderId: string;
-}
 export interface CreatePositionResponseDto {
-    positionId: string | null;
     orderId: string;
-    status: PositionResponseStatus;
-    createdAt: string;
-    assets?: PositionAssetSummaryDto[];
-    stopLoss?: TpSlThresholdInput | null;
-    takeProfit?: TpSlThresholdInput | null;
-    hyperliquidResult?: any;
+    fills?: ExternalFillDto[];
 }
 /**
  * Create a position (MARKET/LIMIT/TWAP) using Pear Hyperliquid service

package/dist/hooks/index.d.ts

@@ -7,7 +7,6 @@ export * from './useHistoricalPriceData';
 export * from './useBasketCandles';
 export * from './usePerformanceOverlays';
 export * from './useAgentWallet';
-export * from './useAutoSyncFills';
 export * from './usePosition';
 export * from './useOrders';
 export * from './useSpotOrder';
@@ -18,3 +17,4 @@ export * from './useWatchlist';
 export * from './usePortfolio';
 export * from './useAuth';
 export * from './useAllUserBalances';
+export * from './useHyperliquidUserFills';

package/dist/hooks/useHyperliquidUserFills.d.ts

@@ -0,0 +1,17 @@
+import type { SyncFillsResponseDto } from '../types';
+export interface UseHyperliquidUserFillsOptions {
+    baseUrl: string;
+    address: string | null;
+    aggregateByTime?: boolean;
+}
+export interface UseHyperliquidUserFillsState {
+    lastRunAt: number | null;
+    lastResult: SyncFillsResponseDto | null;
+    error: string | null;
+    isSyncing: boolean;
+    handleUserFillsEvent: () => Promise<void>;
+}
+/**
+ * Provides a callback to sync user fills whenever the native WebSocket emits a userFills event.
+ */
+export declare function useHyperliquidUserFills(options: UseHyperliquidUserFillsOptions): UseHyperliquidUserFillsState;

package/dist/hyperliquid-websocket.d.ts

@@ -2,9 +2,10 @@ export interface UseHyperliquidNativeWebSocketProps {
     address: string | null;
     tokens?: string[];
     enabled?: boolean;
+    onUserFills?: () => void | Promise<void>;
 }
 export interface UseHyperliquidNativeWebSocketReturn {
     isConnected: boolean;
     lastError: string | null;
 }
-export declare const useHyperliquidNativeWebSocket: ({ address, enabled, }: UseHyperliquidNativeWebSocketProps) => UseHyperliquidNativeWebSocketReturn;
+export declare const useHyperliquidNativeWebSocket: ({ address, enabled, onUserFills, }: UseHyperliquidNativeWebSocketProps) => UseHyperliquidNativeWebSocketReturn;

package/dist/index.d.ts

@@ -114,7 +114,52 @@ interface WatchlistItemDto {
 interface ToggleWatchlistResponseDto {
     items: WatchlistItemDto[];
 }
-type NotificationCategory = 'TRADE_OPENED_OUTSIDE_PEAR' | 'TRADE_CLOSED_OUTSIDE_PEAR' | 'POSITION_LIQUIDATED' | 'LIMIT_ORDER_FILLED' | 'LIMIT_ORDER_FAILED' | 'TP_ORDER_FILLED' | 'TP_ORDER_FAILED' | 'SL_ORDER_FILLED' | 'SL_ORDER_FAILED';
+type NotificationCategory = 'TRADE_OPENED_OUTSIDE_PEAR' | 'TRADE_CLOSED_OUTSIDE_PEAR' | 'POSITION_LIQUIDATED' | 'LIMIT_ORDER_FILLED' | 'LIMIT_ORDER_FAILED' | 'TP_ORDER_FILLED' | 'TP_ORDER_FAILED' | 'SL_ORDER_FILLED' | 'SL_ORDER_FAILED' | 'TRIGGER_ORDER_FILLED' | 'TRIGGER_ORDER_FAILED';
+type TriggerOrderNotificationType = 'PRICE' | 'PRICE_RATIO' | 'WEIGHTED_RATIO' | 'CROSS_ASSET_PRICE' | 'PREDICTION_MARKET_OUTCOME' | 'BTC_DOM';
+interface TriggerOrderNotificationAsset {
+    asset: string;
+    side: 'LONG' | 'SHORT';
+    weight: number;
+}
+interface BaseTriggerOrderNotificationParams {
+    order_id: string;
+    client_id: string;
+    order_type: 'TRIGGER';
+    trigger_type: TriggerOrderNotificationType;
+    usd_value: number;
+    leverage: number;
+    assets: TriggerOrderNotificationAsset[];
+    error?: string;
+}
+interface PriceTriggerParams extends BaseTriggerOrderNotificationParams {
+    trigger_type: 'PRICE';
+    direction: 'MORE_THAN' | 'LESS_THAN' | null;
+    trigger_value: number | null;
+}
+interface PriceRatioTriggerParams extends BaseTriggerOrderNotificationParams {
+    trigger_type: 'PRICE_RATIO' | 'WEIGHTED_RATIO';
+    direction: 'MORE_THAN' | 'LESS_THAN' | null;
+    trigger_value: number | null;
+}
+interface CrossAssetPriceTriggerParams extends BaseTriggerOrderNotificationParams {
+    trigger_type: 'CROSS_ASSET_PRICE';
+    direction: 'MORE_THAN' | 'LESS_THAN' | null;
+    trigger_value: number | null;
+    asset_name: string;
+}
+interface PredictionMarketOutcomeTriggerParams extends BaseTriggerOrderNotificationParams {
+    trigger_type: 'PREDICTION_MARKET_OUTCOME';
+    trigger_value: string | null;
+    market_code: string;
+    result: string;
+}
+interface BtcDomTriggerParams extends BaseTriggerOrderNotificationParams {
+    trigger_type: 'BTC_DOM';
+    direction: 'MORE_THAN' | 'LESS_THAN' | null;
+    trigger_value: number | null;
+    current_btc_dominance: number;
+}
+type TriggerOrderNotificationParams = PriceTriggerParams | PriceRatioTriggerParams | CrossAssetPriceTriggerParams | PredictionMarketOutcomeTriggerParams | BtcDomTriggerParams;
 interface NotificationDto {
     id: string;
     address: string;
@@ -233,8 +278,11 @@ interface PositionAssetDetailDto {
     collateralToken?: CollateralToken;
 }
 interface TpSlThreshold {
-    type: 'PERCENTAGE' | 'DOLLAR' | 'POSITION_VALUE';
+    type: 'PERCENTAGE' | 'DOLLAR' | 'POSITION_VALUE' | 'PRICE' | 'PRICE_RATIO' | 'WEIGHTED_RATIO';
     value: number;
+    isTrailing?: boolean;
+    trailingDeltaValue?: number;
+    trailingActivationValue?: number;
 }
 /**
  * Open position data structure
@@ -270,34 +318,91 @@ interface OrderAssetDto {
 /**
  * Order status
  */
-type OrderStatus = 'OPEN' | 'PARTIALLY_FILLED' | 'PROCESSING';
+type OrderStatus = 'OPEN' | 'PROCESSING' | 'EXECUTED' | 'CANCELLED' | 'FAILED' | 'PARTIALLY_FILLED';
 /**
  * Order type
  */
-type OrderType = 'TP' | 'SL' | 'LIMIT' | 'MARKET' | 'LIMIT_BTCDOM' | 'TWAP';
+type OrderType = 'SYNC' | 'MARKET' | 'TRIGGER' | 'TWAP' | 'LADDER' | 'TP' | 'SL' | 'SPOT_MARKET' | 'SPOT_LIMIT' | 'SPOT_TWAP';
 /**
  * TP/SL trigger type
  */
-type TpSlTriggerType = 'PERCENTAGE' | 'DOLLAR' | 'POSITION_VALUE';
-type OrderDirection = 'MORE_THAN' | 'LESS_THAN' | null;
+type TpSlTriggerType = 'PERCENTAGE' | 'DOLLAR' | 'POSITION_VALUE' | 'PRICE' | 'PRICE_RATIO' | 'WEIGHTED_RATIO';
+/**
+ * Trigger type for trigger orders
+ */
+type TriggerType$1 = 'PRICE' | 'PRICE_RATIO' | 'WEIGHTED_RATIO' | 'BTC_DOM' | 'CROSS_ASSET_PRICE' | 'PREDICTION_MARKET_OUTCOME';
+type OrderDirection = 'MORE_THAN' | 'LESS_THAN';
+/**
+ * Market order parameters
+ */
+interface MarketOrderParameters {
+    leverage?: number;
+    usdValue: number;
+    reduceOnly?: boolean;
+}
+/**
+ * Trigger order parameters
+ */
+interface TriggerOrderParameters {
+    leverage: number;
+    usdValue: number;
+    triggerType: TriggerType$1;
+    triggerValue: number;
+    direction: OrderDirection;
+    reduceOnly?: boolean;
+    assetName?: string;
+    marketCode?: string;
+    marketName?: string;
+}
+/**
+ * TWAP order parameters
+ */
+interface TwapOrderParameters {
+    leverage: number;
+    usdValue: number;
+    duration: string;
+    intervalSeconds?: number;
+    chunkUsdValue: number;
+    randomizeExecution?: boolean;
+    reduceOnly?: boolean;
+}
+/**
+ * TP/SL order parameters
+ */
+interface TpSlOrderParameters {
+    triggerType: TpSlTriggerType;
+    triggerValue: number;
+    isTrailing?: boolean;
+    trailingDeltaValue?: number;
+    trailingActivationValue?: number;
+    reduceOnly?: boolean;
+}
+/**
+ * Ladder order parameters
+ */
+interface LadderOrderParameters {
+    leverage: number;
+    usdValue: number;
+    ratioStart: number;
+    ratioEnd: number;
+    numberOfLevels: number;
+    reduceOnly?: boolean;
+}
+/**
+ * Union type for all order parameters
+ */
+type OrderParameters = MarketOrderParameters | TriggerOrderParameters | TwapOrderParameters | TpSlOrderParameters | LadderOrderParameters;
 /**
  * Open limit order data structure
  */
 interface OpenLimitOrderDto {
     orderId: string;
     address: string;
-    clientId: string | null;
+    clientId?: string | null;
     positionId?: string | null;
-    leverage: number;
-    usdValue: number;
-    triggerValue?: number | null;
-    twapDuration?: string | null;
-    tpSlTriggerType?: TpSlTriggerType | null;
-    randomizeFlag: boolean;
-    reduceOnlyFlag: boolean;
-    status: OrderStatus;
+    parameters: OrderParameters;
     orderType: OrderType;
-    direction?: OrderDirection | null;
+    status: OrderStatus;
     longAssets: OrderAssetDto[];
     shortAssets: OrderAssetDto[];
     createdAt: string;
@@ -418,7 +523,7 @@ interface WebSocketMessage {
 /**
  * WebSocket response from HyperLiquid native API
  */
-type HLChannel = 'webData3' | 'allMids' | 'activeAssetData' | 'candle' | 'spotState' | 'allDexsClearinghouseState' | 'allDexsAssetCtxs';
+type HLChannel = 'webData3' | 'allMids' | 'activeAssetData' | 'candle' | 'spotState' | 'allDexsClearinghouseState' | 'allDexsAssetCtxs' | 'userFills';
 interface HLChannelDataMap {
     webData3: WebData3Response;
     allMids: WsAllMidsData;
@@ -430,6 +535,7 @@ interface HLChannelDataMap {
     };
     allDexsClearinghouseState: AllDexsClearinghouseStateData;
     allDexsAssetCtxs: AllDexsAssetCtxsData;
+    userFills: any;
 }
 interface WebData3UserState {
     agentAddress?: string;
@@ -920,25 +1026,6 @@ declare function useAgentWallet(): {
     readonly notifyAgentWalletApproved: () => Promise<void>;
 };
 
-interface AutoSyncFillsOptions {
-    baseUrl: string;
-    address: string | null;
-    intervalMs?: number;
-    aggregateByTime?: boolean;
-}
-interface AutoSyncFillsState {
-    lastRunAt: number | null;
-    lastResult: SyncFillsResponseDto | null;
-    error: string | null;
-    isSyncing: boolean;
-    triggerSync: () => Promise<void>;
-}
-/**
- * Listens to address changes and periodically syncs user fills
- * Defaults: aggregate=true, interval=60s
- */
-declare function useAutoSyncFills(options: AutoSyncFillsOptions): AutoSyncFillsState;
-
 interface AdjustOrderRequestInput {
     limitRatio?: number;
     usdValue?: number;
@@ -1004,8 +1091,9 @@ interface SpotOrderResponseDto {
  */
 declare function executeSpotOrder(baseUrl: string, payload: SpotOrderRequestInput): Promise<ApiResponse<SpotOrderResponseDto>>;
 
-type ExecutionType = "MARKET" | "LIMIT" | "TWAP" | "LADDER" | "LIMIT_BTCDOM";
-type TpSlThresholdType = "PERCENTAGE" | "DOLLAR" | "POSITION_VALUE";
+type ExecutionType = "MARKET" | "TRIGGER" | "TWAP" | "LADDER" | "TP" | "SL" | "SPOT_MARKET" | "SPOT_LIMIT" | "SPOT_TWAP";
+type TriggerType = "PRICE" | "PRICE_RATIO" | "WEIGHTED_RATIO" | "BTC_DOM" | "CROSS_ASSET_PRICE" | "PREDICTION_MARKET_OUTCOME";
+type TpSlThresholdType = "PERCENTAGE" | "DOLLAR" | "POSITION_VALUE" | "PRICE" | "PRICE_RATIO" | "WEIGHTED_RATIO";
 interface PairAssetInput {
     asset: string;
     weight?: number;
@@ -1013,6 +1101,9 @@ interface PairAssetInput {
 interface TpSlThresholdInput {
     type: TpSlThresholdType;
     value: number;
+    isTrailing?: boolean;
+    trailingDeltaValue?: number;
+    trailingActivationValue?: number;
 }
 interface LadderConfigInput {
     ratioStart: number;
@@ -1026,8 +1117,11 @@ interface CreatePositionRequestInput {
     usdValue: number;
     longAssets?: PairAssetInput[];
     shortAssets?: PairAssetInput[];
-    triggerValue?: number;
+    triggerValue?: string | number;
+    triggerType?: TriggerType;
     direction?: "MORE_THAN" | "LESS_THAN";
+    assetName?: string;
+    marketCode?: string;
     twapDuration?: number;
     twapIntervalSeconds?: number;
     randomizeExecution?: boolean;
@@ -1036,24 +1130,9 @@ interface CreatePositionRequestInput {
     takeProfit?: TpSlThresholdInput | null;
     stopLoss?: TpSlThresholdInput | null;
 }
-type PositionResponseStatus = "SUCCESS" | "FAILED" | "PENDING" | "PARTIALLY_FILLED" | "OPEN";
-interface PositionAssetSummaryDto {
-    asset: string;
-    side: "LONG" | "SHORT";
-    size: number;
-    entryRatio: number;
-    usdValue: number;
-    orderId: string;
-}
 interface CreatePositionResponseDto {
-    positionId: string | null;
     orderId: string;
-    status: PositionResponseStatus;
-    createdAt: string;
-    assets?: PositionAssetSummaryDto[];
-    stopLoss?: TpSlThresholdInput | null;
-    takeProfit?: TpSlThresholdInput | null;
-    hyperliquidResult?: any;
+    fills?: ExternalFillDto[];
 }
 /**
  * Create a position (MARKET/LIMIT/TWAP) using Pear Hyperliquid service
@@ -1282,6 +1361,23 @@ interface AllUserBalances {
 }
 declare const useAllUserBalances: () => AllUserBalances;
 
+interface UseHyperliquidUserFillsOptions {
+    baseUrl: string;
+    address: string | null;
+    aggregateByTime?: boolean;
+}
+interface UseHyperliquidUserFillsState {
+    lastRunAt: number | null;
+    lastResult: SyncFillsResponseDto | null;
+    error: string | null;
+    isSyncing: boolean;
+    handleUserFillsEvent: () => Promise<void>;
+}
+/**
+ * Provides a callback to sync user fills whenever the native WebSocket emits a userFills event.
+ */
+declare function useHyperliquidUserFills(options: UseHyperliquidUserFillsOptions): UseHyperliquidUserFillsState;
+
 interface UseHyperliquidWebSocketProps {
     wsUrl: string;
     address: string | null;
@@ -1296,12 +1392,13 @@ interface UseHyperliquidNativeWebSocketProps {
     address: string | null;
     tokens?: string[];
     enabled?: boolean;
+    onUserFills?: () => void | Promise<void>;
 }
 interface UseHyperliquidNativeWebSocketReturn {
     isConnected: boolean;
     lastError: string | null;
 }
-declare const useHyperliquidNativeWebSocket: ({ address, enabled, }: UseHyperliquidNativeWebSocketProps) => UseHyperliquidNativeWebSocketReturn;
+declare const useHyperliquidNativeWebSocket: ({ address, enabled, onUserFills, }: UseHyperliquidNativeWebSocketProps) => UseHyperliquidNativeWebSocketReturn;
 
 /**
  * Mark notifications as read up to a given timestamp (ms)
@@ -1318,6 +1415,93 @@ declare function markNotificationReadById(baseUrl: string, id: string): Promise<
 
 declare function toggleWatchlist(baseUrl: string, longAssets: WatchlistAssetDto[], shortAssets: WatchlistAssetDto[], hip3Assets: Map<string, string[]>): Promise<ApiResponse<ToggleWatchlistResponseDto>>;
 
+interface KalshiPriceRange {
+    start: string;
+    end: string;
+    step: string;
+}
+interface KalshiMveLeg {
+    event_ticker: string;
+    market_ticker: string;
+    side: string;
+}
+interface KalshiMarket {
+    ticker: string;
+    event_ticker: string;
+    market_type: 'binary' | string;
+    title: string;
+    subtitle: string;
+    yes_sub_title: string;
+    no_sub_title: string;
+    created_time: string;
+    open_time: string;
+    close_time: string;
+    expiration_time: string;
+    latest_expiration_time: string;
+    settlement_timer_seconds: number;
+    status: 'initialized' | 'open' | 'closed' | 'settled' | string;
+    response_price_units: 'usd_cent' | string;
+    yes_bid: number;
+    yes_bid_dollars: string;
+    yes_ask: number;
+    yes_ask_dollars: string;
+    no_bid: number;
+    no_bid_dollars: string;
+    no_ask: number;
+    no_ask_dollars: string;
+    last_price: number;
+    last_price_dollars: string;
+    volume: number;
+    volume_24h: number;
+    result: 'yes' | 'no' | null;
+    can_close_early: boolean;
+    open_interest: number;
+    notional_value: number;
+    notional_value_dollars: string;
+    previous_yes_bid: number;
+    previous_yes_bid_dollars: string;
+    previous_yes_ask: number;
+    previous_yes_ask_dollars: string;
+    previous_price: number;
+    previous_price_dollars: string;
+    liquidity: number;
+    liquidity_dollars: string;
+    expiration_value: string;
+    tick_size: number;
+    rules_primary: string;
+    rules_secondary: string;
+    price_level_structure: string;
+    price_ranges: KalshiPriceRange[];
+    expected_expiration_time: string;
+    settlement_value: number;
+    settlement_value_dollars: string;
+    settlement_ts: string;
+    fee_waiver_expiration_time: string;
+    early_close_condition: string;
+    strike_type: 'greater' | 'less' | 'between' | string;
+    floor_strike: number;
+    cap_strike: number;
+    functional_strike: string;
+    custom_strike: Record<string, unknown>;
+    mve_collection_ticker: string;
+    mve_selected_legs: KalshiMveLeg[];
+    primary_participant_key: string;
+    is_provisional: boolean;
+}
+interface KalshiMarketsResponse {
+    markets: KalshiMarket[];
+    cursor: string;
+}
+interface GetKalshiMarketsParams {
+    limit?: number;
+    cursor?: string;
+    tickers?: string[];
+    event_ticker?: string;
+    series_ticker?: string;
+    status?: string;
+}
+declare function getKalshiMarkets(params?: GetKalshiMarketsParams): Promise<ApiResponse<KalshiMarketsResponse>>;
+
 /**
  * Account summary calculation utility class
  */
@@ -1521,6 +1705,63 @@ declare function getMarketPrefix(fullSymbol: string): string | undefined;
  */
 declare function isHip3Market(symbol: string): boolean;
 
+/**
+ * Helper functions to safely extract values from order parameters
+ * based on the order type and parameter structure.
+ */
+/**
+ * Get leverage from order parameters (available for Market, Trigger, Twap, Ladder orders)
+ */
+declare function getOrderLeverage(order: OpenLimitOrderDto): number | undefined;
+/**
+ * Get USD value from order parameters (available for Market, Trigger, Twap, Ladder orders)
+ */
+declare function getOrderUsdValue(order: OpenLimitOrderDto): number | undefined;
+/**
+ * Get trigger value from order parameters (available for TP/SL and Trigger orders)
+ */
+declare function getOrderTriggerValue(order: OpenLimitOrderDto): number | undefined;
+/**
+ * Get TP/SL trigger type from order parameters (only for TP/SL orders)
+ */
+declare function getOrderTpSlTriggerType(order: OpenLimitOrderDto): TpSlTriggerType | undefined;
+/**
+ * Get trigger type from order parameters (for Trigger orders)
+ */
+declare function getOrderTriggerType(order: OpenLimitOrderDto): TriggerType$1 | undefined;
+/**
+ * Get order direction from order parameters (for Trigger orders)
+ */
+declare function getOrderDirection(order: OpenLimitOrderDto): OrderDirection | undefined;
+/**
+ * Get reduce only flag from order parameters (available for all order types)
+ */
+declare function getOrderReduceOnly(order: OpenLimitOrderDto): boolean;
+/**
+ * Get TWAP duration from order parameters (only for TWAP orders)
+ */
+declare function getOrderTwapDuration(order: OpenLimitOrderDto): string | undefined;
+/**
+ * Get ladder config from order parameters (only for Ladder orders)
+ */
+declare function getOrderLadderConfig(order: OpenLimitOrderDto): {
+    ratioStart: number;
+    ratioEnd: number;
+    numberOfLevels: number;
+} | undefined;
+/**
+ * Check if the order is a BTC Dominance trigger order
+ */
+declare function isBtcDomOrder(order: OpenLimitOrderDto): boolean;
+/**
+ * Get trailing info from TP/SL order parameters
+ */
+declare function getOrderTrailingInfo(order: OpenLimitOrderDto): {
+    isTrailing: boolean;
+    trailingDeltaValue?: number;
+    trailingActivationValue?: number;
+} | undefined;
+
 interface MarketDataState {
     marketData: ActiveAssetsResponse | null;
     marketDataAll: ActiveAssetsAllResponse | null;
@@ -1530,5 +1771,5 @@ interface MarketDataState {
 }
 declare const useMarketData: zustand.UseBoundStore<zustand.StoreApi<MarketDataState>>;
 
-export { AccountSummaryCalculator, ConflictDetector, MAX_ASSETS_PER_LEG, MINIMUM_ASSET_USD_VALUE, MaxAssetsPerLegError, MinimumPositionSizeError, PearHyperliquidProvider, TokenMetadataExtractor, adjustAdvancePosition, adjustOrder, adjustPosition, calculateMinimumPositionValue, calculateWeightedRatio, cancelOrder, cancelTwap, cancelTwapOrder, closeAllPositions, closePosition, computeBasketCandles, createCandleLookups, createPosition, executeSpotOrder, getAvailableMarkets, getCompleteTimestamps, getMarketPrefix, getPortfolio, isHip3Market, mapCandleIntervalToTradingViewInterval, mapTradingViewIntervalToCandleInterval, markNotificationReadById, markNotificationsRead, toBackendSymbol, toBackendSymbolWithMarket, toDisplaySymbol, toggleWatchlist, updateLeverage, updateRiskParameters, useAccountSummary, useActiveBaskets, useAgentWallet, useAllBaskets, useAllUserBalances, useAuth, useAutoSyncFills, useBasketCandles, useFindBasket, useHighlightedBaskets, useHistoricalPriceData, useHistoricalPriceDataStore, useHyperliquidNativeWebSocket, useHyperliquidWebSocket, useMarketData, useMarketDataAllPayload, useMarketDataPayload, useNotifications, useOpenOrders, useOrders, usePearHyperliquid, usePerformanceOverlays, usePerpMetaAssets, usePortfolio, usePosition, useSpotOrder, useTokenSelectionMetadata, useTopGainers, useTopLosers, useTradeHistories, useTwap, useUserSelection, useWatchlist, useWatchlistBaskets, useWebData, validateMaxAssetsPerLeg, validateMinimumAssetSize, validatePositionSize };
-export type { AccountSummaryResponseDto, ActiveAssetGroupItem, ActiveAssetsResponse, AdjustAdvanceAssetInput, AdjustAdvanceItemInput, AdjustAdvanceResponseDto, AdjustExecutionType, AdjustOrderRequestInput, AdjustOrderResponseDto, AdjustPositionRequestInput, AdjustPositionResponseDto, AgentWalletDto, AgentWalletState, ApiErrorResponse, ApiResponse, AssetCtx, AssetInformationDetail, AssetMarketData, AssetPosition, AutoSyncFillsOptions, AutoSyncFillsState, BalanceSummaryDto, CancelOrderResponseDto, CancelTwapResponseDto, CandleChartData, CandleData, CandleInterval, CandleSnapshotRequest, ClearinghouseState, CloseAllPositionsResponseDto, CloseAllPositionsResultDto, CloseExecutionType, ClosePositionRequestInput, ClosePositionResponseDto, CollateralFilter, CollateralToken, CreatePositionRequestInput, CreatePositionResponseDto, CrossMarginSummaryDto, CumFundingDto, ExecutionType, ExtraAgent, HLWebSocketResponse, HistoricalRange, LadderConfigInput, MarginSummaryDto, MarketDataBySymbol, NotificationCategory, NotificationDto, OpenLimitOrderDto, OpenPositionDto, OrderAssetDto, OrderStatus, PairAssetDto, PairAssetInput, PerformanceOverlay, PlatformAccountSummaryResponseDto, PortfolioBucketDto, PortfolioInterval, PortfolioIntervalsDto, PortfolioOverallDto, PortfolioResponseDto, PositionAdjustmentType, PositionAssetDetailDto, PositionAssetSummaryDto, PositionResponseStatus, RealtimeBar, RealtimeBarsCallback, SpotBalance, SpotOrderFilledStatus, SpotOrderHyperliquidData, SpotOrderHyperliquidResult, SpotOrderRequestInput, SpotOrderResponseDto, SpotState, ToggleWatchlistResponseDto, TokenConflict, TokenHistoricalPriceData, TokenMetadata, TokenSelection, TpSlThresholdInput, TpSlThresholdType, TradeHistoryAssetDataDto, TradeHistoryDataDto, TwapChunkStatusDto, TwapMonitoringDto, TwapSliceFillResponseItem, UniverseAsset, UpdateLeverageRequestInput, UpdateLeverageResponseDto, UpdateRiskParametersRequestInput, UpdateRiskParametersResponseDto, UseAuthOptions, UseBasketCandlesReturn, UseHistoricalPriceDataReturn, UseNotificationsResult, UsePerformanceOverlaysReturn, UsePortfolioResult, UseSpotOrderResult, UseTokenSelectionMetadataReturn, UserProfile, UserSelectionState, WatchlistItemDto, WebSocketAckResponse, WebSocketChannel, WebSocketConnectionState, WebSocketDataMessage, WebSocketMessage, WebSocketSubscribeMessage, WsAllMidsData };
+export { AccountSummaryCalculator, ConflictDetector, MAX_ASSETS_PER_LEG, MINIMUM_ASSET_USD_VALUE, MaxAssetsPerLegError, MinimumPositionSizeError, PearHyperliquidProvider, TokenMetadataExtractor, adjustAdvancePosition, adjustOrder, adjustPosition, calculateMinimumPositionValue, calculateWeightedRatio, cancelOrder, cancelTwap, cancelTwapOrder, closeAllPositions, closePosition, computeBasketCandles, createCandleLookups, createPosition, executeSpotOrder, getAvailableMarkets, getCompleteTimestamps, getKalshiMarkets, getMarketPrefix, getOrderDirection, getOrderLadderConfig, getOrderLeverage, getOrderReduceOnly, getOrderTpSlTriggerType, getOrderTrailingInfo, getOrderTriggerType, getOrderTriggerValue, getOrderTwapDuration, getOrderUsdValue, getPortfolio, isBtcDomOrder, isHip3Market, mapCandleIntervalToTradingViewInterval, mapTradingViewIntervalToCandleInterval, markNotificationReadById, markNotificationsRead, toBackendSymbol, toBackendSymbolWithMarket, toDisplaySymbol, toggleWatchlist, updateLeverage, updateRiskParameters, useAccountSummary, useActiveBaskets, useAgentWallet, useAllBaskets, useAllUserBalances, useAuth, useBasketCandles, useFindBasket, useHighlightedBaskets, useHistoricalPriceData, useHistoricalPriceDataStore, useHyperliquidNativeWebSocket, useHyperliquidUserFills, useHyperliquidWebSocket, useMarketData, useMarketDataAllPayload, useMarketDataPayload, useNotifications, useOpenOrders, useOrders, usePearHyperliquid, usePerformanceOverlays, usePerpMetaAssets, usePortfolio, usePosition, useSpotOrder, useTokenSelectionMetadata, useTopGainers, useTopLosers, useTradeHistories, useTwap, useUserSelection, useWatchlist, useWatchlistBaskets, useWebData, validateMaxAssetsPerLeg, validateMinimumAssetSize, validatePositionSize };
+export type { AccountSummaryResponseDto, ActiveAssetGroupItem, ActiveAssetsResponse, AdjustAdvanceAssetInput, AdjustAdvanceItemInput, AdjustAdvanceResponseDto, AdjustExecutionType, AdjustOrderRequestInput, AdjustOrderResponseDto, AdjustPositionRequestInput, AdjustPositionResponseDto, AgentWalletDto, AgentWalletState, ApiErrorResponse, ApiResponse, AssetCtx, AssetInformationDetail, AssetMarketData, AssetPosition, BalanceSummaryDto, BaseTriggerOrderNotificationParams, BtcDomTriggerParams, CancelOrderResponseDto, CancelTwapResponseDto, CandleChartData, CandleData, CandleInterval, CandleSnapshotRequest, ClearinghouseState, CloseAllPositionsResponseDto, CloseAllPositionsResultDto, CloseExecutionType, ClosePositionRequestInput, ClosePositionResponseDto, CollateralFilter, CollateralToken, CreatePositionRequestInput, CreatePositionResponseDto, CrossAssetPriceTriggerParams, CrossMarginSummaryDto, CumFundingDto, ExecutionType, ExtraAgent, GetKalshiMarketsParams, HLWebSocketResponse, HistoricalRange, KalshiMarket, KalshiMarketsResponse, KalshiMveLeg, KalshiPriceRange, LadderConfigInput, MarginSummaryDto, MarketDataBySymbol, NotificationCategory, NotificationDto, OpenLimitOrderDto, OpenPositionDto, OrderAssetDto, OrderStatus, PairAssetDto, PairAssetInput, PerformanceOverlay, PlatformAccountSummaryResponseDto, PortfolioBucketDto, PortfolioInterval, PortfolioIntervalsDto, PortfolioOverallDto, PortfolioResponseDto, PositionAdjustmentType, PositionAssetDetailDto, PredictionMarketOutcomeTriggerParams, PriceRatioTriggerParams, PriceTriggerParams, RealtimeBar, RealtimeBarsCallback, SpotBalance, SpotOrderFilledStatus, SpotOrderHyperliquidData, SpotOrderHyperliquidResult, SpotOrderRequestInput, SpotOrderResponseDto, SpotState, ToggleWatchlistResponseDto, TokenConflict, TokenHistoricalPriceData, TokenMetadata, TokenSelection, TpSlOrderParameters, TpSlThresholdInput, TpSlThresholdType, TpSlTriggerType, TradeHistoryAssetDataDto, TradeHistoryDataDto, TriggerOrderNotificationAsset, TriggerOrderNotificationParams, TriggerOrderNotificationType, TriggerOrderParameters, TriggerType, TwapChunkStatusDto, TwapMonitoringDto, TwapSliceFillResponseItem, UniverseAsset, UpdateLeverageRequestInput, UpdateLeverageResponseDto, UpdateRiskParametersRequestInput, UpdateRiskParametersResponseDto, UseAuthOptions, UseBasketCandlesReturn, UseHistoricalPriceDataReturn, UseHyperliquidUserFillsOptions, UseHyperliquidUserFillsState, UseNotificationsResult, UsePerformanceOverlaysReturn, UsePortfolioResult, UseSpotOrderResult, UseTokenSelectionMetadataReturn, UserProfile, UserSelectionState, WatchlistItemDto, WebSocketAckResponse, WebSocketChannel, WebSocketConnectionState, WebSocketDataMessage, WebSocketMessage, WebSocketSubscribeMessage, WsAllMidsData };