@0xmonaco/core 0.0.0-develop-20260318132113 → 0.0.0-develop-20260412233650

package/README.md

@@ -125,7 +125,7 @@ async function authExample() {
   console.log("Authenticated:", authState.user);
   console.log("Tokens:", {
     accessToken: authState.accessToken,
-    refreshToken: authState.refreshToken, // Use this for revokeToken()
+    refreshToken: authState.refreshToken,
   });
   
   // Authenticated WebSocket channels are now connected - start receiving real-time updates
@@ -141,8 +141,7 @@ async function authExample() {
   await monaco.logout();
   
   // Or manually revoke the token
-  // ✅ CORRECT: Use authState.refreshToken
-  await monaco.auth.revokeToken(authState.refreshToken);
+  await monaco.auth.revokeToken();
 }
 
 // Market Data
@@ -277,11 +276,9 @@ interface AuthState {
 }
 ```
 
-**⚠️ Important:** The authentication response contains `refreshToken`, NOT `revokeToken`.
-
 ```typescript
-// ✅ CORRECT: Revoke using refreshToken
-await sdk.auth.revokeToken(authState.refreshToken);
+// Revoke the current session's token
+await sdk.auth.revokeToken();
 
 // 💡 TIP: Use the built-in logout method
 await sdk.logout(); // Automatically calls revokeToken internally

package/dist/api/auth/api.d.ts

@@ -182,14 +182,15 @@ export declare class AuthAPIImpl extends BaseAPI implements AuthAPI {
      */
     refreshToken(refreshToken: string): Promise<TokenRefreshResponse>;
     /**
-     * Revokes a refresh token.
+     * Revokes the current session's refresh token.
      *
-     * Invalidates a refresh token, preventing it from being used to obtain
-     * new access tokens. This is useful for logout functionality or when
-     * a token has been compromised.
+     * Invalidates the refresh token associated with the current access token,
+     * preventing it from being used to obtain new access tokens. This is useful
+     * for logout functionality or when a token has been compromised.
+     *
+     * The server identifies the token to revoke from the access token in the
+     * Authorization header — no request body is needed.
      *
-     * **Important:** Pass the `refreshToken` from the authentication response.
-     * @param refreshToken - The refresh token to revoke (from authResult.refreshToken)
      * @returns Promise resolving when the token is revoked
      * @throws {APIError} When token revocation fails
      *
@@ -197,9 +198,9 @@ export declare class AuthAPIImpl extends BaseAPI implements AuthAPI {
      * ```typescript
      * // After authentication
      * const authResult = await authAPI.authenticate(clientId);
-     * await authAPI.revokeToken(authResult.refreshToken);
+     * await authAPI.revokeToken();
      * console.log("Token revoked successfully");
      * ```
      */
-    revokeToken(refreshToken: string): Promise<void>;
+    revokeToken(): Promise<void>;
 }

package/dist/api/auth/api.js

@@ -277,14 +277,15 @@ export class AuthAPIImpl extends BaseAPI {
         };
     }
     /**
-     * Revokes a refresh token.
+     * Revokes the current session's refresh token.
      *
-     * Invalidates a refresh token, preventing it from being used to obtain
-     * new access tokens. This is useful for logout functionality or when
-     * a token has been compromised.
+     * Invalidates the refresh token associated with the current access token,
+     * preventing it from being used to obtain new access tokens. This is useful
+     * for logout functionality or when a token has been compromised.
+     *
+     * The server identifies the token to revoke from the access token in the
+     * Authorization header — no request body is needed.
      *
-     * **Important:** Pass the `refreshToken` from the authentication response.
-     * @param refreshToken - The refresh token to revoke (from authResult.refreshToken)
      * @returns Promise resolving when the token is revoked
      * @throws {APIError} When token revocation fails
      *
@@ -292,16 +293,13 @@ export class AuthAPIImpl extends BaseAPI {
      * ```typescript
      * // After authentication
      * const authResult = await authAPI.authenticate(clientId);
-     * await authAPI.revokeToken(authResult.refreshToken);
+     * await authAPI.revokeToken();
      * console.log("Token revoked successfully");
      * ```
      */
-    async revokeToken(refreshToken) {
+    async revokeToken() {
         await this.makeAuthenticatedRequest("/api/v1/auth/revoke", {
             method: "POST",
-            body: JSON.stringify({
-                refresh_token: refreshToken,
-            }),
         });
     }
 }

package/dist/api/fees/api.d.ts

@@ -35,6 +35,8 @@ export declare class FeesAPIImpl extends BaseAPI implements FeesAPI {
      * @param params.side - The order side ("BUY" or "SELL")
      * @param params.price - The price per unit as string
      * @param params.quantity - The quantity to trade as string
+     * @param params.order_type - Order type: "LIMIT" (default) or "MARKET"
+     * @param params.slippage_tolerance_bps - Slippage tolerance in bps (0–1000, MARKET only, default 500)
      * @returns Promise resolving to SimulateFeeResponse with fee breakdown
      *
      * @example

package/dist/api/fees/api.js

@@ -35,6 +35,8 @@ export class FeesAPIImpl extends BaseAPI {
      * @param params.side - The order side ("BUY" or "SELL")
      * @param params.price - The price per unit as string
      * @param params.quantity - The quantity to trade as string
+     * @param params.order_type - Order type: "LIMIT" (default) or "MARKET"
+     * @param params.slippage_tolerance_bps - Slippage tolerance in bps (0–1000, MARKET only, default 500)
      * @returns Promise resolving to SimulateFeeResponse with fee breakdown
      *
      * @example
@@ -74,6 +76,12 @@ export class FeesAPIImpl extends BaseAPI {
         searchParams.append("side", validatedParams.side);
         searchParams.append("price", validatedParams.price);
         searchParams.append("quantity", validatedParams.quantity);
+        if (validatedParams.order_type !== undefined) {
+            searchParams.append("order_type", validatedParams.order_type);
+        }
+        if (validatedParams.slippage_tolerance_bps !== undefined) {
+            searchParams.append("slippage_tolerance_bps", String(validatedParams.slippage_tolerance_bps));
+        }
         const endpoint = `/api/v1/fees/simulate?${searchParams.toString()}`;
         return await this.makeAuthenticatedRequest(endpoint, {
             method: "GET",

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

@@ -17,7 +17,7 @@
  * console.log(`User: ${profile.username} (${profile.address})`);
  * ```
  */
-import type { AccountBalance, GetPaginatedUserMovementsResponse, GetUserBalancesParams, GetUserBalancesResponse, GetUserMovementsParams, ProfileAPI, UserProfile } from "@0xmonaco/types";
+import type { AccountBalance, GetPaginatedUserMovementsResponse, GetUserBalancesParams, GetUserBalancesResponse, GetUserMovementsParams, GetUserTradesParams, GetUserTradesResponse, PortfolioChartResponse, PortfolioMetric, PortfolioPeriod, PortfolioStats, ProfileAPI, UserProfile } from "@0xmonaco/types";
 import { BaseAPI } from "../base";
 export declare class ProfileAPIImpl extends BaseAPI implements ProfileAPI {
     /**
@@ -124,4 +124,68 @@ export declare class ProfileAPIImpl extends BaseAPI implements ProfileAPI {
      * ```
      */
     getUserBalanceByAssetId(assetId: string): Promise<AccountBalance>;
+    /**
+     * Get the current user's portfolio statistics for a given time period.
+     *
+     * Fetches aggregate stats from the /api/v1/accounts/me/portfolio endpoint.
+     * Requires a valid access token to be set.
+     *
+     * @param period - Time period to scope the stats ("24h" | "7d" | "30d" | "all")
+     * @returns Promise resolving to the user's portfolio statistics
+     * @throws {APIError} When the request fails or user is not authenticated
+     *
+     * @example
+     * ```typescript
+     * const stats = await profileAPI.getPortfolioStats("30d");
+     * console.log(`PnL: ${stats.pnl}`);
+     * console.log(`Volume: ${stats.volume}`);
+     * console.log(`Total equity: ${stats.total_equity}`);
+     * ```
+     */
+    getPortfolioStats(period: PortfolioPeriod): Promise<PortfolioStats>;
+    /**
+     * Get the current user's portfolio chart time series for a given period and metric.
+     *
+     * Fetches bucketed time series data from the /api/v1/accounts/me/portfolio/chart endpoint.
+     * Requires a valid access token to be set.
+     *
+     * @param period - Time period ("24h" | "7d" | "30d" | "all")
+     * @param metric - Metric to chart ("volume" | "pnl")
+     * @returns Promise resolving to the portfolio chart response
+     * @throws {APIError} When the request fails or user is not authenticated
+     *
+     * @example
+     * ```typescript
+     * const chart = await profileAPI.getPortfolioChart("7d", "pnl");
+     * chart.data.forEach(point => {
+     *   console.log(`${point.timestamp}: ${point.value}`);
+     * });
+     * ```
+     */
+    getPortfolioChart(period: PortfolioPeriod, metric: PortfolioMetric): Promise<PortfolioChartResponse>;
+    /**
+     * Get the current user's trade history with pagination.
+     *
+     * Fetches the user's executed trades from the /api/v1/accounts/trades endpoint.
+     * Requires a valid access token to be set.
+     *
+     * @param params - Optional query parameters for pagination and filtering
+     * @param params.page - Page number (starts from 1, default: 1)
+     * @param params.limit - Number of items per page (default: 20, max: 100)
+     * @param params.trading_pair_id - Filter by trading pair ID (UUID)
+     * @returns Promise resolving to paginated trades response
+     * @throws {ValidationError} When the provided params fail client-side validation
+     * @throws {APIError} When the request fails or user is not authenticated
+     *
+     * @example
+     * ```typescript
+     * // Get first page of trades
+     * const trades = await profileAPI.getUserTrades();
+     * console.log(`Total trades: ${trades.total_count}`);
+     *
+     * // Filter by trading pair
+     * const pairTrades = await profileAPI.getUserTrades({ trading_pair_id: "550e8400-e29b-41d4-a716-446655440000" });
+     * ```
+     */
+    getUserTrades(params?: GetUserTradesParams): Promise<GetUserTradesResponse>;
 }

package/dist/api/profile/api.js

@@ -17,7 +17,7 @@
  * console.log(`User: ${profile.username} (${profile.address})`);
  * ```
  */
-import { GetUserMovementsSchema, validate } from "@0xmonaco/types";
+import { GetUserMovementsSchema, GetUserTradesSchema, validate } from "@0xmonaco/types";
 import { APIError } from "../../errors";
 import { BaseAPI } from "../base";
 export class ProfileAPIImpl extends BaseAPI {
@@ -169,4 +169,91 @@ export class ProfileAPIImpl extends BaseAPI {
         const url = `/api/v1/accounts/balances/${assetId}`;
         return await this.makeAuthenticatedRequest(url);
     }
+    /**
+     * Get the current user's portfolio statistics for a given time period.
+     *
+     * Fetches aggregate stats from the /api/v1/accounts/me/portfolio endpoint.
+     * Requires a valid access token to be set.
+     *
+     * @param period - Time period to scope the stats ("24h" | "7d" | "30d" | "all")
+     * @returns Promise resolving to the user's portfolio statistics
+     * @throws {APIError} When the request fails or user is not authenticated
+     *
+     * @example
+     * ```typescript
+     * const stats = await profileAPI.getPortfolioStats("30d");
+     * console.log(`PnL: ${stats.pnl}`);
+     * console.log(`Volume: ${stats.volume}`);
+     * console.log(`Total equity: ${stats.total_equity}`);
+     * ```
+     */
+    async getPortfolioStats(period) {
+        const searchParams = new URLSearchParams({ period });
+        return await this.makeAuthenticatedRequest(`/api/v1/accounts/me/portfolio?${searchParams}`);
+    }
+    /**
+     * Get the current user's portfolio chart time series for a given period and metric.
+     *
+     * Fetches bucketed time series data from the /api/v1/accounts/me/portfolio/chart endpoint.
+     * Requires a valid access token to be set.
+     *
+     * @param period - Time period ("24h" | "7d" | "30d" | "all")
+     * @param metric - Metric to chart ("volume" | "pnl")
+     * @returns Promise resolving to the portfolio chart response
+     * @throws {APIError} When the request fails or user is not authenticated
+     *
+     * @example
+     * ```typescript
+     * const chart = await profileAPI.getPortfolioChart("7d", "pnl");
+     * chart.data.forEach(point => {
+     *   console.log(`${point.timestamp}: ${point.value}`);
+     * });
+     * ```
+     */
+    async getPortfolioChart(period, metric) {
+        const searchParams = new URLSearchParams({ period, metric });
+        return await this.makeAuthenticatedRequest(`/api/v1/accounts/me/portfolio/chart?${searchParams}`);
+    }
+    /**
+     * Get the current user's trade history with pagination.
+     *
+     * Fetches the user's executed trades from the /api/v1/accounts/trades endpoint.
+     * Requires a valid access token to be set.
+     *
+     * @param params - Optional query parameters for pagination and filtering
+     * @param params.page - Page number (starts from 1, default: 1)
+     * @param params.limit - Number of items per page (default: 20, max: 100)
+     * @param params.trading_pair_id - Filter by trading pair ID (UUID)
+     * @returns Promise resolving to paginated trades response
+     * @throws {ValidationError} When the provided params fail client-side validation
+     * @throws {APIError} When the request fails or user is not authenticated
+     *
+     * @example
+     * ```typescript
+     * // Get first page of trades
+     * const trades = await profileAPI.getUserTrades();
+     * console.log(`Total trades: ${trades.total_count}`);
+     *
+     * // Filter by trading pair
+     * const pairTrades = await profileAPI.getUserTrades({ trading_pair_id: "550e8400-e29b-41d4-a716-446655440000" });
+     * ```
+     */
+    async getUserTrades(params) {
+        if (params) {
+            validate(GetUserTradesSchema, 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?.trading_pair_id !== undefined) {
+            searchParams.append("trading_pair_id", params.trading_pair_id);
+        }
+        const queryString = searchParams.toString();
+        const url = queryString ? `/api/v1/accounts/trades?${queryString}` : "/api/v1/accounts/trades";
+        return await this.makeAuthenticatedRequest(url);
+    }
 }

package/dist/sdk.d.ts

@@ -31,8 +31,8 @@ export declare class MonacoSDKImpl implements MonacoSDK {
      * - `expiresAt`: When the access token expires
      * - `user`: User information
      *
-     * Note: There is NO separate `revokeToken` property. Use `authState.refreshToken`
-     * when calling `auth.revokeToken()` or just call `sdk.logout()`.
+     * Note: Use `sdk.logout()` to revoke the token and clean up, or call
+     * `sdk.auth.revokeToken()` directly to just revoke.
      *
      * @param clientId - The client ID for authentication
      * @param options - Optional configuration
@@ -50,7 +50,7 @@ export declare class MonacoSDKImpl implements MonacoSDK {
      * await sdk.ws.connect();
      *
      * // Later, to revoke:
-     * await sdk.auth.revokeToken(authState.refreshToken); // ✅
+     * await sdk.auth.revokeToken(); // ✅
      * // Or revoke and disconnect WebSocket:
      * await sdk.logout(); // ✅ Calls revokeToken internally and disconnects WebSocket
      * ```
@@ -76,7 +76,7 @@ export declare class MonacoSDKImpl implements MonacoSDK {
      *
      * This method revokes the refresh token (if available), disconnects all authenticated
      * WebSocket channels, and clears the local auth state.
-     * It internally calls `auth.revokeToken(refreshToken)` to invalidate the token on the server.
+     * It internally calls `auth.revokeToken()` to invalidate the token on the server.
      *
      * @example
      * ```typescript

package/dist/sdk.js

@@ -99,8 +99,8 @@ export class MonacoSDKImpl {
      * - `expiresAt`: When the access token expires
      * - `user`: User information
      *
-     * Note: There is NO separate `revokeToken` property. Use `authState.refreshToken`
-     * when calling `auth.revokeToken()` or just call `sdk.logout()`.
+     * Note: Use `sdk.logout()` to revoke the token and clean up, or call
+     * `sdk.auth.revokeToken()` directly to just revoke.
      *
      * @param clientId - The client ID for authentication
      * @param options - Optional configuration
@@ -118,7 +118,7 @@ export class MonacoSDKImpl {
      * await sdk.ws.connect();
      *
      * // Later, to revoke:
-     * await sdk.auth.revokeToken(authState.refreshToken); // ✅
+     * await sdk.auth.revokeToken(); // ✅
      * // Or revoke and disconnect WebSocket:
      * await sdk.logout(); // ✅ Calls revokeToken internally and disconnects WebSocket
      * ```
@@ -161,7 +161,7 @@ export class MonacoSDKImpl {
      *
      * This method revokes the refresh token (if available), disconnects all authenticated
      * WebSocket channels, and clears the local auth state.
-     * It internally calls `auth.revokeToken(refreshToken)` to invalidate the token on the server.
+     * It internally calls `auth.revokeToken()` to invalidate the token on the server.
      *
      * @example
      * ```typescript
@@ -172,7 +172,7 @@ export class MonacoSDKImpl {
     async logout() {
         if (this.authState?.refreshToken) {
             try {
-                await this.auth.revokeToken(this.authState.refreshToken);
+                await this.auth.revokeToken();
             }
             catch (error) {
                 // Log but don't throw - we want to clear the local state regardless

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@0xmonaco/core",
-	"version": "0.0.0-develop-20260318132113",
+	"version": "0.0.0-develop-20260412233650",
 	"type": "module",
 	"repository": {
 		"type": "git",
@@ -14,7 +14,7 @@
 		"dist"
 	],
 	"scripts": {
-		"build": "tsc -b --force",
+		"build": "tsc -b",
 		"dev": "tsc --watch",
 		"clean": "rm -rf dist",
 		"lint": "biome lint ."
@@ -23,8 +23,8 @@
 		"viem": "^2.45.2"
 	},
 	"dependencies": {
-		"@0xmonaco/contracts": "0.0.0-develop-20260318132113",
-		"@0xmonaco/types": "0.0.0-develop-20260318132113",
+		"@0xmonaco/contracts": "0.0.0-develop-20260412233650",
+		"@0xmonaco/types": "0.0.0-develop-20260412233650",
 		"http-status-codes": "^2.3.0"
 	},
 	"devDependencies": {