@0xmonaco/core 1.0.70 → 1.0.73-develop.af0f5d0

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

@@ -153,11 +153,13 @@ export declare class AuthAPIImpl extends BaseAPI implements AuthAPI {
      */
     verifySignature(address: string, signature: string, nonce: string, clientId: string, session: SessionCredentials, referralCode?: string): Promise<AuthState>;
     /**
-     * Extends the current session's expiry.
+     * Refreshes the current session's expiry.
      *
      * The request is signed with the active session key (set via
-     * {@link setSessionKeypair}); the server bumps the session's `expiresAt`.
-     * No new credential is issued — the same keypair keeps working.
+     * {@link setSessionKeypair}). For a delegated session, the delegation must
+     * still be active; the returned expiry is capped by its current expiry and
+     * may move earlier if the owner shortened the delegation. No new credential
+     * is issued — the same keypair keeps working.
      *
      * @returns Promise resolving to the new expiry
      * @throws {APIError} When refresh fails (e.g. session expired or revoked)

package/dist/api/auth/api.js

@@ -237,11 +237,13 @@ export class AuthAPIImpl extends BaseAPI {
         };
     }
     /**
-     * Extends the current session's expiry.
+     * Refreshes the current session's expiry.
      *
      * The request is signed with the active session key (set via
-     * {@link setSessionKeypair}); the server bumps the session's `expiresAt`.
-     * No new credential is issued — the same keypair keeps working.
+     * {@link setSessionKeypair}). For a delegated session, the delegation must
+     * still be active; the returned expiry is capped by its current expiry and
+     * may move earlier if the owner shortened the delegation. No new credential
+     * is issued — the same keypair keeps working.
      *
      * @returns Promise resolving to the new expiry
      * @throws {APIError} When refresh fails (e.g. session expired or revoked)

package/dist/api/base.d.ts

@@ -34,10 +34,13 @@ export declare abstract class BaseAPI {
     /** Application secret key (`sk_...`) sent in the `x-server-key` header for backend-authenticated requests. */
     protected serverKey?: string;
     private requestSigning;
+    private redirectPolicy?;
     /** Server time learned from responses; signing timestamps are read from it. */
     protected serverClock: ServerClock;
     /** Opt in only after the target server supports RFC 9421. No automatic downgrade. */
     setRequestSigning(protocol: RequestSigning): void;
+    /** Refuse cross-origin and same-origin redirects when set to `error`. */
+    setRedirectPolicy(policy: "error" | undefined): void;
     protected retryOptions: Required<RetryOptions>;
     /** Share one server clock across API instances so any response calibrates all of them. */
     setServerClock(clock: ServerClock): void;

package/dist/api/base.js

@@ -44,6 +44,7 @@ export class BaseAPI {
     /** Application secret key (`sk_...`) sent in the `x-server-key` header for backend-authenticated requests. */
     serverKey;
     requestSigning = "legacy";
+    redirectPolicy;
     /** Server time learned from responses; signing timestamps are read from it. */
     serverClock = new ServerClock();
     /** Opt in only after the target server supports RFC 9421. No automatic downgrade. */
@@ -52,6 +53,10 @@ export class BaseAPI {
             throw new Error("Unsupported request signing protocol");
         this.requestSigning = protocol;
     }
+    /** Refuse cross-origin and same-origin redirects when set to `error`. */
+    setRedirectPolicy(policy) {
+        this.redirectPolicy = policy;
+    }
     retryOptions;
     /** Share one server clock across API instances so any response calibrates all of them. */
     setServerClock(clock) {
@@ -186,7 +191,7 @@ export class BaseAPI {
         // authenticated, backend, and public request paths.
         const headers = { "User-Agent": SDK_USER_AGENT, ...options.headers };
         try {
-            response = await fetch(url, { ...options, headers });
+            response = await fetch(url, { ...options, headers, ...(this.redirectPolicy ? { redirect: this.redirectPolicy } : {}) });
         }
         catch (error) {
             throw new APIError(`Network request failed for ${endpoint}`, {

package/dist/api/buildercodes/api.d.ts

@@ -19,7 +19,7 @@
  * console.log(`Now tradeable: ${result.tradingBalance}`);
  * ```
  */
-import type { BuildercodesAPI, ClaimBuildercodeRewardsParams, ClaimBuildercodeRewardsResponse, GetBuildercodePayoutSummaryResponse, GetBuildercodeRewardsBalanceResponse, GetBuildercodesConfigResponse, ListBuildercodePayoutsParams, ListBuildercodePayoutsResponse } from "@0xmonaco/types";
+import type { BuildercodesAPI, ClaimBuildercodeRewardsParams, ClaimBuildercodeRewardsResponse, GetBuildercodePayoutSummaryResponse, GetBuildercodeRewardsBalanceResponse, GetBuildercodesConfigResponse, ListBuildercodePayoutsParams, ListBuildercodePayoutsResponse, ListBuilderFeeChangesParams, ListBuilderFeeChangesResponse, SetBuilderFeeParams, SetBuilderFeeResponse } from "@0xmonaco/types";
 import { BaseAPI } from "../base";
 export declare class BuildercodesAPIImpl extends BaseAPI implements BuildercodesAPI {
     /**
@@ -30,11 +30,15 @@ export declare class BuildercodesAPIImpl extends BaseAPI implements Buildercodes
      * application's configured payout address.
      */
     getConfig(): Promise<GetBuildercodesConfigResponse>;
+    /** Set this frontend's builder fee. */
+    setBuilderFee(params: SetBuilderFeeParams): Promise<SetBuilderFeeResponse>;
+    /** List this frontend's builder-fee audit log, newest first. */
+    listBuilderFeeChanges(params?: ListBuilderFeeChangesParams): Promise<ListBuilderFeeChangesResponse>;
     /**
      * List this frontend's per-trade BuilderCodes credits, newest first. Each
-     * credit carries its payout `kind`: `REVENUE_SHARE` (your share of Monaco's
-     * fee) or `BUILDER_FEE` (your builder fee). Pass `kind` to list one stream;
-     * `total` then counts only that stream.
+     * credit carries its payout `kind`: `REVENUE_SHARE` for Monaco revenue share
+     * or `BUILDER_FEE` for builder fees charged to takers. Pass `kind` to filter
+     * the list; `total` then counts only that category.
      *
      * The server scopes every query to the authenticated application; neither
      * the application id nor payout wallet can be supplied by the caller.

package/dist/api/buildercodes/api.js

@@ -19,7 +19,7 @@
  * console.log(`Now tradeable: ${result.tradingBalance}`);
  * ```
  */
-import { ClaimBuildercodeRewardsParamsSchema, ListBuildercodePayoutsParamsSchema, validate } from "@0xmonaco/types";
+import { ClaimBuildercodeRewardsParamsSchema, ListBuildercodePayoutsParamsSchema, ListBuilderFeeChangesParamsSchema, SetBuilderFeeParamsSchema, validate, } from "@0xmonaco/types";
 import { APIError } from "../../errors";
 import { BaseAPI } from "../base";
 /**
@@ -102,11 +102,35 @@ export class BuildercodesAPIImpl extends BaseAPI {
             method: "GET",
         });
     }
+    /** Set this frontend's builder fee. */
+    async setBuilderFee(params) {
+        const validated = validate(SetBuilderFeeParamsSchema, params);
+        return this.makeAuthenticatedRequest("/api/v1/buildercodes/builder-fee", {
+            method: "PUT",
+            body: JSON.stringify({ bps: validated.bps }),
+        });
+    }
+    /** List this frontend's builder-fee audit log, newest first. */
+    async listBuilderFeeChanges(params) {
+        if (params) {
+            validate(ListBuilderFeeChangesParamsSchema, params);
+        }
+        const searchParams = new URLSearchParams();
+        if (params?.pageSize !== undefined) {
+            searchParams.append("pageSize", params.pageSize.toString());
+        }
+        if (params?.pageToken !== undefined) {
+            searchParams.append("pageToken", params.pageToken);
+        }
+        const query = searchParams.toString();
+        const path = query ? `/api/v1/buildercodes/builder-fee/changes?${query}` : "/api/v1/buildercodes/builder-fee/changes";
+        return this.makeAuthenticatedRequest(path, { method: "GET" });
+    }
     /**
      * List this frontend's per-trade BuilderCodes credits, newest first. Each
-     * credit carries its payout `kind`: `REVENUE_SHARE` (your share of Monaco's
-     * fee) or `BUILDER_FEE` (your builder fee). Pass `kind` to list one stream;
-     * `total` then counts only that stream.
+     * credit carries its payout `kind`: `REVENUE_SHARE` for Monaco revenue share
+     * or `BUILDER_FEE` for builder fees charged to takers. Pass `kind` to filter
+     * the list; `total` then counts only that category.
      *
      * The server scopes every query to the authenticated application; neither
      * the application id nor payout wallet can be supplied by the caller.

package/dist/api/copy-trading/api.d.ts

@@ -20,7 +20,7 @@
  * const { followId } = await sdk.copyTrading.upsertFollow({ leader, allocation: "1000", slPct: "0.25" });
  * ```
  */
-import type { CopyTradingAPI, GetFollowResponse, GetLeadTraderResponse, ListFollowLeaderPositionsResponse, ListLeadTraderClosedTradesParams, ListLeadTraderClosedTradesResponse, ListLeadTraderOpenPositionsResponse, ListLeadTradersParams, ListLeadTradersResponse, ListMyFollowersParams, ListMyFollowersResponse, ListMyFollowsParams, ListMyFollowsResponse, PreviewFollowParams, PreviewFollowResponse, StopFollowResponse, UpsertFollowParams, UpsertFollowResponse, UpsertLeadTraderParams, UpsertLeadTraderResponse } from "@0xmonaco/types";
+import type { AddFollowPositionMarginParams, AddFollowPositionMarginResponse, CloseAllCopyPositionsResponse, CloseFollowPositionsResponse, CopyTradingAPI, GetFollowResponse, GetLeadTraderResponse, ListFollowLeaderPositionsResponse, ListLeadTraderClosedTradesParams, ListLeadTraderClosedTradesResponse, ListLeadTraderOpenPositionsResponse, ListLeadTradersParams, ListLeadTradersResponse, ListMyFollowersParams, ListMyFollowersResponse, ListMyFollowsParams, ListMyFollowsResponse, PreviewFollowParams, PreviewFollowResponse, StopFollowResponse, UpsertFollowParams, UpsertFollowResponse, UpsertLeadTraderParams, UpsertLeadTraderResponse } from "@0xmonaco/types";
 import { BaseAPI } from "../base";
 export declare class CopyTradingAPIImpl extends BaseAPI implements CopyTradingAPI {
     /**
@@ -77,6 +77,30 @@ export declare class CopyTradingAPIImpl extends BaseAPI implements CopyTradingAP
     previewFollow(params: PreviewFollowParams): Promise<PreviewFollowResponse>;
     /** Stop one of your follows: the leader's fills stop being mirrored. */
     stopFollow(followId: string): Promise<StopFollowResponse>;
+    /**
+     * Close every position in one of your follows' copy accounts and keep the
+     * follow. The response acknowledges the batch; fills arrive on the order,
+     * position and copy channels.
+     */
+    closeFollowPositions(followId: string): Promise<CloseFollowPositionsResponse>;
+    /** Close the copy positions of every live follow of yours, keeping the follows. */
+    closeAllCopyPositions(): Promise<CloseAllCopyPositionsResponse>;
+    /**
+     * Add margin to one of your copy positions: moves `amount` (quote units)
+     * from the follow's copy account into the margin of its isolated copy
+     * position on `tradingPairId`. The position's margin rises by exactly
+     * `amount`, the copy account's remaining collateral falls by the same, and
+     * your margin account is never touched. It opens no exposure, so it works
+     * while copy trading is switched off and on a `CLOSE_ONLY` follow; there is
+     * no margin reduction (a follow exits by being stopped).
+     *
+     * Master account sessions only (403 otherwise); 404 for a follow that is
+     * not yours; 409 while the follow is stopping or once it is stopped; 400
+     * `COPY_TRADING_REJECTED` when the engine refuses the add; 429 over the
+     * shared movement budget. Not idempotent: a retry after a timeout whose
+     * first attempt landed adds the amount twice.
+     */
+    addFollowPositionMargin(params: AddFollowPositionMarginParams): Promise<AddFollowPositionMarginResponse>;
     /** List your follows, newest first. Cursor paged, up to 1000 per page. */
     listMyFollows(params?: ListMyFollowsParams): Promise<ListMyFollowsResponse>;
     /**

package/dist/api/copy-trading/api.js

@@ -20,7 +20,7 @@
  * const { followId } = await sdk.copyTrading.upsertFollow({ leader, allocation: "1000", slPct: "0.25" });
  * ```
  */
-import { LeaderHandleSchema, ListLeadTraderClosedTradesSchema, ListLeadTradersSchema, ListMyFollowersSchema, ListMyFollowsSchema, PreviewFollowSchema, UpsertFollowSchema, UpsertLeadTraderSchema, UUIDSchema, validate, } from "@0xmonaco/types";
+import { AddFollowPositionMarginSchema, LeaderHandleSchema, ListLeadTraderClosedTradesSchema, ListLeadTradersSchema, ListMyFollowersSchema, ListMyFollowsSchema, PreviewFollowSchema, UpsertFollowSchema, UpsertLeadTraderSchema, UUIDSchema, validate, } from "@0xmonaco/types";
 import { BaseAPI } from "../base";
 const BASE = "/api/v1/copy-trading";
 /** `?k=v&...` from the defined entries, or `""` when there are none. */
@@ -183,6 +183,42 @@ export class CopyTradingAPIImpl extends BaseAPI {
     async stopFollow(followId) {
         return await this.makeAuthenticatedRequest(`${followPath(followId)}/stop`, { method: "POST" });
     }
+    /**
+     * Close every position in one of your follows' copy accounts and keep the
+     * follow. The response acknowledges the batch; fills arrive on the order,
+     * position and copy channels.
+     */
+    async closeFollowPositions(followId) {
+        return await this.makeAuthenticatedRequest(`${followPath(followId)}/close-positions`, { method: "POST" });
+    }
+    /** Close the copy positions of every live follow of yours, keeping the follows. */
+    async closeAllCopyPositions() {
+        return await this.makeAuthenticatedRequest(`${BASE}/follows/close-positions`, { method: "POST" });
+    }
+    /**
+     * Add margin to one of your copy positions: moves `amount` (quote units)
+     * from the follow's copy account into the margin of its isolated copy
+     * position on `tradingPairId`. The position's margin rises by exactly
+     * `amount`, the copy account's remaining collateral falls by the same, and
+     * your margin account is never touched. It opens no exposure, so it works
+     * while copy trading is switched off and on a `CLOSE_ONLY` follow; there is
+     * no margin reduction (a follow exits by being stopped).
+     *
+     * Master account sessions only (403 otherwise); 404 for a follow that is
+     * not yours; 409 while the follow is stopping or once it is stopped; 400
+     * `COPY_TRADING_REJECTED` when the engine refuses the add; 429 over the
+     * shared movement budget. Not idempotent: a retry after a timeout whose
+     * first attempt landed adds the amount twice.
+     */
+    async addFollowPositionMargin(params) {
+        const { followId, tradingPairId, amount } = validate(AddFollowPositionMarginSchema, params);
+        // The follow id travels in the path only; the body carries the rest.
+        const body = { tradingPairId, amount };
+        return await this.makeAuthenticatedRequest(`${followPath(followId)}/position-margin`, {
+            method: "POST",
+            body: JSON.stringify(body),
+        });
+    }
     /** List your follows, newest first. Cursor paged, up to 1000 per page. */
     async listMyFollows(params = {}) {
         const { pageSize, pageToken } = validate(ListMyFollowsSchema, params);

package/dist/api/delegated-agents/api.js

@@ -16,6 +16,7 @@ export class DelegatedAgentsAPIImpl extends BaseAPI {
                 maxLeverage: request.maxLeverage,
                 maxOrderNotional: request.maxOrderNotional,
                 maxOpenOrders: request.maxOpenOrders,
+                ipAllowlist: request.ipAllowlist,
             }),
         });
     }

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

@@ -76,6 +76,9 @@ export declare class FeesAPIImpl extends BaseAPI implements FeesAPI {
      * spot/perp breakdown), the volume still needed to reach the next tier, and the
      * requested pair's six-row fee schedule.
      *
+     * The tier and volumes are wallet-wide: the caller's wallet total across every
+     * application it trades through, so they read the same from any application.
+     *
      * @param params - Parameters for the lookup
      * @param params.tradingPairId - Trading pair whose fee schedule to return
      * @returns Promise resolving to the caller's tier and the pair's schedule

package/dist/api/fees/api.js

@@ -94,6 +94,9 @@ export class FeesAPIImpl extends BaseAPI {
      * spot/perp breakdown), the volume still needed to reach the next tier, and the
      * requested pair's six-row fee schedule.
      *
+     * The tier and volumes are wallet-wide: the caller's wallet total across every
+     * application it trades through, so they read the same from any application.
+     *
      * @param params - Parameters for the lookup
      * @param params.tradingPairId - Trading pair whose fee schedule to return
      * @returns Promise resolving to the caller's tier and the pair's schedule

package/dist/api/margin-accounts/api.d.ts

@@ -1,6 +1,10 @@
-import type { GetAvailableCollateralParams, GetAvailableCollateralResponse, GetMarginAccountMovementsParams, GetMarginAccountMovementsResponse, GetMarginAccountSummaryParams, ListMarginAccountsParams, ListMarginAccountsResponse, MarginAccountSummary, MarginAccountsAPI, SimulateOrderRiskRequest, SimulateOrderRiskResponse, SimulateRiskBucketOrderRiskRequest, TransferCollateralFromParentMarginAccountRequest, TransferCollateralRequest, TransferCollateralResponse, TransferCollateralToParentMarginAccountRequest, TransferCollateralToRiskBucketRequest } from "@0xmonaco/types";
+import type { CloseMarginSubAccountResponse, CreateMarginSubAccountRequest, CreateMarginSubAccountResponse, GetAvailableCollateralParams, GetAvailableCollateralResponse, GetMarginAccountMovementsParams, GetMarginAccountMovementsResponse, GetMarginAccountSummaryParams, ListMarginAccountsParams, ListMarginAccountsResponse, MarginAccountPnl, MarginAccountSummary, MarginAccountsAPI, SimulateOrderRiskRequest, SimulateOrderRiskResponse, SimulateRiskBucketOrderRiskRequest, TransferCollateralFromParentMarginAccountRequest, TransferCollateralRequest, TransferCollateralResponse, TransferCollateralToParentMarginAccountRequest, TransferCollateralToRiskBucketRequest, TransferMarginCollateralRequest, TransferMarginCollateralResponse } from "@0xmonaco/types";
 import { BaseAPI } from "../base";
 export declare class MarginAccountsAPIImpl extends BaseAPI implements MarginAccountsAPI {
+    createMarginSubAccount(request: CreateMarginSubAccountRequest): Promise<CreateMarginSubAccountResponse>;
+    closeMarginSubAccount(marginAccountId: string): Promise<CloseMarginSubAccountResponse>;
+    getMarginAccountPnl(marginAccountId: string): Promise<MarginAccountPnl>;
+    transferMarginCollateral(request: TransferMarginCollateralRequest): Promise<TransferMarginCollateralResponse>;
     listMarginAccounts(params?: ListMarginAccountsParams): Promise<ListMarginAccountsResponse>;
     getMarginAccountSummary(marginAccountId: string, params?: GetMarginAccountSummaryParams): Promise<MarginAccountSummary>;
     getParentMarginAccountSummary(params?: GetMarginAccountSummaryParams): Promise<MarginAccountSummary>;

package/dist/api/margin-accounts/api.js

@@ -1,7 +1,37 @@
-import { GetAvailableCollateralSchema, GetMarginAccountMovementsSchema, GetMarginAccountSummarySchema, GetParentMarginAccountMovementsSchema, GetParentMarginAccountSummarySchema, ListMarginAccountsSchema, SimulateOrderRiskSchema, SimulateParentMarginOrderRiskSchema, SimulateRiskBucketOrderRiskSchema, TransferCollateralFromParentMarginAccountSchema, TransferCollateralSchema, TransferCollateralToParentMarginAccountSchema, TransferCollateralToRiskBucketSchema, validate, } from "@0xmonaco/types";
+import { CloseMarginSubAccountSchema, CreateMarginSubAccountSchema, GetAvailableCollateralSchema, GetMarginAccountMovementsSchema, GetMarginAccountPnlSchema, GetMarginAccountSummarySchema, GetParentMarginAccountMovementsSchema, GetParentMarginAccountSummarySchema, ListMarginAccountsSchema, SimulateOrderRiskSchema, SimulateParentMarginOrderRiskSchema, SimulateRiskBucketOrderRiskSchema, TransferCollateralFromParentMarginAccountSchema, TransferCollateralSchema, TransferCollateralToParentMarginAccountSchema, TransferCollateralToRiskBucketSchema, TransferMarginCollateralSchema, validate, } from "@0xmonaco/types";
 import { BaseAPI } from "../base";
 import { perpRoutes } from "../perp";
 export class MarginAccountsAPIImpl extends BaseAPI {
+    async createMarginSubAccount(request) {
+        validate(CreateMarginSubAccountSchema, { request });
+        return await this.makeAuthenticatedRequest(perpRoutes.marginAccounts.createSubAccount(), {
+            method: "POST",
+            body: JSON.stringify({ subaccountKey: request.subaccountKey, label: request.label }),
+        });
+    }
+    async closeMarginSubAccount(marginAccountId) {
+        validate(CloseMarginSubAccountSchema, { marginAccountId });
+        return await this.makeAuthenticatedRequest(perpRoutes.marginAccounts.closeSubAccount(marginAccountId), {
+            method: "POST",
+            body: JSON.stringify({}),
+        });
+    }
+    async getMarginAccountPnl(marginAccountId) {
+        validate(GetMarginAccountPnlSchema, { marginAccountId });
+        return await this.makeAuthenticatedRequest(perpRoutes.marginAccounts.pnl(marginAccountId));
+    }
+    async transferMarginCollateral(request) {
+        validate(TransferMarginCollateralSchema, { request });
+        return await this.makeAuthenticatedRequest(perpRoutes.marginAccounts.transferCollateral(), {
+            method: "POST",
+            body: JSON.stringify({
+                asset: request.asset,
+                amount: request.amount,
+                from: request.from,
+                to: request.to,
+            }),
+        });
+    }
     async listMarginAccounts(params) {
         if (params) {
             validate(ListMarginAccountsSchema, params);
@@ -69,6 +99,7 @@ export class MarginAccountsAPIImpl extends BaseAPI {
                 tradingPairId: request.tradingPairId,
                 strategyKey: request.strategyKey,
                 marginMode: request.marginMode,
+                marginAccountId: request.marginAccountId,
                 // No selectedTradingPairIds: cross scope is derived from trading, and
                 // the server ignores the deprecated field. Not sending it keeps a
                 // pre-upgrade caller's stale list from reaching the wire at all.
@@ -152,6 +183,7 @@ export class MarginAccountsAPIImpl extends BaseAPI {
                 tradingPairId: request.tradingPairId,
                 strategyKey: request.strategyKey,
                 marginMode: request.marginMode,
+                marginAccountId: request.marginAccountId,
                 // No selectedTradingPairIds: cross scope is derived from trading, and
                 // the server ignores the deprecated field. Not sending it keeps a
                 // pre-upgrade caller's stale list from reaching the wire at all.

package/dist/api/perp/routes.d.ts

@@ -230,6 +230,10 @@ export declare const perpRoutes: {
         readonly simulateParentMarginOrderRisk: () => string;
         readonly simulateOrderRisk: (marginAccountId: string) => string;
         readonly simulateRiskBucketOrderRisk: () => string;
+        readonly createSubAccount: () => string;
+        readonly closeSubAccount: (marginAccountId: string) => string;
+        readonly pnl: (marginAccountId: string) => string;
+        readonly transferCollateral: () => string;
     };
     readonly streams: {
         readonly orderbook: () => string;

package/dist/api/perp/routes.js

@@ -119,6 +119,10 @@ export const perpRoutes = {
         simulateParentMarginOrderRisk: () => `${API_V1}/margin/parent-margin-account/simulate-order-risk`,
         simulateOrderRisk: (marginAccountId) => `${API_V1}/margin/accounts/${encodeSegment(marginAccountId)}/simulate-order-risk`,
         simulateRiskBucketOrderRisk: () => `${API_V1}/margin/risk-buckets/simulate-order-risk`,
+        createSubAccount: () => `${API_V1}/margin/sub-accounts`,
+        closeSubAccount: (marginAccountId) => `${API_V1}/margin/sub-accounts/${encodeSegment(marginAccountId)}/close`,
+        pnl: (marginAccountId) => `${API_V1}/margin/accounts/${encodeSegment(marginAccountId)}/pnl`,
+        transferCollateral: () => `${API_V1}/margin/collateral/transfer`,
     },
     streams: {
         orderbook: () => `${API_V1}/streaming/orderbook`,

package/dist/api/pitpass/api.d.ts

@@ -33,7 +33,7 @@
  * console.log(`Rewards remaining: ${result.rewardsBalance}`);
  * ```
  */
-import type { GetMyReferralDownlineResponse, GetMyReferralPositionResponse, GetRewardsBalanceResponse, PitpassAPI, TraderCodeAvailabilityResponse, TraderCodeInfoResponse, TraderCodeResponse, TransferRewardsParams, TransferRewardsResponse } from "@0xmonaco/types";
+import type { GetMyReferralDownlineResponse, GetMyReferralPositionResponse, GetMyReferralTreeParams, GetMyReferralTreeResponse, GetRewardsBalanceResponse, PitpassAPI, TraderCodeAvailabilityResponse, TraderCodeInfoResponse, TraderCodeResponse, TransferRewardsParams, TransferRewardsResponse } from "@0xmonaco/types";
 import { BaseAPI } from "../base";
 export declare class PitpassAPIImpl extends BaseAPI implements PitpassAPI {
     /**
@@ -77,9 +77,10 @@ export declare class PitpassAPIImpl extends BaseAPI implements PitpassAPI {
      */
     transferRewards(params: TransferRewardsParams): Promise<TransferRewardsResponse>;
     /**
-     * Read the caller's own referral position: their L1 referrer, total earned,
-     * and recent rewards. Self-scoped — no id is sent, so it can only ever return
-     * your own chain. `referrer` is "" when you were not referred.
+     * Read the caller's own referral position: their upline (L1, L2, L3), their
+     * L1 referrer, total earned, and recent rewards. Self-scoped — no id is sent,
+     * so it can only ever return your own chain. `referrer` is "" and `upline` is
+     * empty when you were not referred.
      */
     getMyReferralPosition(): Promise<GetMyReferralPositionResponse>;
     /**
@@ -88,4 +89,11 @@ export declare class PitpassAPIImpl extends BaseAPI implements PitpassAPI {
      * per-level earnings summary. Self-scoped, read-only.
      */
     getMyReferralDownline(): Promise<GetMyReferralDownlineResponse>;
+    /**
+     * Read one level of the caller's own referral tree: the wallets `parent`
+     * directly referred (the caller when omitted), a page at a time, newest
+     * first. `parent` must be the caller or one of their own L1/L2 referees;
+     * any other wallet is a 404.
+     */
+    getMyReferralTree(params?: GetMyReferralTreeParams): Promise<GetMyReferralTreeResponse>;
 }

package/dist/api/pitpass/api.js

@@ -33,7 +33,7 @@
  * console.log(`Rewards remaining: ${result.rewardsBalance}`);
  * ```
  */
-import { SetTraderCodeParamsSchema, TransferRewardsParamsSchema, validate } from "@0xmonaco/types";
+import { GetMyReferralTreeParamsSchema, SetTraderCodeParamsSchema, TransferRewardsParamsSchema, validate } from "@0xmonaco/types";
 import { BaseAPI } from "../base";
 export class PitpassAPIImpl extends BaseAPI {
     /**
@@ -109,9 +109,10 @@ export class PitpassAPIImpl extends BaseAPI {
         });
     }
     /**
-     * Read the caller's own referral position: their L1 referrer, total earned,
-     * and recent rewards. Self-scoped — no id is sent, so it can only ever return
-     * your own chain. `referrer` is "" when you were not referred.
+     * Read the caller's own referral position: their upline (L1, L2, L3), their
+     * L1 referrer, total earned, and recent rewards. Self-scoped — no id is sent,
+     * so it can only ever return your own chain. `referrer` is "" and `upline` is
+     * empty when you were not referred.
      */
     async getMyReferralPosition() {
         return await this.makeAuthenticatedRequest("/api/v1/pitpass/referrals/me", {
@@ -128,4 +129,28 @@ export class PitpassAPIImpl extends BaseAPI {
             method: "GET",
         });
     }
+    /**
+     * Read one level of the caller's own referral tree: the wallets `parent`
+     * directly referred (the caller when omitted), a page at a time, newest
+     * first. `parent` must be the caller or one of their own L1/L2 referees;
+     * any other wallet is a 404.
+     */
+    async getMyReferralTree(params) {
+        if (params) {
+            validate(GetMyReferralTreeParamsSchema, params);
+        }
+        const searchParams = new URLSearchParams();
+        if (params?.parent !== undefined) {
+            searchParams.append("parent", params.parent);
+        }
+        if (params?.pageSize !== undefined) {
+            searchParams.append("pageSize", params.pageSize.toString());
+        }
+        if (params?.pageToken !== undefined) {
+            searchParams.append("pageToken", params.pageToken);
+        }
+        const query = searchParams.toString();
+        const path = query ? `/api/v1/pitpass/referrals/me/tree?${query}` : "/api/v1/pitpass/referrals/me/tree";
+        return await this.makeAuthenticatedRequest(path, { method: "GET" });
+    }
 }

package/dist/api/portfolio/api.d.ts

@@ -1,9 +1,9 @@
-import type { PortfolioAPI, PortfolioAssets, PortfolioMargin, PortfolioPerformance, PortfolioPeriodParams, PortfolioRealizedPnl, PortfolioSummary } from "@0xmonaco/types";
+import type { PortfolioAPI, PortfolioAssets, PortfolioMargin, PortfolioMarginParams, PortfolioPerformance, PortfolioPeriodParams, PortfolioRealizedPnl, PortfolioSummary } from "@0xmonaco/types";
 import { BaseAPI } from "../base";
 export declare class PortfolioAPIImpl extends BaseAPI implements PortfolioAPI {
     getSummary(params?: PortfolioPeriodParams): Promise<PortfolioSummary>;
     getPerformance(params?: PortfolioPeriodParams): Promise<PortfolioPerformance>;
     getRealizedPnl(params?: PortfolioPeriodParams): Promise<PortfolioRealizedPnl>;
     getAssets(params?: PortfolioPeriodParams): Promise<PortfolioAssets>;
-    getMargin(): Promise<PortfolioMargin>;
+    getMargin(params?: PortfolioMarginParams): Promise<PortfolioMargin>;
 }

package/dist/api/portfolio/api.js

@@ -19,7 +19,16 @@ export class PortfolioAPIImpl extends BaseAPI {
     async getAssets(params) {
         return await this.makeAuthenticatedRequest(withPeriod(`${BASE_PATH}/assets`, params));
     }
-    async getMargin() {
-        return await this.makeAuthenticatedRequest(`${BASE_PATH}/margin`);
+    async getMargin(params) {
+        const query = new URLSearchParams();
+        if (params?.marginAccountId) {
+            query.set("marginAccountId", params.marginAccountId);
+        }
+        if (params?.includeAccounts !== undefined) {
+            query.set("includeAccounts", String(params.includeAccounts));
+        }
+        const search = query.toString();
+        const suffix = search ? `?${search}` : "";
+        return await this.makeAuthenticatedRequest(`${BASE_PATH}/margin${suffix}`);
     }
 }

package/dist/api/websocket/websocket.js

@@ -284,7 +284,7 @@ function parseLiquidationEventData(raw) {
         positionId: readOptionalString(data, "positionId"),
         tradingPairId: readOptionalString(data, "tradingPairId"),
         status: readString(data, "status"),
-        accountState: readString(data, "accountState"),
+        riskBucketState: readString(data, "riskBucketState"),
         liquidationPrice: readOptionalString(data, "liquidationPrice"),
         markPrice: readOptionalString(data, "markPrice"),
         estimatedShortfall: readString(data, "estimatedShortfall"),
@@ -299,7 +299,7 @@ function parseLiquidationEvent(rawData) {
     return {
         // event_type is the event-class discriminator, validated strictly so a
         // mis-routed frame is rejected rather than parsed as a liquidation. The
-        // free-form value fields in the payload (status/accountState) stay lenient
+        // free-form value fields in the payload (status/riskBucketState) stay lenient
         // so an unexpected *value* never drops a risk-critical alert.
         eventType: readEnum(rawData, "event_type", ["liquidation_alert"]),
         userId: readString(rawData, "user_id"),

package/dist/coverage.d.ts

@@ -19,6 +19,9 @@ export declare const COVERED: {
     list_lead_trader_open_positions: string;
     upsert_follow: string;
     stop_follow: string;
+    close_follow_positions: string;
+    close_all_copy_positions: string;
+    add_follow_position_margin: string;
     list_my_follows: string;
     get_follow: string;
     list_follow_leader_positions: string;
@@ -59,6 +62,7 @@ export declare const COVERED: {
     get_rewards_balance: string;
     get_my_referral_position: string;
     get_my_referral_downline: string;
+    get_my_referral_tree: string;
     get_self_trade_prevention_default: string;
     get_trader_code_info: string;
     set_self_trade_prevention_default: string;
@@ -102,6 +106,7 @@ export declare const COVERED: {
     list_application_orders: string;
     list_application_users: string;
     list_buildercode_payouts: string;
+    list_builder_fee_changes: string;
     list_conditional_orders: string;
     list_delegated_agent_owners: string;
     list_delegated_agents: string;
@@ -128,7 +133,12 @@ export declare const COVERED: {
     transfer_collateral_to_margin_account: string;
     transfer_collateral_to_parent_margin_account: string;
     transfer_collateral_to_risk_bucket: string;
+    create_sub_account: string;
+    close_sub_account: string;
+    get_margin_account_pnl: string;
+    transfer_collateral: string;
     claim_buildercode_rewards: string;
+    set_builder_fee: string;
     transfer_rewards: string;
     update_sub_account_limit: string;
     upsert_delegated_agent: string;

package/dist/coverage.js

@@ -19,6 +19,9 @@ export const COVERED = {
     list_lead_trader_open_positions: "copyTrading.listLeadTraderOpenPositions",
     upsert_follow: "copyTrading.upsertFollow",
     stop_follow: "copyTrading.stopFollow",
+    close_follow_positions: "copyTrading.closeFollowPositions",
+    close_all_copy_positions: "copyTrading.closeAllCopyPositions",
+    add_follow_position_margin: "copyTrading.addFollowPositionMargin",
     list_my_follows: "copyTrading.listMyFollows",
     get_follow: "copyTrading.getFollow",
     list_follow_leader_positions: "copyTrading.listFollowLeaderPositions",
@@ -59,6 +62,7 @@ export const COVERED = {
     get_rewards_balance: "pitpass.getRewardsBalance",
     get_my_referral_position: "pitpass.getMyReferralPosition",
     get_my_referral_downline: "pitpass.getMyReferralDownline",
+    get_my_referral_tree: "pitpass.getMyReferralTree",
     get_self_trade_prevention_default: "profile.getSelfTradePreventionDefault",
     get_trader_code_info: "pitpass.getTraderCodeInfo",
     set_self_trade_prevention_default: "profile.setSelfTradePreventionDefault",
@@ -102,6 +106,7 @@ export const COVERED = {
     list_application_orders: "listApplicationOrders",
     list_application_users: "listApplicationUsers",
     list_buildercode_payouts: "buildercodes.listPayouts",
+    list_builder_fee_changes: "buildercodes.listBuilderFeeChanges",
     list_conditional_orders: "listConditionalOrders",
     list_delegated_agent_owners: "listDelegatedOwners",
     list_delegated_agents: "listDelegatedAgents",
@@ -128,7 +133,12 @@ export const COVERED = {
     transfer_collateral_to_margin_account: "transferCollateralToMarginAccount",
     transfer_collateral_to_parent_margin_account: "transferCollateralToParentMarginAccount",
     transfer_collateral_to_risk_bucket: "transferCollateralToRiskBucket",
+    create_sub_account: "createMarginSubAccount",
+    close_sub_account: "closeMarginSubAccount",
+    get_margin_account_pnl: "getMarginAccountPnl",
+    transfer_collateral: "transferMarginCollateral",
     claim_buildercode_rewards: "buildercodes.claimBuildercodeRewards",
+    set_builder_fee: "buildercodes.setBuilderFee",
     transfer_rewards: "pitpass.transferRewards",
     update_sub_account_limit: "subAccounts.updateLimit",
     upsert_delegated_agent: "upsertDelegatedAgent",

package/dist/sdk.d.ts

@@ -99,6 +99,8 @@ export declare class MonacoSDKImpl implements MonacoSDK {
      * session uses a fresh ed25519 keypair generated locally; the current agent
      * session signs the registration request, and subsequent SDK calls use the
      * delegated session keypair.
+     * The session expires no later than the delegation. Revocation or an earlier
+     * policy expiry also ends access, including reads and session refresh.
      */
     loginAsDelegatedOwner(ownerUserId: string): Promise<AuthState>;
     /**
@@ -134,6 +136,8 @@ export declare class MonacoSDKImpl implements MonacoSDK {
      * Signs a refresh request with the active session key and updates the local
      * `expiresAt`. The session keypair is unchanged. If no session is active, or
      * the session has expired/been revoked, this throws.
+     * Delegated sessions also require an active grant; refresh cannot extend
+     * access beyond its expiry or renew the owner's authorization.
      *
      * @returns The updated authentication state
      */

package/dist/sdk.js

@@ -278,6 +278,8 @@ export class MonacoSDKImpl {
      * session uses a fresh ed25519 keypair generated locally; the current agent
      * session signs the registration request, and subsequent SDK calls use the
      * delegated session keypair.
+     * The session expires no later than the delegation. Revocation or an earlier
+     * policy expiry also ends access, including reads and session refresh.
      */
     async loginAsDelegatedOwner(ownerUserId) {
         if (!this.authState) {
@@ -358,6 +360,8 @@ export class MonacoSDKImpl {
      * Signs a refresh request with the active session key and updates the local
      * `expiresAt`. The session keypair is unchanged. If no session is active, or
      * the session has expired/been revoked, this throws.
+     * Delegated sessions also require an active grant; refresh cannot extend
+     * access beyond its expiry or renew the owner's authorization.
      *
      * @returns The updated authentication state
      */

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@0xmonaco/core",
-	"version": "1.0.70",
+	"version": "1.0.73-develop.af0f5d0",
 	"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.70",
-		"@0xmonaco/types": "1.0.70",
+		"@0xmonaco/contracts": "1.0.73-develop.af0f5d0",
+		"@0xmonaco/types": "1.0.73-develop.af0f5d0",
 		"@noble/curves": "^1.9.1",
 		"@noble/hashes": "^2.4.0",
 		"http-status-codes": "^2.3.0"