@0xmonaco/core 1.0.97 → 1.0.99

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

@@ -2,7 +2,8 @@
  * Fees API Implementation
  *
  * Handles fee simulation and calculation operations.
- * All operations use JWT authentication and go through the API Gateway.
+ * Every operation except `getFeeSchedule` is session-key authenticated;
+ * `getFeeSchedule` is a public read and sends no credentials.
  *
  * This class provides a complete interface for fee-related operations on the Monaco protocol,
  * including simulating fees before placing orders.
@@ -21,7 +22,7 @@
  * });
  * ```
  */
-import type { FeesAPI, GetMyFeeTierParams, GetMyFeeTierResponse, SimulateFeeParams, SimulateFeeResponse } from "@0xmonaco/types";
+import type { FeesAPI, GetFeeScheduleResponse, GetMyFeeTierParams, GetMyFeeTierResponse, SimulateFeeParams, SimulateFeeResponse } from "@0xmonaco/types";
 import { BaseAPI } from "../base";
 export declare class FeesAPIImpl extends BaseAPI implements FeesAPI {
     /**
@@ -96,4 +97,25 @@ export declare class FeesAPIImpl extends BaseAPI implements FeesAPI {
      * ```
      */
     getMyFeeTier(params: GetMyFeeTierParams): Promise<GetMyFeeTierResponse>;
+    /**
+     * Get a trading pair's fee tier schedule. Public: sends no credentials, so it
+     * works before sign-in.
+     *
+     * Returns the pair's Monaco fee schedule ordered by tier level: each row's
+     * weighted 14-day volume threshold and its maker/taker fee in basis points
+     * (a negative maker fee is a rebate). Your own tier and rate come from
+     * {@link FeesAPIImpl.getMyFeeTier}.
+     *
+     * @param tradingPairId - Trading pair whose fee schedule to return
+     * @returns Promise resolving to the pair's fee tier schedule
+     *
+     * @example
+     * ```typescript
+     * const { feeSchedule } = await feesAPI.getFeeSchedule("123e4567-e89b-12d3-a456-426614174000");
+     * for (const row of feeSchedule) {
+     *   console.log(`Tier ${row.tierLevel}: maker ${row.makerFeeBps} bps, taker ${row.takerFeeBps} bps`);
+     * }
+     * ```
+     */
+    getFeeSchedule(tradingPairId: string): Promise<GetFeeScheduleResponse>;
 }

package/dist/api/fees/api.js

@@ -2,7 +2,8 @@
  * Fees API Implementation
  *
  * Handles fee simulation and calculation operations.
- * All operations use JWT authentication and go through the API Gateway.
+ * Every operation except `getFeeSchedule` is session-key authenticated;
+ * `getFeeSchedule` is a public read and sends no credentials.
  *
  * This class provides a complete interface for fee-related operations on the Monaco protocol,
  * including simulating fees before placing orders.
@@ -21,7 +22,7 @@
  * });
  * ```
  */
-import { GetMyFeeTierParamsSchema, SimulateFeeParamsSchema, validate } from "@0xmonaco/types";
+import { GetFeeScheduleParamsSchema, GetMyFeeTierParamsSchema, SimulateFeeParamsSchema, validate } from "@0xmonaco/types";
 import { BaseAPI } from "../base";
 export class FeesAPIImpl extends BaseAPI {
     /**
@@ -122,4 +123,30 @@ export class FeesAPIImpl extends BaseAPI {
             method: "GET",
         });
     }
+    /**
+     * Get a trading pair's fee tier schedule. Public: sends no credentials, so it
+     * works before sign-in.
+     *
+     * Returns the pair's Monaco fee schedule ordered by tier level: each row's
+     * weighted 14-day volume threshold and its maker/taker fee in basis points
+     * (a negative maker fee is a rebate). Your own tier and rate come from
+     * {@link FeesAPIImpl.getMyFeeTier}.
+     *
+     * @param tradingPairId - Trading pair whose fee schedule to return
+     * @returns Promise resolving to the pair's fee tier schedule
+     *
+     * @example
+     * ```typescript
+     * const { feeSchedule } = await feesAPI.getFeeSchedule("123e4567-e89b-12d3-a456-426614174000");
+     * for (const row of feeSchedule) {
+     *   console.log(`Tier ${row.tierLevel}: maker ${row.makerFeeBps} bps, taker ${row.takerFeeBps} bps`);
+     * }
+     * ```
+     */
+    async getFeeSchedule(tradingPairId) {
+        const validatedParams = validate(GetFeeScheduleParamsSchema, { tradingPairId });
+        const searchParams = new URLSearchParams();
+        searchParams.append("tradingPairId", validatedParams.tradingPairId);
+        return await this.makePublicRequest(`/api/v1/fees/schedule?${searchParams.toString()}`);
+    }
 }

package/dist/api/websocket/websocket.js

@@ -911,8 +911,9 @@ function parseBalanceSnapshotItem(raw) {
  * `Option`s serialized without `skip_serializing_if`, so the key is always
  * present carrying `null`. The fields the server omits outright
  * (`clientOrderId`, `selfTradePreventionMode`, `parentOrderId`, `postOnly`,
- * `expirationDate`, `triggerPrice`, `positionSide`, `version` and `origin`) are
- * read as optional and spread in only when present.
+ * `expirationDate`, `triggerPrice`, `positionSide`, `version`, `origin`,
+ * `placementTakerFeeBps` and `placementMakerFeeBps`) are read as optional and
+ * spread in only when present.
  */
 function parseOrderSnapshotItem(raw) {
     if (!isRecord(raw)) {
@@ -931,6 +932,8 @@ function parseOrderSnapshotItem(raw) {
     const positionSide = readOptionalString(item, "positionSide");
     const version = readOptionalNumber(item, "version");
     const origin = readOptionalString(item, "origin");
+    const placementTakerFeeBps = readOptionalString(item, "placementTakerFeeBps");
+    const placementMakerFeeBps = readOptionalString(item, "placementMakerFeeBps");
     return {
         orderId: readString(item, "orderId"),
         userId: readString(item, "userId"),
@@ -982,6 +985,10 @@ function parseOrderSnapshotItem(raw) {
         // origin passes through rather than dropping the row, and absent stays
         // absent.
         ...(origin === undefined ? {} : { origin }),
+        // The Monaco fee rates fixed at placement. Omitted for an order placed
+        // before rates were stored, and absent must stay absent: never "0".
+        ...(placementTakerFeeBps === undefined ? {} : { placementTakerFeeBps }),
+        ...(placementMakerFeeBps === undefined ? {} : { placementMakerFeeBps }),
     };
 }
 /**
@@ -1794,17 +1801,17 @@ export function createMonacoWebSocket(baseUrl, options = {}, serverClock = new S
     const subscribeOHLCV = (tradingPairId, tradingMode, interval, handler, priceType, onSnapshot) => {
         // Four-token channel selects the trade-derived candles (back-compat); the
         // optional fifth token selects the price series (`mark` = close-only mark
-        // series, `*` = both).
+        // series, `reference` = mark-price OHLC with no volume, `*` = all).
         const channel = priceType === undefined ? `ohlcv:${tradingPairId}:${tradingMode}:${interval}` : `ohlcv:${tradingPairId}:${tradingMode}:${interval}:${priceType}`;
         return subscribe(channel, (rawData) => {
             try {
                 const data = rawData;
                 const ohlcvData = data.data;
-                // Concrete price series of this candle (`trade`/`mark`). Present on
-                // every current frame; a wildcard (`*`) subscriber reads it to tell the
-                // two streams apart. Omitted when a legacy frame carries no `price_type`.
+                // Concrete price series of this candle (`trade`/`mark`/`reference`).
+                // Present on every current frame; a wildcard (`*`) subscriber reads it
+                // to tell the streams apart. Omitted when a legacy frame carries no `price_type`.
                 //
-                // Passed through rather than matched against the two known values: a
+                // Passed through rather than matched against the known values: a
                 // wildcard subscription accepts any suffix, so a series added
                 // server-side after this version reaches this parser, and reporting it
                 // as `undefined` would leave a wildcard subscriber unable to do the one

package/dist/coverage.d.ts

@@ -56,6 +56,7 @@ export declare const COVERED: {
     get_market_metadata: string;
     get_market_stats: string;
     get_my_fee_tier: string;
+    get_fee_schedule: string;
     get_pulse: string;
     get_region_status: string;
     list_managed_market_assignments: string;

package/dist/coverage.js

@@ -56,6 +56,7 @@ export const COVERED = {
     get_market_metadata: "getMarketMetadata",
     get_market_stats: "getMarketStats",
     get_my_fee_tier: "getMyFeeTier",
+    get_fee_schedule: "getFeeSchedule",
     get_pulse: "pulse.getPulse",
     get_region_status: "compliance.getRegionStatus",
     list_managed_market_assignments: "managedMarkets.listAssignments",

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@0xmonaco/core",
-	"version": "1.0.97",
+	"version": "1.0.99",
 	"type": "module",
 	"homepage": "https://docs.0xmonaco.com/sdk/typescript",
 	"main": "./dist/index.js",
@@ -19,8 +19,8 @@
 		"viem": "^2.45.2"
 	},
 	"dependencies": {
-		"@0xmonaco/contracts": "1.0.97",
-		"@0xmonaco/types": "1.0.97",
+		"@0xmonaco/contracts": "1.0.99",
+		"@0xmonaco/types": "1.0.99",
 		"@noble/curves": "^2.4.0",
 		"@noble/hashes": "^2.4.0",
 		"http-status-codes": "^2.3.0"