@pungoyal/kite-cli 0.1.0

package/dist/core/api.d.ts

@@ -0,0 +1,843 @@
+import type { KiteClient } from './client.js';
+import { type Candle } from './schemas.js';
+/**
+ * Typed wrappers over the Kite Connect v3 endpoints.
+ *
+ * Batching and range-chunking live here rather than in commands, so every
+ * caller gets the rate-limit-aware behaviour automatically.
+ */
+export type Variety = 'regular' | 'amo' | 'co' | 'iceberg' | 'auction';
+export type TransactionType = 'BUY' | 'SELL';
+export type OrderType = 'MARKET' | 'LIMIT' | 'SL' | 'SL-M';
+export type Product = 'CNC' | 'NRML' | 'MIS' | 'MTF';
+export type Validity = 'DAY' | 'IOC' | 'TTL';
+export type Exchange = 'NSE' | 'BSE' | 'NFO' | 'CDS' | 'BCD' | 'MCX' | 'BFO';
+export declare const VARIETIES: Variety[];
+export declare const ORDER_TYPES: OrderType[];
+export declare const PRODUCTS: Product[];
+export declare const VALIDITIES: Validity[];
+export declare const EXCHANGES: Exchange[];
+export interface PlaceOrderParams {
+    variety: Variety;
+    tradingsymbol: string;
+    exchange: Exchange | string;
+    transaction_type: TransactionType;
+    order_type: OrderType;
+    quantity: number;
+    product: Product;
+    price?: number | undefined;
+    trigger_price?: number | undefined;
+    disclosed_quantity?: number | undefined;
+    validity?: Validity | undefined;
+    validity_ttl?: number | undefined;
+    iceberg_legs?: number | undefined;
+    iceberg_quantity?: number | undefined;
+    auction_number?: string | undefined;
+    market_protection?: number | undefined;
+    /**
+     * Client correlation ID, max 20 alphanumeric chars. This CLI always sets one:
+     * it is the only way to reconcile after a network failure, because Kite has
+     * no idempotency key.
+     */
+    tag?: string | undefined;
+}
+export interface ModifyOrderParams {
+    variety: Variety;
+    order_id: string;
+    quantity?: number | undefined;
+    price?: number | undefined;
+    trigger_price?: number | undefined;
+    order_type?: OrderType | undefined;
+    disclosed_quantity?: number | undefined;
+    validity?: Validity | undefined;
+}
+export declare class KiteApi {
+    private readonly client;
+    constructor(client: KiteClient);
+    /** Exchange a request_token for an access_token. */
+    createSession(params: {
+        requestToken: string;
+        checksum: string;
+    }): Promise<{
+        [x: string]: unknown;
+        user_id: string;
+        exchanges: string[];
+        products: string[];
+        order_types: string[];
+        access_token: string;
+        user_name?: string | undefined;
+        user_shortname?: string | undefined;
+        email?: string | undefined;
+        user_type?: string | undefined;
+        broker?: string | undefined;
+        public_token?: string | undefined;
+        refresh_token?: string | undefined;
+        login_time?: string | undefined;
+    }>;
+    invalidateSession(accessToken: string): Promise<unknown>;
+    getProfile(signal?: AbortSignal): Promise<{
+        [x: string]: unknown;
+        user_id: string;
+        exchanges: string[];
+        products: string[];
+        order_types: string[];
+        user_name?: string | undefined;
+        user_shortname?: string | undefined;
+        email?: string | undefined;
+        user_type?: string | undefined;
+        broker?: string | undefined;
+    }>;
+    getMargins(signal?: AbortSignal): Promise<{
+        [x: string]: unknown;
+        equity?: {
+            [x: string]: unknown;
+            enabled?: boolean | undefined;
+            net?: number | undefined;
+            available?: {
+                [x: string]: unknown;
+                cash?: number | undefined;
+                opening_balance?: number | undefined;
+                live_balance?: number | undefined;
+                intraday_payin?: number | undefined;
+                adhoc_margin?: number | undefined;
+                collateral?: number | undefined;
+            } | undefined;
+            utilised?: {
+                [x: string]: unknown;
+                debits?: number | undefined;
+                exposure?: number | undefined;
+                m2m_realised?: number | undefined;
+                m2m_unrealised?: number | undefined;
+                option_premium?: number | undefined;
+                payout?: number | undefined;
+                span?: number | undefined;
+                holding_sales?: number | undefined;
+                turnover?: number | undefined;
+                liquid_collateral?: number | undefined;
+                stock_collateral?: number | undefined;
+                delivery?: number | undefined;
+            } | undefined;
+        } | undefined;
+        commodity?: {
+            [x: string]: unknown;
+            enabled?: boolean | undefined;
+            net?: number | undefined;
+            available?: {
+                [x: string]: unknown;
+                cash?: number | undefined;
+                opening_balance?: number | undefined;
+                live_balance?: number | undefined;
+                intraday_payin?: number | undefined;
+                adhoc_margin?: number | undefined;
+                collateral?: number | undefined;
+            } | undefined;
+            utilised?: {
+                [x: string]: unknown;
+                debits?: number | undefined;
+                exposure?: number | undefined;
+                m2m_realised?: number | undefined;
+                m2m_unrealised?: number | undefined;
+                option_premium?: number | undefined;
+                payout?: number | undefined;
+                span?: number | undefined;
+                holding_sales?: number | undefined;
+                turnover?: number | undefined;
+                liquid_collateral?: number | undefined;
+                stock_collateral?: number | undefined;
+                delivery?: number | undefined;
+            } | undefined;
+        } | undefined;
+    }>;
+    getOrders(signal?: AbortSignal): Promise<{
+        [x: string]: unknown;
+        order_id: string;
+        status: string;
+        parent_order_id?: string | null | undefined;
+        exchange_order_id?: string | null | undefined;
+        status_message?: string | null | undefined;
+        status_message_raw?: string | null | undefined;
+        order_timestamp?: string | null | undefined;
+        exchange_timestamp?: string | null | undefined;
+        exchange_update_timestamp?: string | null | undefined;
+        variety?: string | undefined;
+        exchange?: string | undefined;
+        tradingsymbol?: string | undefined;
+        instrument_token?: number | undefined;
+        transaction_type?: string | undefined;
+        order_type?: string | undefined;
+        product?: string | undefined;
+        validity?: string | undefined;
+        price?: number | undefined;
+        quantity?: number | undefined;
+        trigger_price?: number | undefined;
+        average_price?: number | undefined;
+        pending_quantity?: number | undefined;
+        filled_quantity?: number | undefined;
+        disclosed_quantity?: number | undefined;
+        cancelled_quantity?: number | undefined;
+        tag?: string | null | undefined;
+        tags?: string[] | null | undefined;
+        placed_by?: string | undefined;
+        guid?: string | null | undefined;
+    }[]>;
+    /** Returns the full state history of one order, oldest first. */
+    getOrderHistory(orderId: string, signal?: AbortSignal): Promise<{
+        [x: string]: unknown;
+        order_id: string;
+        status: string;
+        parent_order_id?: string | null | undefined;
+        exchange_order_id?: string | null | undefined;
+        status_message?: string | null | undefined;
+        status_message_raw?: string | null | undefined;
+        order_timestamp?: string | null | undefined;
+        exchange_timestamp?: string | null | undefined;
+        exchange_update_timestamp?: string | null | undefined;
+        variety?: string | undefined;
+        exchange?: string | undefined;
+        tradingsymbol?: string | undefined;
+        instrument_token?: number | undefined;
+        transaction_type?: string | undefined;
+        order_type?: string | undefined;
+        product?: string | undefined;
+        validity?: string | undefined;
+        price?: number | undefined;
+        quantity?: number | undefined;
+        trigger_price?: number | undefined;
+        average_price?: number | undefined;
+        pending_quantity?: number | undefined;
+        filled_quantity?: number | undefined;
+        disclosed_quantity?: number | undefined;
+        cancelled_quantity?: number | undefined;
+        tag?: string | null | undefined;
+        tags?: string[] | null | undefined;
+        placed_by?: string | undefined;
+        guid?: string | null | undefined;
+    }[]>;
+    getTrades(signal?: AbortSignal): Promise<{
+        [x: string]: unknown;
+        trade_id: string;
+        order_id: string;
+        exchange_order_id?: string | null | undefined;
+        tradingsymbol?: string | undefined;
+        exchange?: string | undefined;
+        instrument_token?: number | undefined;
+        transaction_type?: string | undefined;
+        product?: string | undefined;
+        average_price?: number | undefined;
+        quantity?: number | undefined;
+        fill_timestamp?: string | null | undefined;
+        exchange_timestamp?: string | null | undefined;
+        order_timestamp?: string | null | undefined;
+    }[]>;
+    getOrderTrades(orderId: string, signal?: AbortSignal): Promise<{
+        [x: string]: unknown;
+        trade_id: string;
+        order_id: string;
+        exchange_order_id?: string | null | undefined;
+        tradingsymbol?: string | undefined;
+        exchange?: string | undefined;
+        instrument_token?: number | undefined;
+        transaction_type?: string | undefined;
+        product?: string | undefined;
+        average_price?: number | undefined;
+        quantity?: number | undefined;
+        fill_timestamp?: string | null | undefined;
+        exchange_timestamp?: string | null | undefined;
+        order_timestamp?: string | null | undefined;
+    }[]>;
+    /**
+     * Place an order.
+     *
+     * This is never retried automatically anywhere in the stack. If it fails at
+     * the network level the caller must reconcile via `findOrderByTag`, because
+     * a timed-out request may still have been executed.
+     */
+    placeOrder(params: PlaceOrderParams, signal?: AbortSignal): Promise<{
+        [x: string]: unknown;
+        order_id: string;
+    } | ({
+        [x: string]: unknown;
+        order_id: string;
+    } | {
+        [x: string]: unknown;
+        error: {
+            [x: string]: unknown;
+            code?: number | undefined;
+            error_type?: string | undefined;
+            message?: string | undefined;
+        };
+    })[]>;
+    modifyOrder(params: ModifyOrderParams, signal?: AbortSignal): Promise<{
+        [x: string]: unknown;
+        order_id: string;
+    }>;
+    cancelOrder(params: {
+        variety: Variety;
+        order_id: string;
+        parent_order_id?: string;
+    }, signal?: AbortSignal): Promise<{
+        [x: string]: unknown;
+        order_id: string;
+    }>;
+    /**
+     * Reconciliation helper for the no-idempotency problem.
+     *
+     * Kite has no client-suppliable idempotency key (the `guid` field in the
+     * response is server-assigned, despite its confusing description). Zerodha's
+     * own guidance for a failed/timed-out placement is: do NOT retry — fetch the
+     * orderbook and look for your tag. Only place again if it is absent.
+     */
+    findOrderByTag(tag: string, signal?: AbortSignal): Promise<{
+        [x: string]: unknown;
+        order_id: string;
+        status: string;
+        parent_order_id?: string | null | undefined;
+        exchange_order_id?: string | null | undefined;
+        status_message?: string | null | undefined;
+        status_message_raw?: string | null | undefined;
+        order_timestamp?: string | null | undefined;
+        exchange_timestamp?: string | null | undefined;
+        exchange_update_timestamp?: string | null | undefined;
+        variety?: string | undefined;
+        exchange?: string | undefined;
+        tradingsymbol?: string | undefined;
+        instrument_token?: number | undefined;
+        transaction_type?: string | undefined;
+        order_type?: string | undefined;
+        product?: string | undefined;
+        validity?: string | undefined;
+        price?: number | undefined;
+        quantity?: number | undefined;
+        trigger_price?: number | undefined;
+        average_price?: number | undefined;
+        pending_quantity?: number | undefined;
+        filled_quantity?: number | undefined;
+        disclosed_quantity?: number | undefined;
+        cancelled_quantity?: number | undefined;
+        tag?: string | null | undefined;
+        tags?: string[] | null | undefined;
+        placed_by?: string | undefined;
+        guid?: string | null | undefined;
+    }[]>;
+    getGtts(signal?: AbortSignal): Promise<{
+        [x: string]: unknown;
+        id: number;
+        type: string;
+        status: string;
+        condition: {
+            [x: string]: unknown;
+            exchange: string;
+            tradingsymbol: string;
+            trigger_values: number[];
+            last_price?: number | undefined;
+            instrument_token?: number | undefined;
+        };
+        orders: {
+            [x: string]: unknown;
+            exchange?: string | undefined;
+            tradingsymbol?: string | undefined;
+            product?: string | undefined;
+            order_type?: string | undefined;
+            transaction_type?: string | undefined;
+            quantity?: number | undefined;
+            price?: number | undefined;
+            result?: unknown;
+        }[];
+        user_id?: string | undefined;
+        parent_trigger?: unknown;
+        created_at?: string | undefined;
+        updated_at?: string | undefined;
+        expires_at?: string | undefined;
+    }[]>;
+    getGtt(id: number, signal?: AbortSignal): Promise<{
+        [x: string]: unknown;
+        id: number;
+        type: string;
+        status: string;
+        condition: {
+            [x: string]: unknown;
+            exchange: string;
+            tradingsymbol: string;
+            trigger_values: number[];
+            last_price?: number | undefined;
+            instrument_token?: number | undefined;
+        };
+        orders: {
+            [x: string]: unknown;
+            exchange?: string | undefined;
+            tradingsymbol?: string | undefined;
+            product?: string | undefined;
+            order_type?: string | undefined;
+            transaction_type?: string | undefined;
+            quantity?: number | undefined;
+            price?: number | undefined;
+            result?: unknown;
+        }[];
+        user_id?: string | undefined;
+        parent_trigger?: unknown;
+        created_at?: string | undefined;
+        updated_at?: string | undefined;
+        expires_at?: string | undefined;
+    }>;
+    placeGtt(params: GttParams, signal?: AbortSignal): Promise<{
+        [x: string]: unknown;
+        trigger_id: number;
+    }>;
+    modifyGtt(id: number, params: GttParams, signal?: AbortSignal): Promise<{
+        [x: string]: unknown;
+        trigger_id: number;
+    }>;
+    deleteGtt(id: number, signal?: AbortSignal): Promise<{
+        [x: string]: unknown;
+        trigger_id: number;
+    }>;
+    getHoldings(signal?: AbortSignal): Promise<{
+        [x: string]: unknown;
+        tradingsymbol: string;
+        exchange: string;
+        quantity: number;
+        t1_quantity: number;
+        realised_quantity: number;
+        opening_quantity: number;
+        collateral_quantity: number;
+        authorised_quantity: number;
+        average_price: number;
+        last_price: number;
+        close_price: number;
+        pnl: number;
+        day_change: number;
+        day_change_percentage: number;
+        instrument_token?: number | undefined;
+        isin?: string | undefined;
+        product?: string | undefined;
+    }[]>;
+    getPositions(signal?: AbortSignal): Promise<{
+        [x: string]: unknown;
+        net: {
+            [x: string]: unknown;
+            tradingsymbol: string;
+            exchange: string;
+            quantity: number;
+            overnight_quantity: number;
+            multiplier: number;
+            average_price: number;
+            close_price: number;
+            last_price: number;
+            value: number;
+            pnl: number;
+            m2m: number;
+            unrealised: number;
+            realised: number;
+            buy_quantity: number;
+            buy_price: number;
+            buy_value: number;
+            sell_quantity: number;
+            sell_price: number;
+            sell_value: number;
+            day_buy_quantity: number;
+            day_sell_quantity: number;
+            instrument_token?: number | undefined;
+            product?: string | undefined;
+        }[];
+        day: {
+            [x: string]: unknown;
+            tradingsymbol: string;
+            exchange: string;
+            quantity: number;
+            overnight_quantity: number;
+            multiplier: number;
+            average_price: number;
+            close_price: number;
+            last_price: number;
+            value: number;
+            pnl: number;
+            m2m: number;
+            unrealised: number;
+            realised: number;
+            buy_quantity: number;
+            buy_price: number;
+            buy_value: number;
+            sell_quantity: number;
+            sell_price: number;
+            sell_value: number;
+            day_buy_quantity: number;
+            day_sell_quantity: number;
+            instrument_token?: number | undefined;
+            product?: string | undefined;
+        }[];
+    }>;
+    getAuctions(signal?: AbortSignal): Promise<{
+        [x: string]: unknown;
+        tradingsymbol: string;
+        exchange: string;
+        instrument_token?: number | undefined;
+        auction_number?: string | undefined;
+        quantity?: number | undefined;
+        last_price?: number | undefined;
+    }[]>;
+    /** Convert a position between products. Note this is PUT, not POST. */
+    convertPosition(params: {
+        tradingsymbol: string;
+        exchange: string;
+        transaction_type: TransactionType;
+        position_type: 'overnight' | 'day';
+        quantity: number;
+        old_product: Product;
+        new_product: Product;
+    }, signal?: AbortSignal): Promise<unknown>;
+    /**
+     * Initiate CDSL authorisation for selling holdings — the HTTP 428 recovery
+     * path.
+     *
+     * With no ISINs this authorises the whole demat account; with ISINs it
+     * authorises only those instruments. The client encodes an array as repeated
+     * `isin` form fields, which is the shape Kite expects.
+     */
+    authoriseHoldings(isins?: string[], signal?: AbortSignal): Promise<{
+        [x: string]: unknown;
+        request_id: string;
+    }>;
+    /** Browser URL the user must visit to complete a holdings authorisation. */
+    authorisationUrl(requestId: string): string;
+    /**
+     * Full quotes. Kite caps this at 500 instruments per call and 1 request per
+     * second, so large lists are chunked and paced by the limiter.
+     */
+    getQuote(instruments: string[], signal?: AbortSignal): Promise<Record<string, {
+        [x: string]: unknown;
+        instrument_token: number;
+        last_price: number;
+        timestamp?: string | null | undefined;
+        last_trade_time?: string | null | undefined;
+        last_quantity?: number | undefined;
+        buy_quantity?: number | undefined;
+        sell_quantity?: number | undefined;
+        volume?: number | undefined;
+        average_price?: number | undefined;
+        oi?: number | undefined;
+        oi_day_high?: number | undefined;
+        oi_day_low?: number | undefined;
+        net_change?: number | undefined;
+        lower_circuit_limit?: number | undefined;
+        upper_circuit_limit?: number | undefined;
+        ohlc?: {
+            [x: string]: unknown;
+            open: number;
+            high: number;
+            low: number;
+            close: number;
+        } | undefined;
+        depth?: {
+            [x: string]: unknown;
+            buy: {
+                [x: string]: unknown;
+                price: number;
+                quantity: number;
+                orders: number;
+            }[];
+            sell: {
+                [x: string]: unknown;
+                price: number;
+                quantity: number;
+                orders: number;
+            }[];
+        } | undefined;
+    }>>;
+    /** OHLC + last price. Caps at 1000 instruments per call. */
+    getOhlc(instruments: string[], signal?: AbortSignal): Promise<Record<string, {
+        [x: string]: unknown;
+        instrument_token: number;
+        last_price: number;
+        ohlc?: {
+            [x: string]: unknown;
+            open: number;
+            high: number;
+            low: number;
+            close: number;
+        } | undefined;
+    }>>;
+    /** Last traded price only. Caps at 1000 instruments per call. */
+    getLtp(instruments: string[], signal?: AbortSignal): Promise<Record<string, {
+        [x: string]: unknown;
+        instrument_token: number;
+        last_price: number;
+    }>>;
+    private batchedQuote;
+    /**
+     * Historical candles, transparently chunked to respect per-interval range
+     * limits, then merged and de-duplicated.
+     */
+    getHistorical(params: {
+        instrument_token: number;
+        interval: HistoricalInterval;
+        from: Date;
+        to: Date;
+        continuous?: boolean;
+        oi?: boolean;
+    }, signal?: AbortSignal): Promise<Candle[]>;
+    /** The daily instrument dump as raw CSV. Not an API envelope. */
+    getInstrumentsCsv(exchange?: string, signal?: AbortSignal): Promise<string>;
+    orderMargins(orders: unknown[], signal?: AbortSignal): Promise<{
+        [x: string]: unknown;
+        type?: string | undefined;
+        tradingsymbol?: string | undefined;
+        exchange?: string | undefined;
+        span?: number | undefined;
+        exposure?: number | undefined;
+        option_premium?: number | undefined;
+        additional?: number | undefined;
+        bo?: number | undefined;
+        cash?: number | undefined;
+        var?: number | undefined;
+        total?: number | undefined;
+        leverage?: number | undefined;
+        charges?: {
+            [x: string]: unknown;
+            transaction_tax?: number | undefined;
+            transaction_tax_type?: string | undefined;
+            exchange_turnover_charge?: number | undefined;
+            sebi_turnover_charge?: number | undefined;
+            brokerage?: number | undefined;
+            stamp_duty?: number | undefined;
+            total?: number | undefined;
+            gst?: {
+                [x: string]: unknown;
+                igst?: number | undefined;
+                cgst?: number | undefined;
+                sgst?: number | undefined;
+                total?: number | undefined;
+            } | undefined;
+        } | undefined;
+        pnl?: {
+            [x: string]: unknown;
+            realised?: number | undefined;
+            unrealised?: number | undefined;
+        } | undefined;
+    }[]>;
+    basketMargins(orders: unknown[], considerPositions?: boolean, signal?: AbortSignal): Promise<{
+        [x: string]: unknown;
+        orders: {
+            [x: string]: unknown;
+            type?: string | undefined;
+            tradingsymbol?: string | undefined;
+            exchange?: string | undefined;
+            span?: number | undefined;
+            exposure?: number | undefined;
+            option_premium?: number | undefined;
+            additional?: number | undefined;
+            bo?: number | undefined;
+            cash?: number | undefined;
+            var?: number | undefined;
+            total?: number | undefined;
+            leverage?: number | undefined;
+            charges?: {
+                [x: string]: unknown;
+                transaction_tax?: number | undefined;
+                transaction_tax_type?: string | undefined;
+                exchange_turnover_charge?: number | undefined;
+                sebi_turnover_charge?: number | undefined;
+                brokerage?: number | undefined;
+                stamp_duty?: number | undefined;
+                total?: number | undefined;
+                gst?: {
+                    [x: string]: unknown;
+                    igst?: number | undefined;
+                    cgst?: number | undefined;
+                    sgst?: number | undefined;
+                    total?: number | undefined;
+                } | undefined;
+            } | undefined;
+            pnl?: {
+                [x: string]: unknown;
+                realised?: number | undefined;
+                unrealised?: number | undefined;
+            } | undefined;
+        }[];
+        initial?: {
+            [x: string]: unknown;
+            type?: string | undefined;
+            tradingsymbol?: string | undefined;
+            exchange?: string | undefined;
+            span?: number | undefined;
+            exposure?: number | undefined;
+            option_premium?: number | undefined;
+            additional?: number | undefined;
+            bo?: number | undefined;
+            cash?: number | undefined;
+            var?: number | undefined;
+            total?: number | undefined;
+            leverage?: number | undefined;
+            charges?: {
+                [x: string]: unknown;
+                transaction_tax?: number | undefined;
+                transaction_tax_type?: string | undefined;
+                exchange_turnover_charge?: number | undefined;
+                sebi_turnover_charge?: number | undefined;
+                brokerage?: number | undefined;
+                stamp_duty?: number | undefined;
+                total?: number | undefined;
+                gst?: {
+                    [x: string]: unknown;
+                    igst?: number | undefined;
+                    cgst?: number | undefined;
+                    sgst?: number | undefined;
+                    total?: number | undefined;
+                } | undefined;
+            } | undefined;
+            pnl?: {
+                [x: string]: unknown;
+                realised?: number | undefined;
+                unrealised?: number | undefined;
+            } | undefined;
+        } | undefined;
+        final?: {
+            [x: string]: unknown;
+            type?: string | undefined;
+            tradingsymbol?: string | undefined;
+            exchange?: string | undefined;
+            span?: number | undefined;
+            exposure?: number | undefined;
+            option_premium?: number | undefined;
+            additional?: number | undefined;
+            bo?: number | undefined;
+            cash?: number | undefined;
+            var?: number | undefined;
+            total?: number | undefined;
+            leverage?: number | undefined;
+            charges?: {
+                [x: string]: unknown;
+                transaction_tax?: number | undefined;
+                transaction_tax_type?: string | undefined;
+                exchange_turnover_charge?: number | undefined;
+                sebi_turnover_charge?: number | undefined;
+                brokerage?: number | undefined;
+                stamp_duty?: number | undefined;
+                total?: number | undefined;
+                gst?: {
+                    [x: string]: unknown;
+                    igst?: number | undefined;
+                    cgst?: number | undefined;
+                    sgst?: number | undefined;
+                    total?: number | undefined;
+                } | undefined;
+            } | undefined;
+            pnl?: {
+                [x: string]: unknown;
+                realised?: number | undefined;
+                unrealised?: number | undefined;
+            } | undefined;
+        } | undefined;
+        charges?: unknown;
+    }>;
+    orderCharges(orders: unknown[], signal?: AbortSignal): Promise<{
+        [x: string]: unknown;
+        type?: string | undefined;
+        tradingsymbol?: string | undefined;
+        exchange?: string | undefined;
+        span?: number | undefined;
+        exposure?: number | undefined;
+        option_premium?: number | undefined;
+        additional?: number | undefined;
+        bo?: number | undefined;
+        cash?: number | undefined;
+        var?: number | undefined;
+        total?: number | undefined;
+        leverage?: number | undefined;
+        charges?: {
+            [x: string]: unknown;
+            transaction_tax?: number | undefined;
+            transaction_tax_type?: string | undefined;
+            exchange_turnover_charge?: number | undefined;
+            sebi_turnover_charge?: number | undefined;
+            brokerage?: number | undefined;
+            stamp_duty?: number | undefined;
+            total?: number | undefined;
+            gst?: {
+                [x: string]: unknown;
+                igst?: number | undefined;
+                cgst?: number | undefined;
+                sgst?: number | undefined;
+                total?: number | undefined;
+            } | undefined;
+        } | undefined;
+        pnl?: {
+            [x: string]: unknown;
+            realised?: number | undefined;
+            unrealised?: number | undefined;
+        } | undefined;
+    }[]>;
+    getMfHoldings(signal?: AbortSignal): Promise<{
+        [x: string]: unknown;
+        tradingsymbol: string;
+        average_price: number;
+        last_price: number;
+        pnl: number;
+        quantity: number;
+        folio?: string | null | undefined;
+        fund?: string | undefined;
+        last_price_date?: string | undefined;
+    }[]>;
+    /** Note: only returns the last 7 days of orders. */
+    getMfOrders(signal?: AbortSignal): Promise<{
+        [x: string]: unknown;
+        order_id: string;
+        fund?: string | undefined;
+        tradingsymbol?: string | undefined;
+        status?: string | undefined;
+        status_message?: string | null | undefined;
+        folio?: string | null | undefined;
+        order_timestamp?: string | null | undefined;
+        transaction_type?: string | undefined;
+        quantity?: number | null | undefined;
+        amount?: number | null | undefined;
+        average_price?: number | null | undefined;
+    }[]>;
+    getMfSips(signal?: AbortSignal): Promise<{
+        [x: string]: unknown;
+        sip_id: string;
+        tradingsymbol?: string | undefined;
+        fund?: string | undefined;
+        status?: string | undefined;
+        instalment_amount?: number | undefined;
+        instalments?: number | undefined;
+        frequency?: string | undefined;
+        next_instalment?: string | null | undefined;
+    }[]>;
+}
+export interface GttParams {
+    type: 'single' | 'two-leg';
+    condition: {
+        exchange: string;
+        tradingsymbol: string;
+        trigger_values: number[];
+        last_price: number;
+    };
+    orders: Array<{
+        exchange: string;
+        tradingsymbol: string;
+        transaction_type: TransactionType;
+        quantity: number;
+        order_type: 'LIMIT';
+        product: Product;
+        price: number;
+    }>;
+}
+export declare const HISTORICAL_INTERVALS: readonly ["minute", "3minute", "5minute", "10minute", "15minute", "30minute", "60minute", "day"];
+export type HistoricalInterval = (typeof HISTORICAL_INTERVALS)[number];
+/**
+ * Maximum date range per request, by interval.
+ *
+ * These limits are NOT in the official docs — they come from Zerodha staff on
+ * the developer forum. The `day` value is 1900 rather than the 2000 quoted
+ * there, because Zerodha's own sandbox chunking helper uses 1900 and the docs
+ * note that larger `day` ranges error out.
+ */
+export declare const MAX_DAYS_PER_REQUEST: Record<HistoricalInterval, number>;
+export declare function parseInterval(value: string): HistoricalInterval;
+export declare function splitDateRange(from: Date, to: Date, maxDays: number): Array<{
+    from: Date;
+    to: Date;
+}>;
+/** Kite expects "yyyy-mm-dd hh:mm:ss" in IST. */
+export declare function formatIstDateTime(date: Date): string;
+export declare function chunks<T>(items: T[], size: number): Generator<T[]>;