@0xmonaco/core 0.0.0-develop-20260120180031

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

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../../src/api/market/api.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EAEX,qBAAqB,EACrB,qBAAqB,EACrB,uBAAuB,EACvB,QAAQ,EACR,SAAS,EACT,cAAc,EACd,WAAW,EACZ,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAElC;;;;GAIG;AACH,qBAAa,aAAc,SAAQ,OAAQ,YAAW,SAAS;IACvD,wBAAwB,CAAC,MAAM,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,uBAAuB,CAAC;IA4B1F,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC;IAMxE,eAAe,CAAC,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAgClH,iBAAiB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;CAMxE"}

package/dist/api/market/api.js

@@ -0,0 +1,70 @@
+import { GetCandlesticksByPairIdSchema, GetMarketMetadataSchema, validate } from "@0xmonaco/types";
+import { BaseAPI } from "../base";
+/**
+ * Market API Implementation
+ *
+ * Provides read-only market metadata endpoints such as trading pair listings.
+ */
+export class MarketAPIImpl extends BaseAPI {
+    async getPaginatedTradingPairs(params) {
+        const searchParams = new URLSearchParams();
+        if (params?.page !== undefined) {
+            searchParams.append("page", params.page.toString());
+        }
+        if (params?.limit !== undefined) {
+            searchParams.append("limit", params.limit.toString());
+        }
+        if (params?.market_type) {
+            searchParams.append("market_type", params.market_type);
+        }
+        if (params?.base_token) {
+            searchParams.append("base_token", params.base_token);
+        }
+        if (params?.quote_token) {
+            searchParams.append("quote_token", params.quote_token);
+        }
+        if (params?.is_active !== undefined) {
+            searchParams.append("is_active", params.is_active.toString());
+        }
+        const queryString = searchParams.toString();
+        const url = queryString ? `/api/v1/market/pairs?${queryString}` : "/api/v1/market/pairs";
+        return await this.makePublicRequest(url);
+    }
+    async getTradingPairBySymbol(symbol) {
+        // Backend endpoint expects UUID, not symbol, so we fetch all pairs and filter
+        const response = await this.getPaginatedTradingPairs({ limit: 100 });
+        return response.data.data.find((pair) => pair.symbol === symbol);
+    }
+    async getCandlesticks(tradingPairId, interval, params) {
+        // Validate inputs using the trading pair ID schema
+        validate(GetCandlesticksByPairIdSchema, {
+            tradingPairId,
+            interval,
+            startTime: params?.startTime,
+            endTime: params?.endTime,
+            limit: params?.limit,
+        });
+        const searchParams = new URLSearchParams();
+        if (params?.startTime !== undefined) {
+            searchParams.append("start_time", params.startTime.toString());
+        }
+        if (params?.endTime !== undefined) {
+            searchParams.append("end_time", params.endTime.toString());
+        }
+        if (params?.limit !== undefined) {
+            searchParams.append("limit", params.limit.toString());
+        }
+        const queryString = searchParams.toString();
+        const url = queryString
+            ? `/api/v1/market/pairs/charts/candlestick/${encodeURIComponent(tradingPairId)}/${interval}?${queryString}`
+            : `/api/v1/market/pairs/charts/candlestick/${encodeURIComponent(tradingPairId)}/${interval}`;
+        const response = await this.makePublicRequest(url);
+        return response.data || [];
+    }
+    async getMarketMetadata(tradingPairId) {
+        validate(GetMarketMetadataSchema, { tradingPairId });
+        const url = `/api/v1/market/pairs/${tradingPairId}/metadata`;
+        return await this.makePublicRequest(url);
+    }
+}
+//# sourceMappingURL=api.js.map

package/dist/api/market/api.js.map

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

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

@@ -0,0 +1,2 @@
+export { MarketAPIImpl } from "./api";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/api/market/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC"}

package/dist/api/market/index.js

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

package/dist/api/market/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/api/market/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC"}

package/dist/api/orderbook/api.d.ts

@@ -0,0 +1,16 @@
+import type { OrderbookEvent, OrderbookQuotationMode, TradingMode } from "@0xmonaco/types";
+import { BaseAPI } from "../base";
+export interface GetOrderbookOptions {
+    /** 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', quantities are multiplied by price. */
+    denomination?: OrderbookQuotationMode;
+}
+export declare class OrderbookAPIImpl extends BaseAPI {
+    getOrderbook(tradingPairId: string, options?: GetOrderbookOptions): Promise<OrderbookEvent>;
+}
+//# sourceMappingURL=api.d.ts.map

package/dist/api/orderbook/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../../src/api/orderbook/api.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,sBAAsB,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC3F,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAmBlC,MAAM,WAAW,mBAAmB;IAClC,kEAAkE;IAClE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4DAA4D;IAC5D,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,iGAAiG;IACjG,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kGAAkG;IAClG,YAAY,CAAC,EAAE,sBAAsB,CAAC;CACvC;AAED,qBAAa,gBAAiB,SAAQ,OAAO;IACrC,YAAY,CAAC,aAAa,EAAE,MAAM,EAAE,OAAO,GAAE,mBAAwB,GAAG,OAAO,CAAC,cAAc,CAAC;CAkCtG"}

package/dist/api/orderbook/api.js

@@ -0,0 +1,38 @@
+import { BaseAPI } from "../base";
+export class OrderbookAPIImpl extends BaseAPI {
+    async getOrderbook(tradingPairId, options = {}) {
+        const { depth = 10, tradingMode, magnitude, denomination } = options;
+        const params = new URLSearchParams();
+        params.set("levels", String(depth));
+        if (tradingMode)
+            params.set("trading_mode", tradingMode);
+        if (magnitude !== undefined)
+            params.set("magnitude", String(magnitude));
+        if (denomination)
+            params.set("denomination", denomination.toLowerCase());
+        const response = await this.makePublicRequest(`/api/v1/orderbook/${encodeURIComponent(tradingPairId)}?${params.toString()}`);
+        return {
+            tradingPairId: response.pair,
+            tradingMode: response.trading_mode,
+            bids: response.data.bids.map((level) => ({
+                price: level.price,
+                quantity: level.quantity,
+                orderCount: level.order_count,
+            })),
+            asks: response.data.asks.map((level) => ({
+                price: level.price,
+                quantity: level.quantity,
+                orderCount: level.order_count,
+            })),
+            bestBid: response.data.best_bid,
+            bestAsk: response.data.best_ask,
+            bidVolume: response.data.bid_volume,
+            askVolume: response.data.ask_volume,
+            baseDecimals: response.base_decimals,
+            quoteDecimals: response.quote_decimals,
+            timestamp: response.timestamp,
+            sequence: response.sequence_number,
+        };
+    }
+}
+//# sourceMappingURL=api.js.map

package/dist/api/orderbook/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../../../src/api/orderbook/api.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AA8BlC,MAAM,OAAO,gBAAiB,SAAQ,OAAO;IAC3C,KAAK,CAAC,YAAY,CAAC,aAAqB,EAAE,UAA+B,EAAE;QACzE,MAAM,EAAE,KAAK,GAAG,EAAE,EAAE,WAAW,EAAE,SAAS,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC;QAErE,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;QACrC,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QACpC,IAAI,WAAW;YAAE,MAAM,CAAC,GAAG,CAAC,cAAc,EAAE,WAAW,CAAC,CAAC;QACzD,IAAI,SAAS,KAAK,SAAS;YAAE,MAAM,CAAC,GAAG,CAAC,WAAW,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC;QACxE,IAAI,YAAY;YAAE,MAAM,CAAC,GAAG,CAAC,cAAc,EAAE,YAAY,CAAC,WAAW,EAAE,CAAC,CAAC;QAEzE,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,iBAAiB,CAAuB,qBAAqB,kBAAkB,CAAC,aAAa,CAAC,IAAI,MAAM,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QAEnJ,OAAO;YACL,aAAa,EAAE,QAAQ,CAAC,IAAI;YAC5B,WAAW,EAAE,QAAQ,CAAC,YAA2B;YACjD,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;gBACvC,KAAK,EAAE,KAAK,CAAC,KAAK;gBAClB,QAAQ,EAAE,KAAK,CAAC,QAAQ;gBACxB,UAAU,EAAE,KAAK,CAAC,WAAW;aAC9B,CAAC,CAAC;YACH,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;gBACvC,KAAK,EAAE,KAAK,CAAC,KAAK;gBAClB,QAAQ,EAAE,KAAK,CAAC,QAAQ;gBACxB,UAAU,EAAE,KAAK,CAAC,WAAW;aAC9B,CAAC,CAAC;YACH,OAAO,EAAE,QAAQ,CAAC,IAAI,CAAC,QAAQ;YAC/B,OAAO,EAAE,QAAQ,CAAC,IAAI,CAAC,QAAQ;YAC/B,SAAS,EAAE,QAAQ,CAAC,IAAI,CAAC,UAAU;YACnC,SAAS,EAAE,QAAQ,CAAC,IAAI,CAAC,UAAU;YACnC,YAAY,EAAE,QAAQ,CAAC,aAAa;YACpC,aAAa,EAAE,QAAQ,CAAC,cAAc;YACtC,SAAS,EAAE,QAAQ,CAAC,SAAS;YAC7B,QAAQ,EAAE,QAAQ,CAAC,eAAe;SACnC,CAAC;IACJ,CAAC;CACF"}

package/dist/api/orderbook/index.d.ts

@@ -0,0 +1,2 @@
+export { type GetOrderbookOptions, OrderbookAPIImpl } from "./api";
+//# sourceMappingURL=index.d.ts.map

package/dist/api/orderbook/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/api/orderbook/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,OAAO,CAAC"}

package/dist/api/orderbook/index.js

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

package/dist/api/orderbook/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/api/orderbook/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAA4B,gBAAgB,EAAE,MAAM,OAAO,CAAC"}

package/dist/api/profile/api.d.ts

@@ -0,0 +1,119 @@
+/**
+ * Profile API Implementation
+ *
+ * Handles user profile operations including fetching profile information.
+ * All operations use JWT authentication and go through the API Gateway.
+ *
+ * This class provides a complete interface for profile operations on the Monaco protocol,
+ * including fetching user profile data from the /api/v1/accounts/me endpoint.
+ *
+ * @example
+ * ```typescript
+ * const profileAPI = new ProfileAPIImpl(apiUrl);
+ * profileAPI.setAccessToken(jwtToken);
+ *
+ * // Get user profile
+ * const profile = await profileAPI.getProfile();
+ * console.log(`User: ${profile.username} (${profile.address})`);
+ * ```
+ */
+import type { AccountBalance, GetPaginatedUserMovementsResponse, GetUserBalancesParams, GetUserBalancesResponse, GetUserMovementsParams, ProfileAPI, UserProfile } from "@0xmonaco/types";
+import { BaseAPI } from "../base";
+export declare class ProfileAPIImpl extends BaseAPI implements ProfileAPI {
+    /**
+     * 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
+     * @throws {APIError} When the request fails or user is not authenticated
+     *
+     * @example
+     * ```typescript
+     * // Set access token first
+     * profileAPI.setAccessToken(authResult.accessToken);
+     *
+     * // Get profile
+     * const profile = await profileAPI.getProfile();
+     * console.log(`User ID: ${profile.id}`);
+     * console.log(`Address: ${profile.address}`);
+     * console.log(`Username: ${profile.username}`);
+     * console.log(`Account type: ${profile.account_type}`);
+     * console.log(`Can withdraw: ${profile.can_withdraw}`);
+     * ```
+     */
+    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, default: 1)
+     * @param params.limit - Number of items per page (default: 20, max: 100)
+     * @returns Promise resolving to paginated movements response
+     * @throws {APIError} When the request fails or user is not authenticated
+     *
+     * @example
+     * ```typescript
+     * // Get first page with default limit (20)
+     * const movements = await profileAPI.getUserMovements();
+     * console.log(`Total movements: ${movements.total_count}`);
+     *
+     * // Get second page with custom limit
+     * const page2 = await profileAPI.getUserMovements({ page: 2, limit: 50 });
+     * console.log(`Page ${page2.page} of ${page2.total_pages}`);
+     * ```
+     */
+    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 (default: 20)
+     * @param params.offset - Number of items to skip (default: 0)
+     * @returns Promise resolving to paginated balances response
+     * @throws {APIError} When the request fails or user is not authenticated
+     *
+     * @example
+     * ```typescript
+     * // Get first 20 balances (default limit)
+     * const balances = await profileAPI.getUserBalances();
+     * console.log(`Total balances: ${balances.total}`);
+     * balances.balances.forEach(balance => {
+     *   console.log(`${balance.symbol}: ${balance.available_balance}`);
+     * });
+     *
+     * // Get next 50 balances with offset
+     * const nextBalances = await profileAPI.getUserBalances({ limit: 50, offset: 20 });
+     * console.log(`Returned ${nextBalances.balances.length} balances`);
+     * ```
+     */
+    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
+     * @throws {APIError} When the request fails, user is not authenticated, or asset not found (404)
+     *
+     * @example
+     * ```typescript
+     * // Get balance for a specific asset
+     * const balance = await profileAPI.getUserBalanceByAssetId('123e4567-e89b-12d3-a456-426614174000');
+     * console.log(`${balance.symbol}: ${balance.available_balance}`);
+     * console.log(`Locked: ${balance.locked_balance}`);
+     * console.log(`Total: ${balance.total_balance}`);
+     * ```
+     */
+    getUserBalanceByAssetId(assetId: string): Promise<AccountBalance>;
+}
+//# sourceMappingURL=api.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../../src/api/profile/api.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EACV,cAAc,EACd,iCAAiC,EACjC,qBAAqB,EACrB,uBAAuB,EACvB,sBAAsB,EACtB,UAAU,EACV,WAAW,EACZ,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAElC,qBAAa,cAAe,SAAQ,OAAQ,YAAW,UAAU;IAC/D;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACG,UAAU,IAAI,OAAO,CAAC,WAAW,CAAC;IAgBxC;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACG,yBAAyB,CAAC,MAAM,CAAC,EAAE,sBAAsB,GAAG,OAAO,CAAC,iCAAiC,CAAC;IAgB5G;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACG,eAAe,CAAC,MAAM,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,uBAAuB,CAAC;IAgBvF;;;;;;;;;;;;;;;;;;OAkBG;IACG,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;CASxE"}

package/dist/api/profile/api.js

@@ -0,0 +1,162 @@
+/**
+ * Profile API Implementation
+ *
+ * Handles user profile operations including fetching profile information.
+ * All operations use JWT authentication and go through the API Gateway.
+ *
+ * This class provides a complete interface for profile operations on the Monaco protocol,
+ * including fetching user profile data from the /api/v1/accounts/me endpoint.
+ *
+ * @example
+ * ```typescript
+ * const profileAPI = new ProfileAPIImpl(apiUrl);
+ * profileAPI.setAccessToken(jwtToken);
+ *
+ * // Get user profile
+ * const profile = await profileAPI.getProfile();
+ * console.log(`User: ${profile.username} (${profile.address})`);
+ * ```
+ */
+import { APIError } from "../../errors";
+import { BaseAPI } from "../base";
+export class ProfileAPIImpl 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
+     * @throws {APIError} When the request fails or user is not authenticated
+     *
+     * @example
+     * ```typescript
+     * // Set access token first
+     * profileAPI.setAccessToken(authResult.accessToken);
+     *
+     * // Get profile
+     * const profile = await profileAPI.getProfile();
+     * console.log(`User ID: ${profile.id}`);
+     * console.log(`Address: ${profile.address}`);
+     * console.log(`Username: ${profile.username}`);
+     * console.log(`Account type: ${profile.account_type}`);
+     * console.log(`Can withdraw: ${profile.can_withdraw}`);
+     * ```
+     */
+    async getProfile() {
+        const data = await this.makeAuthenticatedRequest("/api/v1/accounts/me");
+        return {
+            id: data.id,
+            address: data.address,
+            username: data.username,
+            account_type: data.account_type,
+            can_withdraw: data.can_withdraw,
+            created_at: data.created_at,
+            balances: data.balances || [],
+            recent_movements: data.recent_movements || [],
+            recent_orders: data.recent_orders || [],
+        };
+    }
+    /**
+     * 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, default: 1)
+     * @param params.limit - Number of items per page (default: 20, max: 100)
+     * @returns Promise resolving to paginated movements response
+     * @throws {APIError} When the request fails or user is not authenticated
+     *
+     * @example
+     * ```typescript
+     * // Get first page with default limit (20)
+     * const movements = await profileAPI.getUserMovements();
+     * console.log(`Total movements: ${movements.total_count}`);
+     *
+     * // Get second page with custom limit
+     * const page2 = await profileAPI.getUserMovements({ page: 2, limit: 50 });
+     * console.log(`Page ${page2.page} of ${page2.total_pages}`);
+     * ```
+     */
+    async getPaginatedUserMovements(params) {
+        const searchParams = new URLSearchParams();
+        if (params?.page !== undefined) {
+            searchParams.append("page", params.page.toString());
+        }
+        if (params?.limit !== undefined) {
+            searchParams.append("limit", params.limit.toString());
+        }
+        const queryString = searchParams.toString();
+        const url = queryString ? `/api/v1/accounts/movements?${queryString}` : "/api/v1/accounts/movements";
+        return await this.makeAuthenticatedRequest(url);
+    }
+    /**
+     * 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 (default: 20)
+     * @param params.offset - Number of items to skip (default: 0)
+     * @returns Promise resolving to paginated balances response
+     * @throws {APIError} When the request fails or user is not authenticated
+     *
+     * @example
+     * ```typescript
+     * // Get first 20 balances (default limit)
+     * const balances = await profileAPI.getUserBalances();
+     * console.log(`Total balances: ${balances.total}`);
+     * balances.balances.forEach(balance => {
+     *   console.log(`${balance.symbol}: ${balance.available_balance}`);
+     * });
+     *
+     * // Get next 50 balances with offset
+     * const nextBalances = await profileAPI.getUserBalances({ limit: 50, offset: 20 });
+     * console.log(`Returned ${nextBalances.balances.length} balances`);
+     * ```
+     */
+    async getUserBalances(params) {
+        const searchParams = new URLSearchParams();
+        if (params?.limit !== undefined) {
+            searchParams.append("limit", params.limit.toString());
+        }
+        if (params?.offset !== undefined) {
+            searchParams.append("offset", params.offset.toString());
+        }
+        const queryString = searchParams.toString();
+        const url = queryString ? `/api/v1/accounts/balances?${queryString}` : "/api/v1/accounts/balances";
+        return await this.makeAuthenticatedRequest(url);
+    }
+    /**
+     * 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
+     * @throws {APIError} When the request fails, user is not authenticated, or asset not found (404)
+     *
+     * @example
+     * ```typescript
+     * // Get balance for a specific asset
+     * const balance = await profileAPI.getUserBalanceByAssetId('123e4567-e89b-12d3-a456-426614174000');
+     * console.log(`${balance.symbol}: ${balance.available_balance}`);
+     * console.log(`Locked: ${balance.locked_balance}`);
+     * console.log(`Total: ${balance.total_balance}`);
+     * ```
+     */
+    async getUserBalanceByAssetId(assetId) {
+        if (!assetId || assetId.trim() === "") {
+            throw new APIError("assetId is required and cannot be empty", {
+                endpoint: "/api/v1/accounts/balances/{asset_id}",
+            });
+        }
+        const url = `/api/v1/accounts/balances/${assetId}`;
+        return await this.makeAuthenticatedRequest(url);
+    }
+}
+//# sourceMappingURL=api.js.map

package/dist/api/profile/api.js.map

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

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

@@ -0,0 +1,7 @@
+/**
+ * Profile API Module
+ *
+ * Exports the ProfileAPI implementation for user profile operations.
+ */
+export * from "./api";
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/api/profile/index.js

@@ -0,0 +1,7 @@
+/**
+ * Profile API Module
+ *
+ * Exports the ProfileAPI implementation for user profile operations.
+ */
+export * from "./api";
+//# sourceMappingURL=index.js.map

package/dist/api/profile/index.js.map

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

package/dist/api/trades/api.d.ts

@@ -0,0 +1,45 @@
+import type { TradeEvent } from "@0xmonaco/types";
+import { BaseAPI } from "../base";
+/**
+ * Raw trade event from the API (snake_case) - matches websocket structure
+ */
+interface RawTradeEvent {
+    event_type: string;
+    pair_id: string;
+    trading_mode: string;
+    data: {
+        trade_id: string;
+        price: string;
+        quantity: string;
+        maker_side: string;
+        executed_at: string;
+    };
+}
+/**
+ * Convert a raw trade event (snake_case) to a TradeEvent (camelCase)
+ */
+export declare function parseRawTradeEvent(raw: RawTradeEvent): TradeEvent;
+/**
+ * Options for fetching trades
+ */
+export interface GetTradesOptions {
+    /** Number of records to skip (default: 0) */
+    skip?: number;
+    /** Maximum number of records to return (default: 25, max: 100) */
+    limit?: number;
+}
+/**
+ * Trades API for fetching historical trade data
+ */
+export declare class TradesAPIImpl extends BaseAPI {
+    /**
+     * Get historical trades for a trading pair
+     *
+     * @param tradingPairId - The trading pair UUID
+     * @param options - Pagination options
+     * @returns Array of TradeEvent records sorted by executed_at descending (newest first)
+     */
+    getTrades(tradingPairId: string, options?: GetTradesOptions): Promise<TradeEvent[]>;
+}
+export {};
+//# sourceMappingURL=api.d.ts.map

package/dist/api/trades/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../../src/api/trades/api.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAElC;;GAEG;AACH,UAAU,aAAa;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE;QACJ,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,EAAE,MAAM,CAAC;QACnB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;CACH;AAcD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,aAAa,GAAG,UAAU,CAajE;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,6CAA6C;IAC7C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,kEAAkE;IAClE,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,qBAAa,aAAc,SAAQ,OAAO;IACxC;;;;;;OAMG;IACG,SAAS,CAAC,aAAa,EAAE,MAAM,EAAE,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;CAe9F"}

package/dist/api/trades/api.js

@@ -0,0 +1,43 @@
+import { BaseAPI } from "../base";
+/**
+ * Convert a raw trade event (snake_case) to a TradeEvent (camelCase)
+ */
+export function parseRawTradeEvent(raw) {
+    return {
+        eventType: "trade",
+        tradingPairId: raw.pair_id,
+        tradingMode: raw.trading_mode.toUpperCase(),
+        data: {
+            tradeId: raw.data.trade_id,
+            price: raw.data.price,
+            quantity: raw.data.quantity,
+            makerSide: raw.data.maker_side.toUpperCase(),
+            executedAt: raw.data.executed_at,
+        },
+    };
+}
+/**
+ * Trades API for fetching historical trade data
+ */
+export class TradesAPIImpl extends BaseAPI {
+    /**
+     * Get historical trades for a trading pair
+     *
+     * @param tradingPairId - The trading pair UUID
+     * @param options - Pagination options
+     * @returns Array of TradeEvent records sorted by executed_at descending (newest first)
+     */
+    async getTrades(tradingPairId, options = {}) {
+        const { skip = 0 } = options;
+        // Ensure limit is a positive number between 1 and 100, defaulting to 25
+        const limit = options.limit != null && options.limit > 0 ? Math.min(options.limit, 100) : 25;
+        const params = new URLSearchParams();
+        if (skip > 0) {
+            params.set("skip", String(skip));
+        }
+        params.set("limit", String(limit));
+        const response = await this.makePublicRequest(`/api/v1/trades/${encodeURIComponent(tradingPairId)}?${params.toString()}`);
+        return response.data.trades.map(parseRawTradeEvent);
+    }
+}
+//# sourceMappingURL=api.js.map

package/dist/api/trades/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../../../src/api/trades/api.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AA8BlC;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,GAAkB;IACnD,OAAO;QACL,SAAS,EAAE,OAAO;QAClB,aAAa,EAAE,GAAG,CAAC,OAAO;QAC1B,WAAW,EAAE,GAAG,CAAC,YAAY,CAAC,WAAW,EAA+B;QACxE,IAAI,EAAE;YACJ,OAAO,EAAE,GAAG,CAAC,IAAI,CAAC,QAAQ;YAC1B,KAAK,EAAE,GAAG,CAAC,IAAI,CAAC,KAAK;YACrB,QAAQ,EAAE,GAAG,CAAC,IAAI,CAAC,QAAQ;YAC3B,SAAS,EAAE,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,WAAW,EAAqC;YAC/E,UAAU,EAAE,GAAG,CAAC,IAAI,CAAC,WAAW;SACjC;KACF,CAAC;AACJ,CAAC;AAYD;;GAEG;AACH,MAAM,OAAO,aAAc,SAAQ,OAAO;IACxC;;;;;;OAMG;IACH,KAAK,CAAC,SAAS,CAAC,aAAqB,EAAE,UAA4B,EAAE;QACnE,MAAM,EAAE,IAAI,GAAG,CAAC,EAAE,GAAG,OAAO,CAAC;QAC7B,wEAAwE;QACxE,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,IAAI,IAAI,OAAO,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAE7F,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;QACrC,IAAI,IAAI,GAAG,CAAC,EAAE,CAAC;YACb,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;QACnC,CAAC;QACD,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QAEnC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,iBAAiB,CAAoB,kBAAkB,kBAAkB,CAAC,aAAa,CAAC,IAAI,MAAM,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QAE7I,OAAO,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;IACtD,CAAC;CACF"}

package/dist/api/trades/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./api";
+//# sourceMappingURL=index.d.ts.map

package/dist/api/trades/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/api/trades/index.ts"],"names":[],"mappings":"AAAA,cAAc,OAAO,CAAC"}

package/dist/api/trades/index.js

@@ -0,0 +1,2 @@
+export * from "./api";
+//# sourceMappingURL=index.js.map

package/dist/api/trades/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/api/trades/index.ts"],"names":[],"mappings":"AAAA,cAAc,OAAO,CAAC"}