@0xmonaco/types 0.0.0-develop-20260120180031

package/dist/profile/index.d.ts

@@ -0,0 +1,228 @@
+/**
+ * Profile Types
+ *
+ * Types for user profile operations including fetching user profile data.
+ */
+import type { BaseAPI } from "../api";
+import type { OrderSide, OrderStatus, OrderType, TimeInForce } from "../trading";
+/**
+ * Account movement/transaction information.
+ * Represents transactions/movements returned in the profile's recent_movements array.
+ */
+export interface ProfileMovement {
+    /** Movement identifier */
+    id: string;
+    /** Movement type */
+    type: "deposit" | "withdrawal" | "trade" | "transfer" | string;
+    /** Token address */
+    token: string;
+    /** Amount of the movement (as string to preserve precision) */
+    amount: string;
+    /** Movement timestamp (ISO string) */
+    timestamp: string;
+    /** Transaction hash if applicable */
+    hash?: string;
+    /** Movement status */
+    status: "pending" | "confirmed" | "failed" | string;
+    /** Optional description of the movement */
+    description?: string;
+}
+/**
+ * Ledger movement from the movement's endpoint.
+ * More detailed than ProfileMovement with balance tracking.
+ */
+export interface LedgerMovement {
+    /** Movement unique identifier */
+    id: string;
+    /** Type of entry (Credit, Debit) */
+    entry_type: string;
+    /** Type of transaction (Deposit, Withdrawal, Trade, etc.) */
+    transaction_type: string;
+    /** Transaction amount */
+    amount: string;
+    /** Token symbol */
+    token: string;
+    /** Balance before this transaction */
+    balance_before: string | null;
+    /** Balance after this transaction */
+    balance_after: string | null;
+    /** Locked balance before transaction */
+    locked_before: string | null;
+    /** Locked balance after transaction */
+    locked_after: string | null;
+    /** Reference identifier for related operations */
+    reference_id: string | null;
+    /** Reference type */
+    reference_type: string | null;
+    /** Human readable description */
+    description: string | null;
+    /** Blockchain transaction hash */
+    tx_hash: string | null;
+    /** Blockchain block number */
+    block_number: number | null;
+    /** Transaction timestamp */
+    created_at: string | null;
+}
+/**
+ * Query parameters for getting user movements
+ */
+export interface GetUserMovementsParams {
+    /** Page number (starts from 1) */
+    page?: number;
+    /** Number of items per page (max 100) */
+    limit?: number;
+}
+/**
+ * Query parameters for getting user balances
+ */
+export interface GetUserBalancesParams {
+    /** Number of items to return */
+    limit?: number;
+    /** Number of items to skip */
+    offset?: number;
+}
+/**
+ * Response from getting user movements
+ */
+export interface GetPaginatedUserMovementsResponse {
+    /** List of ledger movements */
+    movements: LedgerMovement[];
+    /** Current page number */
+    page: number;
+    /** Items per page */
+    limit: number;
+    /** Total number of movements */
+    total_count: number;
+    /** Total number of pages */
+    total_pages: number;
+}
+/**
+ * Response from getting user balances
+ */
+export interface GetUserBalancesResponse {
+    /** List of token balances for the user */
+    balances: AccountBalance[];
+    /** Total number of balances */
+    total: number;
+    /** Number of items returned */
+    limit: number;
+    /** Number of items skipped */
+    offset: number;
+}
+/**
+ * Order information for recent orders.
+ * Represents orders returned in the profile's recent_orders array.
+ */
+export interface ProfileOrder {
+    /** Order identifier */
+    id: string;
+    /** Trading pair/market identifier (e.g., "ETH-USD") */
+    trading_pair: string;
+    /** Order side */
+    side: OrderSide;
+    /** Order type */
+    order_type: OrderType;
+    /** Order price (null for market orders) */
+    price: string | null;
+    /** Order quantity */
+    quantity: string;
+    /** Order status */
+    status: OrderStatus;
+    /** Time in force */
+    time_in_force?: TimeInForce;
+    /** Order creation timestamp (ISO string) */
+    created_at: string;
+    /** Order last update timestamp (ISO string) */
+    updated_at?: string;
+}
+/**
+ * Account balance for a specific token.
+ * Returned by the single balance lookup endpoint.
+ */
+export interface AccountBalance {
+    /** Token address */
+    token: string;
+    /** Token symbol */
+    symbol: string;
+    /** Decimal places for the token */
+    decimals: number;
+    /** Available balance for trading */
+    available_balance: string;
+    /** Locked balance (in orders or pending operations) */
+    locked_balance: string;
+    /** Total balance (available + locked) */
+    total_balance: string;
+}
+/**
+ * User profile information returned by the /api/v1/accounts/me endpoint.
+ */
+export interface UserProfile {
+    /** Unique identifier for the user */
+    id: string;
+    /** Wallet address of the user */
+    address: string;
+    /** Username of the user (can be null) */
+    username: string | null;
+    /** Account type (e.g., "master") */
+    account_type: string;
+    /** Whether the user can withdraw funds */
+    can_withdraw: boolean;
+    /** Account creation timestamp (ISO string) */
+    created_at: string;
+    /** User's current balances */
+    balances: AccountBalance[];
+    /** Recent account movements/transactions */
+    recent_movements: ProfileMovement[];
+    /** Recent trading orders */
+    recent_orders: ProfileOrder[];
+}
+/**
+ * Profile API interface.
+ * Provides methods for fetching and managing user profile information.
+ */
+export interface ProfileAPI extends BaseAPI {
+    /**
+     * Get the current user's profile information.
+     *
+     * Fetches the profile data for the authenticated user using the /api/v1/accounts/me endpoint.
+     * Requires a valid access token to be set.
+     *
+     * @returns Promise resolving to the user's profile information
+     */
+    getProfile(): Promise<UserProfile>;
+    /**
+     * Get the current user's ledger movements (transaction history) with pagination.
+     *
+     * Fetches the user's transaction history from the /api/v1/accounts/movements endpoint.
+     * Requires a valid access token to be set.
+     *
+     * @param params - Optional query parameters for pagination
+     * @param params.page - Page number (starts from 1)
+     * @param params.limit - Number of items per page (max 100)
+     * @returns Promise resolving to paginated movements response
+     */
+    getPaginatedUserMovements(params?: GetUserMovementsParams): Promise<GetPaginatedUserMovementsResponse>;
+    /**
+     * Get the current user's token balances with pagination.
+     *
+     * Fetches the user's token balances from the /api/v1/accounts/balances endpoint.
+     * Requires a valid access token to be set.
+     *
+     * @param params - Optional query parameters for pagination
+     * @param params.limit - Number of items to return
+     * @param params.offset - Number of items to skip
+     * @returns Promise resolving to paginated balances response
+     */
+    getUserBalances(params?: GetUserBalancesParams): Promise<GetUserBalancesResponse>;
+    /**
+     * Get the current user's balance for a specific asset.
+     *
+     * Fetches the user's balance for a specific asset from the /api/v1/accounts/balances/{asset_id} endpoint.
+     * Requires a valid access token to be set. If no balance exists for a valid asset, returns zero balances.
+     *
+     * @param assetId - The asset identifier (UUID)
+     * @returns Promise resolving to the account balance for the asset
+     */
+    getUserBalanceByAssetId(assetId: string): Promise<AccountBalance>;
+}
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/profile/index.js

@@ -0,0 +1,7 @@
+/**
+ * Profile Types
+ *
+ * Types for user profile operations including fetching user profile data.
+ */
+export {};
+//# sourceMappingURL=index.js.map

package/dist/profile/index.js.map

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

package/dist/sdk/index.d.ts

@@ -0,0 +1,122 @@
+import type { PublicClient, TransactionReceipt, WalletClient } from "viem";
+import type { ApplicationsAPI } from "../applications";
+import type { AuthAPI, AuthState } from "../auth/index";
+import type { FeesAPI } from "../fees";
+import type { Interval, MarketAPI } from "../market";
+import type { ProfileAPI } from "../profile";
+import type { TradingAPI, TradingMode } from "../trading";
+import type { VaultAPI } from "../vault";
+import type { OHLCVEvent, OrderbookEvent, OrderbookQuotationMode, OrderEvent, TradeEvent, UserMovementEvent } from "../websocket";
+import type { Network } from "./network";
+/**
+ * Configuration options for the Monaco SDK.
+ *
+ * The SDK requires a wallet client for signing operations and an RPC URL.
+ */
+export interface SDKConfig {
+    /** Wallet client for signing operations */
+    walletClient: WalletClient;
+    /**
+     * Network to use - can be a preset ("local", "development", "staging", "mainnet") or a custom API URL.
+     *
+     * Preset networks map to default API URLs:
+     * - "local": http://localhost:8080
+     * - "development": https://develop.apimonaco.xyz
+     * - "staging": https://staging.apimonaco.xyz
+     * - "mainnet": https://api.monaco.xyz
+     *
+     * For custom API URLs, pass the full URL as a string (e.g., "https://my-custom-monaco-api.com").
+     * Note: Custom API URLs always use the testnet chain (Sei testnet). Only the "mainnet" preset uses the mainnet chain.
+     */
+    network: Network;
+    /** RPC URL for Sei blockchain interactions (required) */
+    seiRpcUrl: string;
+    /** Websocket URL for Monaco */
+    wsUrl: string;
+}
+/**
+ * Core SDK interface providing access to all Monaco functionality.
+ */
+export interface MonacoSDK {
+    /** Applications operations API */
+    applications: ApplicationsAPI;
+    /** Auth operations API */
+    auth: AuthAPI;
+    /** Fees operations API */
+    fees: FeesAPI;
+    /** Vault operations API */
+    vault: VaultAPI;
+    /** Trading operations API */
+    trading: TradingAPI;
+    /** Market metadata API */
+    market: MarketAPI;
+    /** Profile operations API */
+    profile: ProfileAPI;
+    /** Orderbook REST API for fetching orderbook snapshots */
+    orderbook: {
+        getOrderbook: (tradingPairId: string, options?: {
+            /** Number of price levels to return (max 100). Defaults to 10. */
+            depth?: number;
+            /** Trading mode: 'Spot' or 'Margin'. Defaults to 'Spot'. */
+            tradingMode?: TradingMode;
+            /** Price grouping magnitude. Valid values: 0.0001, 0.001, 0.01, 0.1, 1, 10, 100, 1000, 10000. */
+            magnitude?: number;
+            /** Quantity denomination: 'BASE' or 'QUOTE'. When 'QUOTE' type, quantities are multiplied by the quote price. */
+            denomination?: OrderbookQuotationMode;
+        }) => Promise<OrderbookEvent>;
+    };
+    /** Trades REST API for fetching historical trades */
+    trades: {
+        getTrades: (tradingPairId: string, options?: {
+            /** Number of records to skip (default: 0) */
+            skip?: number;
+            /** Maximum number of records to return (default: 25, max: 100) */
+            limit?: number;
+        }) => Promise<TradeEvent[]>;
+    };
+    /** WebSocket client for real-time data (orders, orderbook, ohlcv) */
+    ws: {
+        connect: () => Promise<void>;
+        disconnect: () => void;
+        isConnected: () => boolean;
+        getStatus: () => "connected" | "connecting" | "disconnected" | "reconnecting";
+        setToken: (token: string) => void;
+        orders: (tradingPairId: string, tradingMode: TradingMode, handler: (event: OrderEvent) => void) => () => void;
+        orderbook: (tradingPairId: string, tradingMode: TradingMode, magnitude: number, quotationMode: OrderbookQuotationMode, handler: (event: OrderbookEvent) => void) => () => void;
+        ohlcv: (tradingPairId: string, tradingMode: TradingMode, interval: Interval, handler: (event: OHLCVEvent) => void) => () => void;
+        trades: (tradingPairId: string, handler: (event: TradeEvent) => void) => () => void;
+        movements: (handler: (event: UserMovementEvent) => void) => () => void;
+    };
+    /** Wallet client for all blockchain operations */
+    walletClient: WalletClient;
+    /** Public client for read-only blockchain operations */
+    publicClient: PublicClient;
+    /**
+     * Complete authentication flow
+     * @param clientId - The client ID for authentication
+     * @param options - Optional configuration for login
+     */
+    login(clientId: string, options?: {
+        connectWebSocket?: boolean;
+    }): Promise<AuthState>;
+    /** Log out the user */
+    logout(): Promise<void>;
+    /** Refresh the access token */
+    refreshAuth(): Promise<AuthState>;
+    /** Get the current authentication state */
+    getAuthState(): AuthState | undefined;
+    /** Check if the user is authenticated */
+    isAuthenticated(): boolean;
+    /** Check connection status */
+    isConnected(): boolean;
+    /** Get the current account address */
+    getAccountAddress(): string;
+    /** Get the current network ('mainnet' or 'testnet') */
+    getNetwork(): Network;
+    /** Get the current chain ID */
+    getChainId(): number;
+    /** Wait for a transaction to be confirmed */
+    waitForTransaction(hash: string, confirmations?: number, timeout?: number): Promise<TransactionReceipt>;
+}
+export type { Network, NetworkEndpoints } from "./network";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/sdk/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,MAAM,CAAC;AAC3E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACrD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC1D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,sBAAsB,EAAE,UAAU,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAClI,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC;;;;GAIG;AACH,MAAM,WAAW,SAAS;IACxB,2CAA2C;IAC3C,YAAY,EAAE,YAAY,CAAC;IAE3B;;;;;;;;;;;OAWG;IACH,OAAO,EAAE,OAAO,CAAC;IAEjB,yDAAyD;IACzD,SAAS,EAAE,MAAM,CAAC;IAElB,+BAA+B;IAC/B,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,kCAAkC;IAClC,YAAY,EAAE,eAAe,CAAC;IAE9B,0BAA0B;IAC1B,IAAI,EAAE,OAAO,CAAC;IAEd,0BAA0B;IAC1B,IAAI,EAAE,OAAO,CAAC;IAEd,2BAA2B;IAC3B,KAAK,EAAE,QAAQ,CAAC;IAEhB,6BAA6B;IAC7B,OAAO,EAAE,UAAU,CAAC;IAEpB,0BAA0B;IAC1B,MAAM,EAAE,SAAS,CAAC;IAElB,6BAA6B;IAC7B,OAAO,EAAE,UAAU,CAAC;IAEpB,0DAA0D;IAC1D,SAAS,EAAE;QACT,YAAY,EAAE,CACZ,aAAa,EAAE,MAAM,EACrB,OAAO,CAAC,EAAE;YACR,kEAAkE;YAClE,KAAK,CAAC,EAAE,MAAM,CAAC;YACf,4DAA4D;YAC5D,WAAW,CAAC,EAAE,WAAW,CAAC;YAC1B,iGAAiG;YACjG,SAAS,CAAC,EAAE,MAAM,CAAC;YACnB,iHAAiH;YACjH,YAAY,CAAC,EAAE,sBAAsB,CAAC;SACvC,KACE,OAAO,CAAC,cAAc,CAAC,CAAC;KAC9B,CAAC;IAEF,qDAAqD;IACrD,MAAM,EAAE;QACN,SAAS,EAAE,CACT,aAAa,EAAE,MAAM,EACrB,OAAO,CAAC,EAAE;YACR,6CAA6C;YAC7C,IAAI,CAAC,EAAE,MAAM,CAAC;YACd,kEAAkE;YAClE,KAAK,CAAC,EAAE,MAAM,CAAC;SAChB,KACE,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;KAC5B,CAAC;IAEF,qEAAqE;IACrE,EAAE,EAAE;QACF,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;QAC7B,UAAU,EAAE,MAAM,IAAI,CAAC;QACvB,WAAW,EAAE,MAAM,OAAO,CAAC;QAC3B,SAAS,EAAE,MAAM,WAAW,GAAG,YAAY,GAAG,cAAc,GAAG,cAAc,CAAC;QAC9E,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;QAClC,MAAM,EAAE,CAAC,aAAa,EAAE,MAAM,EAAE,WAAW,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,KAAK,MAAM,IAAI,CAAC;QAC9G,SAAS,EAAE,CACT,aAAa,EAAE,MAAM,EACrB,WAAW,EAAE,WAAW,EACxB,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,sBAAsB,EACrC,OAAO,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,KACrC,MAAM,IAAI,CAAC;QAChB,KAAK,EAAE,CAAC,aAAa,EAAE,MAAM,EAAE,WAAW,EAAE,WAAW,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,KAAK,MAAM,IAAI,CAAC;QACjI,MAAM,EAAE,CAAC,aAAa,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,KAAK,MAAM,IAAI,CAAC;QACpF,SAAS,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,KAAK,MAAM,IAAI,CAAC;KACxE,CAAC;IAEF,kDAAkD;IAClD,YAAY,EAAE,YAAY,CAAC;IAE3B,wDAAwD;IACxD,YAAY,EAAE,YAAY,CAAC;IAE3B;;;;OAIG;IACH,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,gBAAgB,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;IAEtF,uBAAuB;IACvB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAExB,+BAA+B;IAC/B,WAAW,IAAI,OAAO,CAAC,SAAS,CAAC,CAAC;IAElC,2CAA2C;IAC3C,YAAY,IAAI,SAAS,GAAG,SAAS,CAAC;IAEtC,yCAAyC;IACzC,eAAe,IAAI,OAAO,CAAC;IAE3B,8BAA8B;IAC9B,WAAW,IAAI,OAAO,CAAC;IAEvB,sCAAsC;IACtC,iBAAiB,IAAI,MAAM,CAAC;IAE5B,uDAAuD;IACvD,UAAU,IAAI,OAAO,CAAC;IAEtB,+BAA+B;IAC/B,UAAU,IAAI,MAAM,CAAC;IAErB,6CAA6C;IAC7C,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;CACzG;AAGD,YAAY,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC"}

package/dist/sdk/index.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.js.map

package/dist/sdk/index.js.map

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

package/dist/sdk/network.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Network Types
+ *
+ * Network configuration and endpoint types for the Monaco SDK.
+ */
+/**
+ * Supported network types for the Monaco SDK.
+ *
+ * Can be one of the preset networks ("mainnet", "development", "staging", "local") which map to default API URLs,
+ * or a custom API URL string that will be used directly.
+ *
+ * Preset API URLs:
+ * - "local": http://localhost:8080
+ * - "development": https://develop.apimonaco.xyz
+ * - "staging": https://staging.apimonaco.xyz
+ * - "mainnet": https://api.monaco.xyz
+ *
+ * Custom API URL example: "https://my-custom-api.com"
+ */
+export type Network = "mainnet" | "development" | "staging" | "local" | string;
+/**
+ * Network endpoint configuration for the Monaco SDK.
+ *
+ * Contains the RPC URL and API URL for each supported network.
+ * WebSocket connections use the API URL with /ws endpoint and the access token is passed as a query parameter.
+ */
+export interface NetworkEndpoints {
+    rpcUrl: string;
+    apiUrl: string;
+}
+//# sourceMappingURL=network.d.ts.map

package/dist/sdk/network.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"network.d.ts","sourceRoot":"","sources":["../../src/sdk/network.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,OAAO,GAAG,SAAS,GAAG,aAAa,GAAG,SAAS,GAAG,OAAO,GAAG,MAAM,CAAC;AAE/E;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB"}

package/dist/sdk/network.js

@@ -0,0 +1,7 @@
+/**
+ * Network Types
+ *
+ * Network configuration and endpoint types for the Monaco SDK.
+ */
+export {};
+//# sourceMappingURL=network.js.map

package/dist/sdk/network.js.map

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

package/dist/trading/index.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Trading Types
+ *
+ * Types for trading operations including order placement and management.
+ */
+import type { BaseAPI } from "../api/index";
+import type { OrderSide, TimeInForce, TradingMode } from "./orders";
+import type { CancelOrderResponse, CreateOrderResponse, GetOrderResponse, GetPaginatedOrdersParams, GetPaginatedOrdersResponse, ReplaceOrderResponse } from "./responses";
+/**
+ * Trading API interface.
+ * Provides methods for placing and managing orders.
+ * Handles order placement, cancellation, and execution.
+ */
+export interface TradingAPI extends BaseAPI {
+    /**
+     * Places a limit order on the order book.
+     * @param tradingPairId - Trading pair UUID
+     * @param side - Order side ("BUY" or "SELL")
+     * @param quantity - Order quantity as string
+     * @param price - Order price as string
+     * @param options - Optional parameters for the limit order
+     * @param options.tradingMode - Trading mode (e.g., "SPOT")
+     * @param options.timeInForce - Time in force ("GTC", "IOC", or "FOK")
+     * @returns Promise resolving to the order result
+     */
+    placeLimitOrder(tradingPairId: string, side: OrderSide, quantity: string, price: string, options?: {
+        tradingMode?: TradingMode;
+        useMasterBalance?: boolean;
+        expirationDate?: string;
+        timeInForce?: TimeInForce;
+    }): Promise<CreateOrderResponse>;
+    /**
+     * Places a market order for immediate execution.
+     * @param tradingPairId - Trading pair UUID
+     * @param side - Order side ("BUY" or "SELL")
+     * @param quantity - Order quantity as string
+     * @param options - Optional parameters for the market order
+     * @param options.tradingMode - Trading mode (e.g., "SPOT")
+     * @param options.slippageTolerance - Slippage tolerance as decimal (e.g., 0.01 for 1%, 0 for best price only, undefined for unlimited slippage)
+     * @param options.timeInForce - Time in force ("GTC", "IOC", or "FOK")
+     * @returns Promise resolving to the order result
+     */
+    placeMarketOrder(tradingPairId: string, side: OrderSide, quantity: string, options?: {
+        tradingMode?: TradingMode;
+        slippageTolerance?: number;
+        timeInForce?: TimeInForce;
+    }): Promise<CreateOrderResponse>;
+    /**
+     * Cancels an existing order.
+     * @param orderId - ID of the order to cancel
+     * @returns Promise resolving to the cancellation result
+     */
+    cancelOrder(orderId: string): Promise<CancelOrderResponse>;
+    /**
+     * Replaces an existing order with new parameters.
+     * Updates the order with new price, quantity, and balance settings.
+     * @param orderId - ID of the order to replace
+     * @param newOrder - New order parameters
+     * @param newOrder.price - New order price as string (optional)
+     * @param newOrder.quantity - New order quantity as string
+     * @param newOrder.useMasterBalance - Whether to use master balance (optional, defaults to false)
+     * @returns Promise resolving to the replace result
+     */
+    replaceOrder(orderId: string, newOrder: {
+        price?: string;
+        quantity?: string;
+        useMasterBalance?: boolean;
+    }): Promise<ReplaceOrderResponse>;
+    /**
+     * Gets paginated orders based on query parameters.
+     * @param params - Query parameters for filtering orders
+     * @param params.status - Filter by order status (optional)
+     * @param params.trading_pair - Filter by trading pair (optional)
+     * @param params.page - Page number for pagination (optional)
+     * @param params.page_size - Number of orders per page (optional)
+     * @returns Promise resolving to the paginated orders result
+     */
+    getPaginatedOrders(params?: GetPaginatedOrdersParams): Promise<GetPaginatedOrdersResponse>;
+    /**
+     * Gets a single order by its ID.
+     * @param orderId - ID of the order to retrieve
+     * @returns Promise resolving to the order details
+     */
+    getOrder(orderId: string): Promise<GetOrderResponse>;
+}
+export type { Order, OrderRole, OrderSide, OrderStatus, OrderType, TimeInForce, TradingMode, } from "./orders";
+export type { CancelOrderResponse, CreateOrderResponse, GetOrderResponse, GetPaginatedOrdersParams, GetPaginatedOrdersResponse, MatchResult, ReplaceOrderResponse, UpdatedFields, } from "./responses";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/trading/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACpE,OAAO,KAAK,EACV,mBAAmB,EACnB,mBAAmB,EACnB,gBAAgB,EAChB,wBAAwB,EACxB,0BAA0B,EAC1B,oBAAoB,EACrB,MAAM,aAAa,CAAC;AAErB;;;;GAIG;AACH,MAAM,WAAW,UAAW,SAAQ,OAAO;IACzC;;;;;;;;;;OAUG;IACH,eAAe,CACb,aAAa,EAAE,MAAM,EACrB,IAAI,EAAE,SAAS,EACf,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE;QACR,WAAW,CAAC,EAAE,WAAW,CAAC;QAC1B,gBAAgB,CAAC,EAAE,OAAO,CAAC;QAC3B,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,WAAW,CAAC,EAAE,WAAW,CAAC;KAC3B,GACA,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAEhC;;;;;;;;;;OAUG;IACH,gBAAgB,CACd,aAAa,EAAE,MAAM,EACrB,IAAI,EAAE,SAAS,EACf,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE;QACR,WAAW,CAAC,EAAE,WAAW,CAAC;QAC1B,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAC3B,WAAW,CAAC,EAAE,WAAW,CAAC;KAC3B,GACA,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAEhC;;;;OAIG;IACH,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAE3D;;;;;;;;;OASG;IACH,YAAY,CACV,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE;QACR,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,gBAAgB,CAAC,EAAE,OAAO,CAAC;KAC5B,GACA,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAEjC;;;;;;;;OAQG;IACH,kBAAkB,CAAC,MAAM,CAAC,EAAE,wBAAwB,GAAG,OAAO,CAAC,0BAA0B,CAAC,CAAC;IAE3F;;;;OAIG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;CACtD;AAGD,YAAY,EACV,KAAK,EACL,SAAS,EACT,SAAS,EACT,WAAW,EACX,SAAS,EACT,WAAW,EACX,WAAW,GACZ,MAAM,UAAU,CAAC;AAElB,YAAY,EACV,mBAAmB,EACnB,mBAAmB,EACnB,gBAAgB,EAChB,wBAAwB,EACxB,0BAA0B,EAC1B,WAAW,EACX,oBAAoB,EACpB,aAAa,GACd,MAAM,aAAa,CAAC"}

package/dist/trading/index.js

@@ -0,0 +1,7 @@
+/**
+ * Trading Types
+ *
+ * Types for trading operations including order placement and management.
+ */
+export {};
+//# sourceMappingURL=index.js.map

package/dist/trading/index.js.map

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

package/dist/trading/orders.d.ts

@@ -0,0 +1,108 @@
+/**
+ * Trading Order Types
+ *
+ * Types for trading operations and order management.
+ */
+/**
+ * Standard order structure used across all order-related responses.
+ * This represents the complete order information as returned by the API.
+ *
+ * @remarks
+ * Order lifecycle statuses: PENDING → SUBMITTED → ACKNOWLEDGED → (PARTIALLY_FILLED) → FILLED
+ * Orders can transition to CANCELLED, REJECTED, or EXPIRED at various stages.
+ * Fee fields are only populated after order fills occur.
+ *
+ * @example
+ * To calculate remaining quantity:
+ * ```typescript
+ * const remaining = parseFloat(order.quantity) - parseFloat(order.filled_quantity);
+ * ```
+ */
+export interface Order {
+    /** Order identifier (UUID) */
+    id: string;
+    /** Trading pair ID (UUID format, e.g., "456e7890-e12b-12d3-a456-426614174000") */
+    trading_pair: string;
+    /** Order side (BUY or SELL) */
+    side: OrderSide;
+    /** Order type - see OrderType for all supported types */
+    order_type: OrderType;
+    /** Order status - see OrderStatus for lifecycle details */
+    status: OrderStatus;
+    /** Order price - null for market orders, required for limit orders */
+    price?: string;
+    /** Order quantity (base currency amount) */
+    quantity: string;
+    /** Filled quantity (base currency amount, "0" if unfilled) */
+    filled_quantity: string;
+    /** Average fill price - only populated after order has fills */
+    average_fill_price?: string;
+    /** Trading mode (SPOT or MARGIN) */
+    trading_mode: TradingMode;
+    /** Time in force - GTC, IOC, FOK, or GTD */
+    time_in_force?: TimeInForce;
+    /** Order creation timestamp (ISO 8601) */
+    created_at: string;
+    /** Order last update timestamp (ISO 8601) */
+    updated_at?: string;
+    /** Optional expiration date for GTD orders (ISO 8601, max 1 year) */
+    expiration_date?: string;
+    /** Application taker fee in basis points (e.g., "100" = 1%) - populated after fills */
+    application_taker_fee?: string;
+    /** Monaco protocol taker fee in basis points - populated after fills */
+    monaco_taker_fee?: string;
+    /** Monaco protocol maker rebate in basis points - populated after fills */
+    monaco_maker_rebate?: string;
+    /** Total taker fees paid in quote currency - populated after fills */
+    total_taker_fees?: string;
+    /** Total payment for taker including fees in quote currency - populated after fills */
+    taker_total_payment?: string;
+    /** Total receipt for maker after rebates in quote currency - populated after fills */
+    maker_total_receipt?: string;
+}
+/**
+ * Role of the creator or order
+ */
+export type OrderRole = "maker" | "taker";
+/**
+ * Order side for trading operations
+ */
+export type OrderSide = "BUY" | "SELL";
+/**
+ * Order type for different order strategies
+ * - LIMIT: Execute only at specified price or better
+ * - MARKET: Execute immediately at current market price
+ * - STOP_LOSS: Stop loss order triggered at trigger price
+ * - TAKE_PROFIT: Take profit order triggered at trigger price
+ * - STOP_LIMIT: Stop order that becomes a limit order when triggered
+ * - TRAILING_STOP: Stop order that trails the market price
+ */
+export type OrderType = "LIMIT" | "MARKET" | "STOP_LOSS" | "TAKE_PROFIT" | "STOP_LIMIT" | "TRAILING_STOP";
+/**
+ * Order status for different order states
+ *
+ * Order lifecycle progression:
+ * - PENDING: Order created but not yet submitted to matching engine
+ * - SUBMITTED: Order submitted to matching engine for processing
+ * - ACKNOWLEDGED: Order acknowledged and validated by matching engine
+ * - PARTIALLY_FILLED: Order has been partially executed
+ * - FILLED: Order has been completely executed
+ * - SETTLED: Order has been settled on-chain
+ * - CANCELLED: Order was cancelled by user or system
+ * - REJECTED: Order was rejected due to validation failure
+ * - EXPIRED: Order expired based on time constraints
+ */
+export type OrderStatus = "PENDING" | "SUBMITTED" | "ACKNOWLEDGED" | "PARTIALLY_FILLED" | "FILLED" | "SETTLED" | "CANCELLED" | "REJECTED" | "EXPIRED";
+/**
+ * Trading mode
+ */
+export type TradingMode = "SPOT" | "MARGIN";
+/**
+ * Time in force for order execution
+ * - GTC: Good Till Cancel - remains active until filled or cancelled
+ * - IOC: Immediate or Cancel - execute immediately and cancel unfilled portion
+ * - FOK: Fill or Kill - execute completely or cancel entirely
+ * - GTD: Good Till Date - remains active until specified expiration date
+ */
+export type TimeInForce = "GTC" | "IOC" | "FOK" | "GTD";
+//# sourceMappingURL=orders.d.ts.map

package/dist/trading/orders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orders.d.ts","sourceRoot":"","sources":["../../src/trading/orders.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,KAAK;IACpB,8BAA8B;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,kFAAkF;IAClF,YAAY,EAAE,MAAM,CAAC;IACrB,+BAA+B;IAC/B,IAAI,EAAE,SAAS,CAAC;IAChB,yDAAyD;IACzD,UAAU,EAAE,SAAS,CAAC;IACtB,2DAA2D;IAC3D,MAAM,EAAE,WAAW,CAAC;IACpB,sEAAsE;IACtE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4CAA4C;IAC5C,QAAQ,EAAE,MAAM,CAAC;IACjB,8DAA8D;IAC9D,eAAe,EAAE,MAAM,CAAC;IACxB,gEAAgE;IAChE,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,oCAAoC;IACpC,YAAY,EAAE,WAAW,CAAC;IAC1B,4CAA4C;IAC5C,aAAa,CAAC,EAAE,WAAW,CAAC;IAC5B,0CAA0C;IAC1C,UAAU,EAAE,MAAM,CAAC;IACnB,6CAA6C;IAC7C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qEAAqE;IACrE,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,uFAAuF;IACvF,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,wEAAwE;IACxE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,2EAA2E;IAC3E,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,sEAAsE;IACtE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,uFAAuF;IACvF,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,sFAAsF;IACtF,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,OAAO,CAAC;AAE1C;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,KAAK,GAAG,MAAM,CAAC;AAEvC;;;;;;;;GAQG;AACH,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,QAAQ,GAAG,WAAW,GAAG,aAAa,GAAG,YAAY,GAAG,eAAe,CAAC;AAE1G;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,WAAW,GAAG,cAAc,GAAG,kBAAkB,GAAG,QAAQ,GAAG,SAAS,GAAG,WAAW,GAAG,UAAU,GAAG,SAAS,CAAC;AAEtJ;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,QAAQ,CAAC;AAE5C;;;;;;GAMG;AACH,MAAM,MAAM,WAAW,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,CAAC"}

package/dist/trading/orders.js

@@ -0,0 +1,7 @@
+/**
+ * Trading Order Types
+ *
+ * Types for trading operations and order management.
+ */
+export {};
+//# sourceMappingURL=orders.js.map