@0xmonaco/types 0.0.0-develop-20260120180031

package/dist/contracts/balances.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Contract Balance Types
+ *
+ * Types for contract balance management and token information.
+ */
+import type { Address } from "viem";
+/**
+ * Type representing a token in the Monaco Markets protocol.
+ * Contains essential token metadata and contract information.
+ *
+ * @property address - Token contract address
+ * @property symbol - Token symbol (e.g. "ETH", "USDC")
+ * @property decimals - Number of decimal places for token amounts
+ * @property name - Full token name
+ */
+export interface Token {
+    /** Token contract address */
+    address: Address;
+    /** Token symbol (e.g. "ETH", "USDC") */
+    symbol: string;
+    /** Number of decimal places for token amounts */
+    decimals: number;
+    /** Full token name */
+    name: string;
+}
+/**
+ * Type representing a user's balance for a specific token in contract storage.
+ *
+ * @property token - Token address
+ * @property available - Available balance for trading
+ * @property locked - Locked balance in open orders
+ * @property total - Total balance (available + locked)
+ */
+export interface UserBalance {
+    /** Token address */
+    token: string;
+    /** Available balance for trading */
+    available: bigint;
+    /** Locked balance in open orders */
+    locked: bigint;
+    /** Total balance (available + locked) */
+    total: bigint;
+}
+//# sourceMappingURL=balances.d.ts.map

package/dist/contracts/balances.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"balances.d.ts","sourceRoot":"","sources":["../../src/contracts/balances.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAEpC;;;;;;;;GAQG;AACH,MAAM,WAAW,KAAK;IACpB,6BAA6B;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,wCAAwC;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,iDAAiD;IACjD,QAAQ,EAAE,MAAM,CAAC;IACjB,sBAAsB;IACtB,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,WAAW;IAC1B,oBAAoB;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,oCAAoC;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,oCAAoC;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,yCAAyC;IACzC,KAAK,EAAE,MAAM,CAAC;CACf"}

package/dist/contracts/balances.js

@@ -0,0 +1,7 @@
+/**
+ * Contract Balance Types
+ *
+ * Types for contract balance management and token information.
+ */
+export {};
+//# sourceMappingURL=balances.js.map

package/dist/contracts/balances.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"balances.js","sourceRoot":"","sources":["../../src/contracts/balances.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/contracts/index.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Contract Types
+ *
+ * Types for contract addresses, instances, and contract-related operations.
+ */
+import type { CONTRACT_ABIS } from "@0xmonaco/contracts";
+import type { GetContractReturnType } from "viem";
+/**
+ * Interface for all contract addresses in the Monaco Markets protocol.
+ *
+ * @property VAULT - Vault contract address for managing user balances
+ */
+export interface ContractAddresses {
+    /** Vault contract address for managing user balances */
+    VAULT: string;
+}
+/**
+ * Type representing all contract instances.
+ * Maps contract names to their typed instances with full ABI type safety.
+ *
+ * @property vault - Vault contract instance for managing user balances
+ */
+export type ContractInstances = {
+    /** Vault contract instance for managing user balances */
+    vault: GetContractReturnType<typeof CONTRACT_ABIS.vault>;
+};
+export type { Token, UserBalance } from "./balances";
+//# sourceMappingURL=index.d.ts.map

package/dist/contracts/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/contracts/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,MAAM,CAAC;AAElD;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,wDAAwD;IACxD,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;GAKG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,yDAAyD;IACzD,KAAK,EAAE,qBAAqB,CAAC,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC;CAC1D,CAAC;AAGF,YAAY,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC"}

package/dist/contracts/index.js

@@ -0,0 +1,7 @@
+/**
+ * Contract Types
+ *
+ * Types for contract addresses, instances, and contract-related operations.
+ */
+export {};
+//# sourceMappingURL=index.js.map

package/dist/contracts/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/contracts/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/fees/index.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Fees Types
+ *
+ * Types for fees operations including fee simulation.
+ */
+import type { BaseAPI } from "../api/index";
+import type { SimulateFeeParams, SimulateFeeResponse } from "./responses";
+/**
+ * Fees API interface.
+ * Provides methods for simulating and calculating trading fees.
+ */
+export interface FeesAPI extends BaseAPI {
+    /**
+     * Simulate fees for an order before placing it.
+     * Returns exact fees for that specific order.
+     *
+     * @param params - Parameters for fee simulation
+     * @param params.trading_pair_id - Trading pair ID
+     * @param params.side - Order side ("BUY" or "SELL")
+     * @param params.price - Price per unit
+     * @param params.quantity - Quantity to trade
+     * @returns Promise resolving to fee simulation details
+     *
+     * @example
+     * ```typescript
+     * const feeDetails = await feesAPI.simulateFees({
+     *   trading_pair_id: "123e4567-e89b-12d3-a456-426614174000",
+     *   side: "BUY",
+     *   price: "40000.00",
+     *   quantity: "0.5"
+     * });
+     * console.log(`Total taker fees: ${feeDetails.total_taker_fees}`);
+     * console.log(`Taker must pay: ${feeDetails.taker_total_payment}`);
+     * ```
+     */
+    simulateFees(params: SimulateFeeParams): Promise<SimulateFeeResponse>;
+}
+export type { SimulateFeeParams, SimulateFeeResponse } from "./responses";
+export { SimulateFeeParamsSchema, SimulateFeeResponseSchema } from "./responses";
+//# sourceMappingURL=index.d.ts.map

package/dist/fees/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/fees/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,KAAK,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAE1E;;;GAGG;AACH,MAAM,WAAW,OAAQ,SAAQ,OAAO;IACtC;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,YAAY,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;CACvE;AAGD,YAAY,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAC1E,OAAO,EAAE,uBAAuB,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAC"}

package/dist/fees/index.js

@@ -0,0 +1,7 @@
+/**
+ * Fees Types
+ *
+ * Types for fees operations including fee simulation.
+ */
+export { SimulateFeeParamsSchema, SimulateFeeResponseSchema } from "./responses";
+//# sourceMappingURL=index.js.map

package/dist/fees/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/fees/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAsCH,OAAO,EAAE,uBAAuB,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAC"}

package/dist/fees/responses.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Fees Response Types
+ *
+ * Types for fees-related API responses.
+ * All types are derived from Zod schemas for runtime validation.
+ */
+import { z } from "zod";
+/**
+ * Zod schema for simulating order fees parameters
+ */
+export declare const SimulateFeeParamsSchema: z.ZodObject<{
+    trading_pair_id: z.ZodString;
+    side: z.ZodEnum<{
+        BUY: "BUY";
+        SELL: "SELL";
+    }>;
+    price: z.ZodString;
+    quantity: z.ZodString;
+}, z.core.$strip>;
+/**
+ * Zod schema for fee simulation response
+ */
+export declare const SimulateFeeResponseSchema: z.ZodObject<{
+    application_name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    application_taker_fee: z.ZodString;
+    application_taker_fee_bps: z.ZodNumber;
+    buy_order_lock_amount: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    maker_total_receipt: z.ZodString;
+    monaco_maker_rebate: z.ZodString;
+    monaco_maker_rebate_bps: z.ZodNumber;
+    monaco_taker_fee: z.ZodString;
+    monaco_taker_fee_bps: z.ZodNumber;
+    notional: z.ZodString;
+    taker_total_payment: z.ZodString;
+    total_taker_fees: z.ZodString;
+}, z.core.$strip>;
+/**
+ * Parameters for simulating order fees
+ * @remarks Type is inferred from SimulateFeeParamsSchema
+ */
+export type SimulateFeeParams = z.infer<typeof SimulateFeeParamsSchema>;
+/**
+ * Response with detailed fee breakdown for simulating order fees
+ * @remarks Type is inferred from SimulateFeeResponseSchema
+ */
+export type SimulateFeeResponse = z.infer<typeof SimulateFeeResponseSchema>;
+//# sourceMappingURL=responses.d.ts.map

package/dist/fees/responses.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"responses.d.ts","sourceRoot":"","sources":["../../src/fees/responses.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;iBAqBlC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;iBAyBpC,CAAC;AAEH;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE;;;GAGG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC"}

package/dist/fees/responses.js

@@ -0,0 +1,62 @@
+/**
+ * Fees Response Types
+ *
+ * Types for fees-related API responses.
+ * All types are derived from Zod schemas for runtime validation.
+ */
+import { z } from "zod";
+/**
+ * Zod schema for simulating order fees parameters
+ */
+export const SimulateFeeParamsSchema = z.object({
+    /** Trading pair ID */
+    trading_pair_id: z.string().trim().min(1, "Trading pair ID is required and cannot be empty"),
+    /** Order side: "BUY" or "SELL" */
+    side: z.enum(["BUY", "SELL"], {
+        message: "Order side is required and must be either 'BUY' or 'SELL'",
+    }),
+    /** Price per unit */
+    price: z
+        .string()
+        .trim()
+        .min(1, "Price is required and cannot be empty")
+        .refine((val) => !Number.isNaN(Number(val)), "Price must be a valid number")
+        .refine((val) => Number(val) > 0, "Price must be greater than 0"),
+    /** Quantity to trade */
+    quantity: z
+        .string()
+        .trim()
+        .min(1, "Quantity is required and cannot be empty")
+        .refine((val) => !Number.isNaN(Number(val)), "Quantity must be a valid number")
+        .refine((val) => Number(val) > 0, "Quantity must be greater than 0"),
+});
+/**
+ * Zod schema for fee simulation response
+ */
+export const SimulateFeeResponseSchema = z.object({
+    /** Application name (if applicable) */
+    application_name: z.string().nullable().optional(),
+    /** Frontend application taker fee */
+    application_taker_fee: z.string(),
+    /** Application fee in basis points */
+    application_taker_fee_bps: z.number(),
+    /** Amount to lock for BUY orders (null for SELL) */
+    buy_order_lock_amount: z.string().nullable().optional(),
+    /** Total amount maker receives */
+    maker_total_receipt: z.string(),
+    /** Monaco protocol maker rebate (negative = rebate) */
+    monaco_maker_rebate: z.string(),
+    /** Monaco maker rebate in basis points */
+    monaco_maker_rebate_bps: z.number(),
+    /** Monaco protocol taker fee */
+    monaco_taker_fee: z.string(),
+    /** Monaco taker fee in basis points */
+    monaco_taker_fee_bps: z.number(),
+    /** Notional value (price * quantity) */
+    notional: z.string(),
+    /** Total amount taker must pay */
+    taker_total_payment: z.string(),
+    /** Total taker fees (monaco + application) */
+    total_taker_fees: z.string(),
+});
+//# sourceMappingURL=responses.js.map

package/dist/fees/responses.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"responses.js","sourceRoot":"","sources":["../../src/fees/responses.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,sBAAsB;IACtB,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,iDAAiD,CAAC;IAC5F,kCAAkC;IAClC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,MAAM,CAAC,EAAE;QAC5B,OAAO,EAAE,2DAA2D;KACrE,CAAC;IACF,qBAAqB;IACrB,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,IAAI,EAAE;SACN,GAAG,CAAC,CAAC,EAAE,uCAAuC,CAAC;SAC/C,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,8BAA8B,CAAC;SAC3E,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,8BAA8B,CAAC;IACnE,wBAAwB;IACxB,QAAQ,EAAE,CAAC;SACR,MAAM,EAAE;SACR,IAAI,EAAE;SACN,GAAG,CAAC,CAAC,EAAE,0CAA0C,CAAC;SAClD,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,iCAAiC,CAAC;SAC9E,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,iCAAiC,CAAC;CACvE,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD,uCAAuC;IACvC,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAClD,qCAAqC;IACrC,qBAAqB,EAAE,CAAC,CAAC,MAAM,EAAE;IACjC,sCAAsC;IACtC,yBAAyB,EAAE,CAAC,CAAC,MAAM,EAAE;IACrC,oDAAoD;IACpD,qBAAqB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IACvD,kCAAkC;IAClC,mBAAmB,EAAE,CAAC,CAAC,MAAM,EAAE;IAC/B,uDAAuD;IACvD,mBAAmB,EAAE,CAAC,CAAC,MAAM,EAAE;IAC/B,0CAA0C;IAC1C,uBAAuB,EAAE,CAAC,CAAC,MAAM,EAAE;IACnC,gCAAgC;IAChC,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE;IAC5B,uCAAuC;IACvC,oBAAoB,EAAE,CAAC,CAAC,MAAM,EAAE;IAChC,wCAAwC;IACxC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,kCAAkC;IAClC,mBAAmB,EAAE,CAAC,CAAC,MAAM,EAAE;IAC/B,8CAA8C;IAC9C,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE;CAC7B,CAAC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Monaco Types Package
+ *
+ * This package provides TypeScript types for the Monaco protocol.
+ * It includes SDK types, vault types, trading types, contract types, and common types.
+ */
+export * from "./api";
+export * from "./applications";
+export * from "./auth";
+export * from "./contracts";
+export * from "./fees";
+export * from "./market";
+export * from "./profile";
+export * from "./sdk";
+export * from "./trading";
+export * from "./validation";
+export * from "./vault";
+export * from "./websocket";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,cAAc,OAAO,CAAC;AACtB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,QAAQ,CAAC;AACvB,cAAc,aAAa,CAAC;AAC5B,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,OAAO,CAAC;AACtB,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,20 @@
+/**
+ * Monaco Types Package
+ *
+ * This package provides TypeScript types for the Monaco protocol.
+ * It includes SDK types, vault types, trading types, contract types, and common types.
+ */
+// Export everything from all modules
+export * from "./api";
+export * from "./applications";
+export * from "./auth";
+export * from "./contracts";
+export * from "./fees";
+export * from "./market";
+export * from "./profile";
+export * from "./sdk";
+export * from "./trading";
+export * from "./validation";
+export * from "./vault";
+export * from "./websocket";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,qCAAqC;AACrC,cAAc,OAAO,CAAC;AACtB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,QAAQ,CAAC;AACvB,cAAc,aAAa,CAAC;AAC5B,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,OAAO,CAAC;AACtB,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC"}

package/dist/market/index.d.ts

@@ -0,0 +1,224 @@
+/**
+ * Market Types
+ *
+ * Types for market data operations including trading pair metadata and OHLCV data.
+ */
+import type { BaseAPI } from "../api";
+/**
+ * Trading pair metadata
+ */
+export interface TradingPair {
+    /** Unique identifier */
+    id: string;
+    /** Trading pair symbol e.g. BTC/USDC */
+    symbol: string;
+    /** Base token symbol */
+    base_token: string;
+    /** Quote token symbol */
+    quote_token: string;
+    /** Base asset ID (UUID) */
+    base_asset_id: string;
+    /** Quote asset ID (UUID) */
+    quote_asset_id: string;
+    /** Base token contract address */
+    base_token_contract: string;
+    /** Quote token contract address */
+    quote_token_contract: string;
+    /** Base token decimals */
+    base_decimals: number;
+    /** Base token icon URL */
+    base_icon_url: string;
+    /** Quote token decimals */
+    quote_decimals: number;
+    /** Quote token icon URL */
+    quote_icon_url: string;
+    /** Market type (e.g. SPOT) */
+    market_type: string;
+    /** Whether the market is active */
+    is_active: boolean;
+    /** Maker fee in basis points */
+    maker_fee_bps: number;
+    /** Taker fee in basis points */
+    taker_fee_bps: number;
+    /** Minimum order size */
+    min_order_size: string;
+    /** Maximum order size */
+    max_order_size: string;
+    /** Tick size for price increments */
+    tick_size: string;
+}
+/**
+ * OHLCV candlestick data point (matches API response format)
+ *
+ * Note: Field naming follows backend API format where:
+ * - T = Start timestamp (open_time from backend)
+ * - t = End timestamp (close_time from backend)
+ */
+export interface Candlestick {
+    /** Start timestamp for the candlestick period (Unix timestamp in milliseconds) */
+    T: number;
+    /** End timestamp for the candlestick period (Unix timestamp in milliseconds) */
+    t: number;
+    /** Opening price */
+    o: string;
+    /** Highest price during the period */
+    h: string;
+    /** Lowest price during the period */
+    l: string;
+    /** Closing price */
+    c: string;
+    /** Volume traded during the period */
+    v: string;
+    /** Symbol */
+    s: string;
+    /** Interval */
+    i: string;
+    /** Number of trades */
+    n: number;
+}
+/**
+ * Supported candlestick intervals
+ */
+export type Interval = "1m" | "5m" | "15m" | "1h" | "4h" | "1d";
+/**
+ * Candlestick subscription configuration
+ */
+export interface CandlestickSubscription {
+    /** Trading pair ID (UUID) */
+    tradingPairId: string;
+    /** Candlestick interval */
+    interval: Interval;
+}
+/**
+ * Query parameters for fetching candlestick data
+ *
+ * All parameters are optional and can be used independently:
+ * - Use `endTime` + `limit` for backward pagination (TradingView primary pattern)
+ * - Use `startTime` + `limit` for forward pagination
+ * - Use just `limit` for most recent bars
+ * - Use `startTime` + `endTime` + `limit` for a specific range (capped at limit)
+ */
+export interface GetCandlesticksParams {
+    /** Start time (Unix ms). Use with `limit` for forward pagination from this timestamp. */
+    startTime?: number;
+    /** End time (Unix ms). Use with `limit` for backward pagination ending at this timestamp. */
+    endTime?: number;
+    /** Maximum number of bars to return (max: 500, server defaults to 350 if omitted) */
+    limit?: number;
+}
+/**
+ * Query parameters for fetching trading pairs
+ */
+export interface GetTradingPairsParams {
+    /** Page number (starts from 1) */
+    page?: number;
+    /** Number of items per page (max 100) */
+    limit?: number;
+    /** Filter by market type (SPOT, MARGIN) */
+    market_type?: string;
+    /** Filter by base token symbol */
+    base_token?: string;
+    /** Filter by quote token symbol */
+    quote_token?: string;
+    /** Filter by active status */
+    is_active?: boolean;
+}
+/**
+ * Paginated response for trading pairs
+ */
+export interface PaginatedTradingPairs {
+    data: TradingPair[];
+    limit: number;
+    page: number;
+    total: number;
+    total_pages: number;
+}
+/**
+ * API response wrapper for trading pairs
+ */
+export interface GetTradingPairsResponse {
+    data: PaginatedTradingPairs;
+    success: boolean;
+}
+/**
+ * API response wrapper for single trading pair
+ */
+export interface GetTradingPairResponse {
+    data: TradingPair;
+    success: boolean;
+}
+/**
+ * API response wrapper for single trading pair
+ */
+export interface GetCandlestickResponse {
+    data: Candlestick[];
+    success: boolean;
+}
+/**
+ * Market metadata with 24-hour statistics
+ */
+export interface MarketMetadata {
+    /** Trading pair symbol (e.g., "BTC/USDC") */
+    symbol: string;
+    /** Base token icon URL */
+    base_icon_url: string;
+    /** Quote token icon URL */
+    quote_icon_url: string;
+    /** Current price (8 decimal precision) */
+    last_price: string;
+    /** Unix timestamp (ms) of latest price */
+    last_price_timestamp: number;
+    /** 24h high price (null if <24h data) */
+    high_24h: string | null;
+    /** 24h low price (null if <24h data) */
+    low_24h: string | null;
+    /** 24h volume in base asset (null if <24h data) */
+    volume_24h: string | null;
+    /** Absolute price change in 24h (null if <24h data) */
+    price_change_24h: string | null;
+    /** Percentage price change in 24h (2 decimals, null if <24h data) */
+    price_change_percent_24h: string | null;
+    /** Unix timestamp (ms) when market started trading (null if not available) */
+    market_initialization_timestamp: number | null;
+}
+/**
+ * Market API interface.
+ * Provides methods for fetching market metadata and trading pair information.
+ */
+export interface MarketAPI extends BaseAPI {
+    /**
+     * Fetch all available trading pairs supported by Monaco.
+     * @param params - Optional query parameters for filtering and pagination
+     * @returns Promise resolving to paginated response with trading pairs
+     */
+    getPaginatedTradingPairs(params?: GetTradingPairsParams): Promise<GetTradingPairsResponse>;
+    /**
+     * Fetch metadata for a single trading pair by its symbol (e.g. BTC-USDC).
+     * @param symbol - Trading pair symbol
+     * @returns Promise resolving to trading pair or undefined if not found
+     */
+    getTradingPairBySymbol(symbol: string): Promise<TradingPair | undefined>;
+    /**
+     * Fetch historical candlestick data for a trading pair.
+     *
+     * Supports TradingView-compliant query patterns:
+     * - `endTime` + `limit`: Backward pagination (bars ending at timestamp)
+     * - `startTime` + `limit`: Forward pagination (bars starting from timestamp)
+     * - `limit` only: Most recent bars
+     * - `startTime` + `endTime` + `limit`: Specific range (capped at limit)
+     *
+     * @param tradingPairId - Trading pair UUID
+     * @param interval - Candlestick interval (1m, 5m, 15m, 1h, 4h, 1d)
+     * @param params - Optional query parameters (startTime, endTime, limit). Server defaults to 350 bars if limit omitted.
+     * @returns Promise resolving to array of candlesticks (oldest to newest)
+     */
+    getCandlesticks(tradingPairId: string, interval: Interval, params?: GetCandlesticksParams): Promise<Candlestick[]>;
+    /**
+     * Get comprehensive market metadata including 24h statistics.
+     * @param tradingPairId - Trading pair UUID
+     * @returns Promise resolving to market metadata with current price and 24h stats
+     * @throws {ApiError} If pair not found or no data available
+     */
+    getMarketMetadata(tradingPairId: string): Promise<MarketMetadata>;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/market/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/market/index.ts"],"names":[],"mappings":"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"}

package/dist/market/index.js

@@ -0,0 +1,7 @@
+/**
+ * Market Types
+ *
+ * Types for market data operations including trading pair metadata and OHLCV data.
+ */
+export {};
+//# sourceMappingURL=index.js.map

package/dist/market/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/market/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}