@0xmonaco/types 0.8.21 → 0.8.22-develop.efb9dc9

package/README.md

@@ -202,50 +202,62 @@ Types for market data operations including trading pair metadata:
 import {
   MarketAPI,
   TradingPair,
+  GetTradingPairsParams,
   GetTradingPairsResponse,
   GetTradingPairResponse,
+  TradingMode,
 } from "@0xmonaco/types";
 
 // Market operations
 interface MarketAPI extends BaseAPI {
-  getTradingPairs(): Promise<TradingPair[]>;
-  getTradingPairBySymbol(symbol: string): Promise<TradingPair | undefined>;
+  getPaginatedTradingPairs(
+    params?: GetTradingPairsParams,
+  ): Promise<GetTradingPairsResponse>;
+  getTradingPair(tradingPairId: string): Promise<TradingPair>;
+  getTradingPairBySymbol(
+    symbol: string,
+    marketType?: TradingMode,
+  ): Promise<TradingPair | undefined>;
 }
 
 // Market data types
 interface TradingPair {
   id: string;
   symbol: string;
-  base_token: string;
-  quote_token: string;
-  base_token_contract: string;
-  quote_token_contract: string;
-  base_decimals: number;
-  quote_decimals: number;
-  market_type: string;
-  is_active: boolean;
-  maker_fee_bps: number;
-  taker_fee_bps: number;
-  min_order_size: string;
-  max_order_size: string;
-  tick_size: string;
+  baseToken: string;
+  quoteToken: string;
+  baseAssetId: string;
+  quoteAssetId: string;
+  baseTokenContract: string;
+  quoteTokenContract: string;
+  baseDecimals: number;
+  baseIconUrl: string;
+  quoteDecimals: number;
+  quoteIconUrl: string;
+  marketType: TradingMode;
+  category: string;
+  isActive: boolean;
+  makerFeeBps: number;
+  takerFeeBps: number;
+  minOrderSize: string;
+  maxOrderSize: string;
+  quantityStepSize: string;
+  tickSize: string;
+  minLeverage?: string | null;
+  maxLeverage?: string | null;
 }
 
 // Market response types
 interface GetTradingPairsResponse {
-  data: {
-    data: TradingPair[];
-    limit: number;
-    page: number;
-    total: number;
-    total_pages: number;
-  };
-  success: boolean;
+  tradingPairs: TradingPair[];
+  page: number;
+  pageSize: number;
+  total: number;
+  totalPages: number;
 }
 
 interface GetTradingPairResponse {
-  data: TradingPair;
-  success: boolean;
+  tradingPair: TradingPair;
 }
 ```
 

package/dist/auth/index.d.ts

@@ -22,9 +22,12 @@ export interface AuthAPI extends BaseAPI {
      * 4. Verifies the signature, registering the session public key
      *
      * @param clientId - Client ID of the application
+     * @param referralCode - Optional PitPass TraderCode (wallet address) of the referrer.
+     *   Passed through to the verify call so a first-time sign-up records the referral
+     *   relationship. Has no effect when the user already exists.
      * @returns Promise resolving to the authentication state (including the session keypair)
      */
-    authenticate(clientId: string): Promise<AuthState>;
+    authenticate(clientId: string, referralCode?: string): Promise<AuthState>;
     /**
      * Signs a challenge message using the wallet client.
      *
@@ -54,9 +57,11 @@ export interface AuthAPI extends BaseAPI {
      * @param nonce - Nonce from the challenge response
      * @param clientId - Client ID of the application
      * @param session - The locally-generated session keypair (hex-encoded)
+     * @param referralCode - Optional PitPass TraderCode (wallet address) of the referrer;
+     *   recorded at first sign-up only.
      * @returns Promise resolving to the authentication state
      */
-    verifySignature(address: string, signature: string, nonce: string, clientId: string, session: SessionCredentials): Promise<AuthState>;
+    verifySignature(address: string, signature: string, nonce: string, clientId: string, session: SessionCredentials, referralCode?: string): Promise<AuthState>;
     /**
      * Extends the current session's expiry. The request is signed with the
      * active session key (set via {@link setSessionKeypair}).

package/dist/index.d.ts

@@ -13,6 +13,7 @@ export * from "./faucet";
 export * from "./fees";
 export * from "./margin-accounts";
 export * from "./market";
+export * from "./pitpass";
 export * from "./positions";
 export * from "./profile";
 export * from "./sdk";

package/dist/index.js

@@ -14,6 +14,7 @@ export * from "./faucet";
 export * from "./fees";
 export * from "./margin-accounts";
 export * from "./market";
+export * from "./pitpass";
 export * from "./positions";
 export * from "./profile";
 export * from "./sdk";

package/dist/market/index.d.ts

@@ -48,6 +48,8 @@ export interface TradingPair {
     minOrderSize: string;
     /** Maximum order size */
     maxOrderSize: string;
+    /** Minimum order quantity increment (lot size step) */
+    quantityStepSize: string;
     /** Tick size for price increments */
     tickSize: string;
     /** Minimum supported leverage for margin markets (optional, margin only) */

package/dist/pitpass/index.d.ts

@@ -0,0 +1,60 @@
+/**
+ * PitPass Types
+ *
+ * Types for PitPass TraderCode API: code lookup, rewards balance, and transfer.
+ */
+import type { BaseAPI } from "../api";
+import type { GetRewardsBalanceResponse, TraderCodeInfoResponse, TraderCodeResponse, TransferRewardsParams, TransferRewardsResponse } from "./responses";
+/**
+ * PitPass TraderCode API interface.
+ *
+ * Provides methods for reading your wallet-derived TraderCode, looking up a
+ * referral code at sign-up, reading your accrued rewards balance, and
+ * transferring rewards into a tradeable balance.
+ */
+export interface PitpassAPI extends BaseAPI {
+    /**
+     * Return the authenticated caller's TraderCode (their normalized wallet address).
+     *
+     * Never 404s — every signed-in wallet has a derivable code. Ensures the
+     * backing row so referrals attributed to this wallet have a code to link.
+     *
+     * @returns Promise resolving to the caller's TraderCode and its creation timestamp
+     */
+    getMyTraderCode(): Promise<TraderCodeResponse>;
+    /**
+     * Public, unauthenticated lookup of a TraderCode.
+     *
+     * Used to validate a referral code at sign-up. The code is a wallet address
+     * (the `Monaco - <address>` display form is also accepted). Returns the
+     * normalized code when it resolves to a known wallet, or throws a 404 when
+     * the code does not resolve to any user.
+     *
+     * @param code - The TraderCode (wallet address or `Monaco - <address>` form) to look up
+     * @returns Promise resolving to the normalized TraderCode
+     */
+    getTraderCodeInfo(code: string): Promise<TraderCodeInfoResponse>;
+    /**
+     * Return the caller's current PitPass rewards-bucket balances.
+     *
+     * Rewards accumulate here as referred users trade. Call
+     * {@link transferRewards} to move them into a tradeable balance.
+     * Returns an empty `balances` array when no rewards have been earned yet.
+     *
+     * @returns Promise resolving to the list of per-token reward balances
+     */
+    getRewardsBalance(): Promise<GetRewardsBalanceResponse>;
+    /**
+     * Transfer earned PitPass rewards into a trading balance.
+     *
+     * Moves the specified amount of a reward token from the caller's rewards
+     * bucket into their trading balance under the authenticated application.
+     * Ledger-only — no on-chain transaction, immediately tradeable.
+     *
+     * @param params - Token address and raw-unit amount to transfer
+     * @returns Promise resolving to the post-transfer rewards and trading balances
+     */
+    transferRewards(params: TransferRewardsParams): Promise<TransferRewardsResponse>;
+}
+export type { GetRewardsBalanceResponse, RewardsBalanceEntry, TraderCodeInfoResponse, TraderCodeResponse, TransferRewardsParams, TransferRewardsResponse, } from "./responses";
+export { GetRewardsBalanceResponseSchema, RewardsBalanceEntrySchema, TraderCodeInfoResponseSchema, TraderCodeResponseSchema, TransferRewardsParamsSchema, TransferRewardsResponseSchema, } from "./responses";

package/dist/pitpass/index.js

@@ -0,0 +1,6 @@
+/**
+ * PitPass Types
+ *
+ * Types for PitPass TraderCode API: code lookup, rewards balance, and transfer.
+ */
+export { GetRewardsBalanceResponseSchema, RewardsBalanceEntrySchema, TraderCodeInfoResponseSchema, TraderCodeResponseSchema, TransferRewardsParamsSchema, TransferRewardsResponseSchema, } from "./responses";

package/dist/pitpass/responses.d.ts

@@ -0,0 +1,44 @@
+/**
+ * PitPass TraderCode Response Types
+ *
+ * Types for PitPass TraderCode API responses and requests.
+ * All types are derived from Zod schemas for runtime validation.
+ */
+import { z } from "zod";
+/** Schema for a single token entry in the rewards balance response. */
+export declare const RewardsBalanceEntrySchema: z.ZodObject<{
+    token: z.ZodString;
+    available: z.ZodString;
+}, z.core.$strip>;
+/** Schema for the rewards balance response. */
+export declare const GetRewardsBalanceResponseSchema: z.ZodObject<{
+    balances: z.ZodArray<z.ZodObject<{
+        token: z.ZodString;
+        available: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/** Schema for a TraderCode response. */
+export declare const TraderCodeResponseSchema: z.ZodObject<{
+    code: z.ZodString;
+    createdAt: z.ZodString;
+}, z.core.$strip>;
+/** Schema for the public TraderCode info response. */
+export declare const TraderCodeInfoResponseSchema: z.ZodObject<{
+    code: z.ZodString;
+}, z.core.$strip>;
+/** Schema for the transfer rewards request body. */
+export declare const TransferRewardsParamsSchema: z.ZodObject<{
+    token: z.ZodString;
+    amount: z.ZodString;
+}, z.core.$strip>;
+/** Schema for the transfer rewards response. */
+export declare const TransferRewardsResponseSchema: z.ZodObject<{
+    rewardsBalance: z.ZodString;
+    tradingBalance: z.ZodString;
+}, z.core.$strip>;
+export type RewardsBalanceEntry = z.infer<typeof RewardsBalanceEntrySchema>;
+export type GetRewardsBalanceResponse = z.infer<typeof GetRewardsBalanceResponseSchema>;
+export type TraderCodeResponse = z.infer<typeof TraderCodeResponseSchema>;
+export type TraderCodeInfoResponse = z.infer<typeof TraderCodeInfoResponseSchema>;
+export type TransferRewardsParams = z.infer<typeof TransferRewardsParamsSchema>;
+export type TransferRewardsResponse = z.infer<typeof TransferRewardsResponseSchema>;

package/dist/pitpass/responses.js

@@ -0,0 +1,53 @@
+/**
+ * PitPass TraderCode Response Types
+ *
+ * Types for PitPass TraderCode API responses and requests.
+ * All types are derived from Zod schemas for runtime validation.
+ */
+import { z } from "zod";
+/** Schema for a single token entry in the rewards balance response. */
+export const RewardsBalanceEntrySchema = z.object({
+    /** Reward token contract address (0x-prefixed). */
+    token: z.string(),
+    /** Available rewards balance in RAW atomic units of the token. */
+    available: z.string(),
+});
+/** Schema for the rewards balance response. */
+export const GetRewardsBalanceResponseSchema = z.object({
+    /** One entry per reward token that has a non-zero available balance. */
+    balances: z.array(RewardsBalanceEntrySchema),
+});
+/** Schema for a TraderCode response. */
+export const TraderCodeResponseSchema = z.object({
+    /** The caller's TraderCode — their normalized wallet address. */
+    code: z.string(),
+    /** RFC 3339 timestamp when the code row was first derived. */
+    createdAt: z.string(),
+});
+/** Schema for the public TraderCode info response. */
+export const TraderCodeInfoResponseSchema = z.object({
+    /** The resolved TraderCode (normalized wallet address). */
+    code: z.string(),
+});
+/** Schema for the transfer rewards request body. */
+export const TransferRewardsParamsSchema = z.object({
+    /** Reward token contract address (0x-prefixed) to transfer. */
+    token: z
+        .string()
+        .trim()
+        .min(1, "token is required")
+        .regex(/^0x[0-9a-fA-F]{40}$/, "token must be a 0x-prefixed EVM address"),
+    /** Amount to transfer, in RAW atomic units of the token. Must be a positive integer string. */
+    amount: z
+        .string()
+        .trim()
+        .min(1, "amount is required")
+        .refine((v) => /^\d+$/.test(v) && BigInt(v) > 0n, "amount must be a positive integer string"),
+});
+/** Schema for the transfer rewards response. */
+export const TransferRewardsResponseSchema = z.object({
+    /** Your rewards-bucket balance after the transfer, RAW atomic units. */
+    rewardsBalance: z.string(),
+    /** Your trading balance for the token after the transfer, RAW atomic units. */
+    tradingBalance: z.string(),
+});

package/dist/positions/index.d.ts

@@ -18,7 +18,15 @@ export interface Position {
     realizedPnl: string;
     isolatedMargin: string;
     leverage?: string;
+    /**
+     * Position-scoped requirement at markPrice using the market
+     * maintenance-margin rate; zero without open exposure.
+     */
     maintenanceMarginRequired: string;
+    /**
+     * Position-scoped requirement at markPrice honoring effective leverage and
+     * the market initial-margin floor; zero without open exposure.
+     */
     initialMarginRequired?: string;
     liquidationPrice: string;
     status: PositionStatus;
@@ -78,7 +86,15 @@ export interface PositionRisk {
     unrealizedPnl: string;
     liquidationPrice: string;
     marginRatio: string;
+    /**
+     * Position-scoped requirement at markPrice using the market
+     * maintenance-margin rate; zero without open exposure.
+     */
     maintenanceMarginRequired: string;
+    /**
+     * Position-scoped requirement at markPrice honoring effective leverage and
+     * the market initial-margin floor; zero without open exposure.
+     */
     initialMarginRequired?: string;
     updatedAt: string;
 }
@@ -140,6 +156,57 @@ export interface ListPositionHistoryResponse {
     page: number;
     pageSize: number;
 }
+/**
+ * Sample interval for position PnL history queries (matches the candles
+ * interval ladder).
+ */
+export type PnlHistoryInterval = "1m" | "5m" | "15m" | "1h" | "4h" | "1d";
+/**
+ * Query parameters for position PnL history.
+ */
+export interface GetPositionPnlHistoryParams {
+    /** Sample interval */
+    interval: PnlHistoryInterval;
+    /** Start time as Unix timestamp in milliseconds (defaults to the interval's maximum lookback) */
+    startTime?: number;
+    /** End time as Unix timestamp in milliseconds (defaults to now) */
+    endTime?: number;
+}
+/**
+ * One PnL state sample for a position in one bucket. Cumulative fields are
+ * lifetime values as of the bucket; `cumFundingPaid` and `cumFees` are
+ * cost-positive (positive means paid/charged).
+ */
+export interface PositionPnlPoint {
+    /** Bucket start timestamp (ISO 8601) */
+    bucketStart: string;
+    /** Signed position quantity (negative for shorts) */
+    quantity: string;
+    /** Average entry price */
+    entryPrice: string;
+    /** Mark price at the sample */
+    markPrice: string;
+    /** Unrealized PnL at the sample: quantity x (mark - entry) */
+    unrealizedPnl: string;
+    /** Cumulative realized PnL, gross of fees */
+    cumRealizedPnl: string;
+    /** Cumulative funding paid; positive means paid, negative means received */
+    cumFundingPaid: string;
+    /** Cumulative trading fees; positive means charged, negative means rebated */
+    cumFees: string;
+}
+/**
+ * Position PnL history response.
+ * Returned by the /api/v1/positions/{positionId}/pnl/history endpoint.
+ */
+export interface GetPositionPnlHistoryResponse {
+    /** Position UUID */
+    positionId: string;
+    /** Interval used for this query */
+    interval: PnlHistoryInterval;
+    /** Forward-filled PnL state samples, oldest first */
+    data: PositionPnlPoint[];
+}
 export interface PositionsAPI extends BaseAPI {
     listPositions(params?: ListPositionsParams): Promise<ListPositionsResponse>;
     getPosition(positionId: string): Promise<GetPositionResponse>;
@@ -150,4 +217,5 @@ export interface PositionsAPI extends BaseAPI {
     reducePositionMargin(positionId: string, request: ReducePositionMarginRequest): Promise<PositionMarginResponse>;
     attachPositionTpSl(positionId: string, request: AttachPositionTpSlRequest): Promise<AttachPositionTpSlResponse>;
     listPositionHistory(params?: ListPositionHistoryParams): Promise<ListPositionHistoryResponse>;
+    getPositionPnlHistory(positionId: string, params: GetPositionPnlHistoryParams): Promise<GetPositionPnlHistoryResponse>;
 }

package/dist/profile/index.d.ts

@@ -320,8 +320,15 @@ export interface ListFundingPaymentsResponse {
 export type PortfolioPeriod = "24h" | "7d" | "30d" | "all";
 /**
  * Metric for portfolio chart queries.
+ *
+ * `volume` buckets trade volume and `pnl` is the legacy realized-only
+ * net-of-fees series. The remaining metrics are served from PnL history
+ * snapshots, forward-filled per bucket: `realized_pnl`, `funding_paid`, and
+ * `fees` are cumulative lifetime series; `unrealized_pnl`, `total_pnl`, and
+ * `equity` are state series. `funding_paid` is cost-positive (positive means
+ * paid) — negate for display as a PnL contribution.
  */
-export type PortfolioMetric = "volume" | "pnl";
+export type PortfolioMetric = "volume" | "pnl" | "unrealized_pnl" | "total_pnl" | "realized_pnl" | "funding_paid" | "fees" | "equity";
 /**
  * A single data point in a portfolio chart time series.
  */
@@ -343,11 +350,35 @@ export interface PortfolioChartResponse {
     /** Bucketed time series data points */
     data: PortfolioChartPoint[];
 }
+/**
+ * Lifetime PnL components for the authenticated user. The fields satisfy
+ * `totalPnl = (spotRealized + perpsRealized) + (spotUnrealized + perpsUnrealized) - fundingPaid - fees`.
+ */
+export interface PnlBreakdown {
+    /** Cumulative realized spot PnL, average-cost basis, gross of fees; withdrawals realize at fair value */
+    spotRealized: string;
+    /** Unrealized PnL on current spot holdings: quantity x (latest close - average cost) */
+    spotUnrealized: string;
+    /** Cumulative realized perps PnL, gross of fees */
+    perpsRealized: string;
+    /** Unrealized PnL on open perp positions: quantity x (mark - entry) */
+    perpsUnrealized: string;
+    /** Cumulative funding paid; positive means paid, negative means received. Subtracted in totalPnl. */
+    fundingPaid: string;
+    /** Cumulative trading fees; positive means charged, negative means rebated. Subtracted in totalPnl. */
+    fees: string;
+}
 /**
  * Portfolio statistics for the authenticated user over a given period.
  * Returned by the /api/v1/accounts/me/portfolio endpoint.
  */
 export interface PortfolioStats {
+    /** Current unrealized PnL across spot holdings and open perp positions. Live value, independent of the period. */
+    unrealizedPnl: string;
+    /** Current lifetime total PnL: realized + unrealized - fundingPaid - fees. Live value, independent of the period. */
+    totalPnl: string;
+    /** Lifetime PnL components behind totalPnl */
+    pnlBreakdown: PnlBreakdown | null;
     /**
      * Realized PnL over the period on an average-cost basis: gains/losses are
      * booked only when a position is reduced or closed, net of fees, across spot

package/dist/sdk/index.d.ts

@@ -6,6 +6,7 @@ import type { FaucetAPI } from "../faucet";
 import type { FeesAPI } from "../fees";
 import type { MarginAccountsAPI } from "../margin-accounts";
 import type { Interval, MarketAPI } from "../market";
+import type { PitpassAPI } from "../pitpass";
 import type { PositionsAPI } from "../positions";
 import type { ProfileAPI } from "../profile";
 import type { SubAccountsAPI } from "../sub-accounts";
@@ -81,6 +82,8 @@ export interface MonacoSDK {
     positions: PositionsAPI;
     /** Sub-account management API */
     subAccounts: SubAccountsAPI;
+    /** PitPass TraderCode referral and rewards API */
+    pitpass: PitpassAPI;
     /** Testnet faucet API */
     faucet: FaucetAPI;
     /** Public whitelist (waitlist) submission API */

package/dist/validation/positions.d.ts

@@ -91,3 +91,18 @@ export declare const ListPositionHistorySchema: z.ZodObject<{
     marginAccountId: z.ZodOptional<z.ZodUUID>;
     tradingPairId: z.ZodOptional<z.ZodUUID>;
 }, z.core.$strip>;
+export declare const GetPositionPnlHistorySchema: z.ZodObject<{
+    positionId: z.ZodUUID;
+    params: z.ZodObject<{
+        interval: z.ZodEnum<{
+            "1m": "1m";
+            "5m": "5m";
+            "15m": "15m";
+            "1h": "1h";
+            "4h": "4h";
+            "1d": "1d";
+        }>;
+        startTime: z.ZodOptional<z.ZodNumber>;
+        endTime: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>;
+}, z.core.$strip>;

package/dist/validation/positions.js

@@ -95,3 +95,18 @@ export const ListPositionHistorySchema = PaginationSchema.extend({
     marginAccountId: UUIDSchema.optional(),
     tradingPairId: UUIDSchema.optional(),
 });
+const PnlHistoryIntervalSchema = z.enum(["1m", "5m", "15m", "1h", "4h", "1d"], {
+    message: 'Interval must be one of "1m", "5m", "15m", "1h", "4h", "1d"',
+});
+export const GetPositionPnlHistorySchema = PositionIdSchema.extend({
+    params: z
+        .object({
+        interval: PnlHistoryIntervalSchema,
+        startTime: z.number().int().min(0, "startTime must be a non-negative millisecond timestamp").optional(),
+        endTime: z.number().int().min(0, "endTime must be a non-negative millisecond timestamp").optional(),
+    })
+        .refine((data) => data.startTime === undefined || data.endTime === undefined || data.startTime < data.endTime, {
+        message: "startTime must be less than endTime",
+        path: ["startTime"],
+    }),
+});

package/dist/wire/operations.d.ts

@@ -10,6 +10,6 @@
  * hand-written SDK surface. CI regenerates it and fails on a diff, identical to
  * the `schema.ts` wire-types tripwire (MON-1476), so it can never go stale.
  */
-export declare const OPERATION_IDS: readonly ["add_position_margin", "attach_position_tp_sl", "authenticate_backend", "batch_cancel_all", "batch_cancel_all_by_pair", "batch_cancel_orders", "batch_close_all_positions", "batch_create_orders", "batch_replace_orders", "cancel_conditional_order", "cancel_order", "close_position", "create_challenge", "create_delegated_session", "create_order", "create_sub_account_limit", "delete_sub_account_limit", "get_application_config", "get_application_stats", "get_available_collateral", "get_candles", "get_conditional_order", "get_funding_state", "get_index_price", "get_margin_account_movements", "get_margin_account_summary", "get_mark_price", "get_market_metadata", "get_market_stats", "get_my_fee_tier", "get_open_interest", "get_order_by_id", "get_orderbook_snapshot", "get_orders", "get_parent_margin_account_movements", "get_parent_margin_account_summary", "get_perp_market_config", "get_perp_market_summary", "get_portfolio_chart", "get_portfolio_stats", "get_position", "get_position_risk", "get_screener", "get_sub_account_limits", "get_trade_by_id", "get_trades", "get_trading_pair_by_id", "get_user_balance_by_asset", "get_user_balances", "get_user_movements", "get_user_profile", "get_user_trades", "get_withdrawal", "health_check", "initiate_withdrawal", "list_application_balances", "list_application_movements", "list_application_orders", "list_application_users", "list_conditional_orders", "list_delegated_agent_owners", "list_delegated_agents", "list_funding_history", "list_funding_payments", "list_margin_accounts", "list_pending_withdrawals", "list_position_history", "list_positions", "list_sub_accounts_with_balances", "list_trading_pairs", "mint_tokens", "reduce_position_margin", "refresh_session", "replace_order", "revoke_delegated_agent", "revoke_session", "simulate_fees", "simulate_order_risk", "simulate_parent_margin_order_risk", "simulate_risk_bucket_order_risk", "submit_whitelist", "transfer_collateral_from_margin_account", "transfer_collateral_from_parent_margin_account", "transfer_collateral_to_margin_account", "transfer_collateral_to_parent_margin_account", "transfer_collateral_to_risk_bucket", "update_sub_account_limit", "upsert_delegated_agent", "verify_signature"];
+export declare const OPERATION_IDS: readonly ["add_position_margin", "attach_position_tp_sl", "authenticate_backend", "batch_cancel_all", "batch_cancel_all_by_pair", "batch_cancel_orders", "batch_close_all_positions", "batch_create_orders", "batch_replace_orders", "cancel_conditional_order", "cancel_order", "close_position", "create_challenge", "create_delegated_session", "create_order", "create_sub_account_limit", "delete_sub_account_limit", "get_application_config", "get_application_stats", "get_available_collateral", "get_candles", "get_conditional_order", "get_funding_state", "get_index_price", "get_margin_account_movements", "get_margin_account_summary", "get_mark_price", "get_market_metadata", "get_market_stats", "get_my_fee_tier", "get_my_trader_code", "get_open_interest", "get_order_by_id", "get_orderbook_snapshot", "get_orders", "get_parent_margin_account_movements", "get_parent_margin_account_summary", "get_perp_market_config", "get_perp_market_summary", "get_portfolio_chart", "get_portfolio_stats", "get_position", "get_position_pnl_history", "get_position_risk", "get_rewards_balance", "get_screener", "get_sub_account_limits", "get_trade_by_id", "get_trader_code_info", "get_trades", "get_trading_pair_by_id", "get_user_balance_by_asset", "get_user_balances", "get_user_movements", "get_user_profile", "get_user_trades", "get_withdrawal", "health_check", "initiate_withdrawal", "list_application_balances", "list_application_movements", "list_application_orders", "list_application_users", "list_conditional_orders", "list_delegated_agent_owners", "list_delegated_agents", "list_funding_history", "list_funding_payments", "list_margin_accounts", "list_pending_withdrawals", "list_position_history", "list_positions", "list_sub_accounts_with_balances", "list_trading_pairs", "mint_tokens", "reduce_position_margin", "refresh_session", "replace_order", "revoke_delegated_agent", "revoke_session", "simulate_fees", "simulate_order_risk", "simulate_parent_margin_order_risk", "simulate_risk_bucket_order_risk", "submit_whitelist", "transfer_collateral_from_margin_account", "transfer_collateral_from_parent_margin_account", "transfer_collateral_to_margin_account", "transfer_collateral_to_parent_margin_account", "transfer_collateral_to_risk_bucket", "transfer_rewards", "update_sub_account_limit", "upsert_delegated_agent", "verify_signature"];
 /** Union of every OpenAPI operationId in the spec. */
 export type OperationId = (typeof OPERATION_IDS)[number];

package/dist/wire/operations.js

@@ -41,6 +41,7 @@ export const OPERATION_IDS = [
     "get_market_metadata",
     "get_market_stats",
     "get_my_fee_tier",
+    "get_my_trader_code",
     "get_open_interest",
     "get_order_by_id",
     "get_orderbook_snapshot",
@@ -52,10 +53,13 @@ export const OPERATION_IDS = [
     "get_portfolio_chart",
     "get_portfolio_stats",
     "get_position",
+    "get_position_pnl_history",
     "get_position_risk",
+    "get_rewards_balance",
     "get_screener",
     "get_sub_account_limits",
     "get_trade_by_id",
+    "get_trader_code_info",
     "get_trades",
     "get_trading_pair_by_id",
     "get_user_balance_by_asset",
@@ -97,6 +101,7 @@ export const OPERATION_IDS = [
     "transfer_collateral_to_margin_account",
     "transfer_collateral_to_parent_margin_account",
     "transfer_collateral_to_risk_bucket",
+    "transfer_rewards",
     "update_sub_account_limit",
     "upsert_delegated_agent",
     "verify_signature",

package/dist/wire/schema.d.ts

@@ -1470,6 +1470,108 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/v1/pitpass/codes/me": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get your TraderCode
+         * @description Claim your TraderCode.
+         *
+         *      Get your TraderCode.
+         *
+         *      Return the authenticated caller's TraderCode, which is derived from their
+         *      wallet address (rendered `Monaco - <address>` by clients). Never 404s — the
+         *      code always exists for a signed-in wallet — and ensures the backing row so
+         *      referrals attributed to this wallet have a code to link.
+         */
+        get: operations["get_my_trader_code"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/pitpass/codes/{code}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Look up a TraderCode
+         * @description Look up a TraderCode (public).
+         *
+         *      Public, unauthenticated lookup used to validate a referral code at signup.
+         *      The code is a wallet address; returns the normalized code when it resolves
+         *      to a known wallet. Returns 404 when the code does not resolve to a user.
+         */
+        get: operations["get_trader_code_info"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/pitpass/rewards/balance": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get your rewards balance
+         * @description Read accrued PitPass rewards balance.
+         *
+         *      Return the caller's current rewards-bucket balances across all reward tokens.
+         *      Rewards accumulate here as referred users trade; call TransferRewards to move
+         *      them into a tradeable balance. Returns an empty list when no rewards have
+         *      been earned yet.
+         */
+        get: operations["get_rewards_balance"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/pitpass/rewards/transfer": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Transfer rewards into a trading balance
+         * @description Transfer earned rewards into a trading balance.
+         *
+         *      Move spendable PitPass reward balance from your rewards bucket into a
+         *      trading balance under the authenticated application, making it tradeable
+         *      immediately. Ledger-only (one shared vault + one backend ledger) — no
+         *      on-chain transaction and no gas. Fails with 402 when the rewards balance is
+         *      insufficient.
+         */
+        post: operations["transfer_rewards"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/v1/positions": {
         parameters: {
             query?: never;
@@ -1590,6 +1692,32 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/v1/positions/{positionId}/pnl/history": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get position PnL history
+         * @description Get bucketed PnL history for one position.
+         *
+         *      Time series of PnL state samples (quantity, entry, mark, unrealized,
+         *      cumulative realized/funding/fees) for a position the caller owns, at the
+         *      requested interval. Buckets between samples are forward-filled; buckets
+         *      before the position's first sample are omitted. Distinct from
+         *      ListPositionHistory, which returns lifecycle events.
+         */
+        get: operations["get_position_pnl_history"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/v1/positions/{positionId}/risk": {
         parameters: {
             query?: never;
@@ -3743,7 +3871,7 @@ export interface components {
              */
             feesPaid?: string | null;
             /**
-             * @description Realized PnL over the period, average-cost basis: gains/losses booked only when a position is reduced or closed, net of fees. Covers spot and perps (including funding). Excludes unrealized PnL on open positions.
+             * @description Legacy realized PnL over the period, average-cost basis: gains/losses booked only when a position is reduced or closed, net of fees, with funding folded in. Excludes unrealized PnL on open positions. For the full PnL picture use totalPnl and pnlBreakdown, whose components follow the gross-of-fees convention instead.
              * @example -0.01
              */
             pnl?: string | null;
@@ -3773,6 +3901,31 @@ export interface components {
              * @example 0.00
              */
             maxDrawdown?: string | null;
+            /**
+             * @description Current unrealized PnL across open spot holdings (cost basis vs latest close) and open perp positions (entry vs mark). A live value, independent of the period parameter.
+             * @example 12.34
+             */
+            unrealizedPnl?: string | null;
+            /**
+             * @description Current lifetime total PnL: realized + unrealized - fundingPaid - fees, with realized components gross of fees. A live value, independent of the period parameter; the addends are in pnlBreakdown.
+             * @example 10.11
+             */
+            totalPnl?: string | null;
+            pnlBreakdown?: components["schemas"]["PnlBreakdown"];
+        };
+        GetPositionPnlHistoryResponse: {
+            /**
+             * Format: uuid
+             * @description Position UUID
+             * @example 123e4567-e89b-12d3-a456-426614174000
+             */
+            positionId?: string | null;
+            /**
+             * @description Interval used for this query
+             * @example 1h
+             */
+            interval?: string | null;
+            data?: components["schemas"]["PositionPnlPoint"][] | null;
         };
         GetPositionResponse: {
             positionId?: string | null;
@@ -3790,7 +3943,16 @@ export interface components {
             /** @description Current isolated collateral for this position's margin-account bucket. */
             isolatedMargin?: string | null;
             leverage?: string | null;
+            /**
+             * @description Maintenance margin required by this position at mark_price using the
+             *      market maintenance-margin rate. Zero when the position has no open exposure.
+             */
             maintenanceMarginRequired?: string | null;
+            /**
+             * @description Initial margin required by this position at mark_price, honoring both its
+             *      effective leverage and the market initial-margin floor. Zero when the
+             *      position has no open exposure.
+             */
             initialMarginRequired?: string | null;
             liquidationPrice?: string | null;
             status?: string | null;
@@ -3805,7 +3967,16 @@ export interface components {
             unrealizedPnl?: string | null;
             liquidationPrice?: string | null;
             marginRatio?: string | null;
+            /**
+             * @description Maintenance margin required by this position at mark_price using the
+             *      market maintenance-margin rate. Zero when the position has no open exposure.
+             */
             maintenanceMarginRequired?: string | null;
+            /**
+             * @description Initial margin required by this position at mark_price, honoring both its
+             *      effective leverage and the market initial-margin floor. Zero when the
+             *      position has no open exposure.
+             */
             initialMarginRequired?: string | null;
             updatedAt?: string | null;
         };
@@ -3863,6 +4034,10 @@ export interface components {
              */
             applicationMakerFeeBps?: number | null;
         };
+        GetRewardsBalanceResponse: {
+            /** @description One entry per reward token that has a non-zero available balance. */
+            balances?: components["schemas"]["RewardsBalanceEntry"][] | null;
+        };
         /** @description Paginated screener response sorted by quoteVolume24h desc (nulls last). */
         GetScreenerResponse: {
             items?: components["schemas"]["ScreenerItem"][] | null;
@@ -3911,6 +4086,10 @@ export interface components {
              */
             tradingMode?: string | null;
         };
+        GetTraderCodeInfoResponse: {
+            /** @description The resolved TraderCode (normalized wallet address) */
+            code?: string | null;
+        };
         /** @description Recent trades for a trading pair. */
         GetTradesResponse: {
             trades?: components["schemas"]["PublicTrade"][] | null;
@@ -4568,6 +4747,42 @@ export interface components {
              */
             createdAt?: string | null;
         };
+        /**
+         * @description Lifetime PnL components for the authenticated user. The fields satisfy
+         *      totalPnl = (spotRealized + perpsRealized) + (spotUnrealized + perpsUnrealized) - fundingPaid - fees.
+         */
+        PnlBreakdown: {
+            /**
+             * @description Cumulative realized spot PnL, average-cost basis, gross of fees; withdrawals realize at fair value
+             * @example 3.21
+             */
+            spotRealized?: string | null;
+            /**
+             * @description Unrealized PnL on current spot holdings: quantity x (latest close - average cost)
+             * @example 1.00
+             */
+            spotUnrealized?: string | null;
+            /**
+             * @description Cumulative realized perps PnL, gross of fees
+             * @example 5.55
+             */
+            perpsRealized?: string | null;
+            /**
+             * @description Unrealized PnL on open perp positions: quantity x (mark - entry)
+             * @example 2.00
+             */
+            perpsUnrealized?: string | null;
+            /**
+             * @description Cumulative funding paid; positive means paid, negative means received (same sign convention as the funding-payments endpoint). Subtracted in totalPnl.
+             * @example 0.50
+             */
+            fundingPaid?: string | null;
+            /**
+             * @description Cumulative trading fees; positive means charged, negative means rebated. Subtracted in totalPnl.
+             * @example 1.15
+             */
+            fees?: string | null;
+        };
         Position: {
             positionId?: string | null;
             /** @description Margin account UUID for the isolated bucket that owns this position. */
@@ -4584,7 +4799,16 @@ export interface components {
             /** @description Current isolated collateral for this position's margin-account bucket. */
             isolatedMargin?: string | null;
             leverage?: string | null;
+            /**
+             * @description Maintenance margin required by this position at mark_price using the
+             *      market maintenance-margin rate. Zero when the position has no open exposure.
+             */
             maintenanceMarginRequired?: string | null;
+            /**
+             * @description Initial margin required by this position at mark_price, honoring both its
+             *      effective leverage and the market initial-margin floor. Zero when the
+             *      position has no open exposure.
+             */
             initialMarginRequired?: string | null;
             liquidationPrice?: string | null;
             status?: string | null;
@@ -4608,6 +4832,52 @@ export interface components {
             orderId?: string | null;
             createdAt?: string | null;
         };
+        /**
+         * @description One PnL state sample for a position in one bucket. Cumulative fields are
+         *      lifetime values as of the bucket; fundingPaid and fees are cost-positive.
+         */
+        PositionPnlPoint: {
+            /**
+             * @description Bucket start timestamp (ISO 8601)
+             * @example 2026-02-18T00:00:00Z
+             */
+            bucketStart?: string | null;
+            /**
+             * @description Signed position quantity (negative for shorts)
+             * @example 1.50
+             */
+            quantity?: string | null;
+            /**
+             * @description Average entry price
+             * @example 95000.00
+             */
+            entryPrice?: string | null;
+            /**
+             * @description Mark price at the sample
+             * @example 95410.25
+             */
+            markPrice?: string | null;
+            /**
+             * @description Unrealized PnL at the sample: quantity x (mark - entry)
+             * @example 615.38
+             */
+            unrealizedPnl?: string | null;
+            /**
+             * @description Cumulative realized PnL, gross of fees
+             * @example 120.00
+             */
+            cumRealizedPnl?: string | null;
+            /**
+             * @description Cumulative funding paid; positive means paid, negative means received
+             * @example 3.20
+             */
+            cumFundingPaid?: string | null;
+            /**
+             * @description Cumulative trading fees; positive means charged, negative means rebated
+             * @example 1.75
+             */
+            cumFees?: string | null;
+        };
         PriceChange: {
             /**
              * @description Price 24 hours ago
@@ -4764,6 +5034,15 @@ export interface components {
              */
             message?: string | null;
         };
+        RewardsBalanceEntry: {
+            /** @description Reward token contract address (0x-prefixed). */
+            token?: string | null;
+            /**
+             * @description Available rewards balance in RAW atomic units of the token.
+             * @example 1200000
+             */
+            available?: string | null;
+        };
         RiskTier: {
             initialMarginRatio?: string | null;
             maintenanceMarginRatio?: string | null;
@@ -5172,6 +5451,15 @@ export interface components {
              */
             tradeId?: string | null;
         };
+        TraderCodeResponse: {
+            /** @description Your TraderCode — your normalized wallet address (clients render it `Monaco - <address>`). */
+            code?: string | null;
+            /**
+             * @description RFC 3339 timestamp when the code row was first derived
+             * @example 2026-07-07T18:00:00Z
+             */
+            createdAt?: string | null;
+        };
         /** @description Trading pair configuration including tokens, fees, and order limits. */
         TradingPairData: {
             /**
@@ -5285,6 +5573,11 @@ export interface components {
              * @example crypto
              */
             category?: string | null;
+            /**
+             * @description Minimum order quantity increment (lot size step) in base token
+             * @example 0.00001
+             */
+            quantityStepSize?: string | null;
         };
         TransferCollateralFromMarginAccountRequest: {
             /** @description Parent margin account UUID that releases collateral. */
@@ -5367,6 +5660,27 @@ export interface components {
             /** @description Trading pair UUIDs selected into the cross risk bucket. Required when marginMode is CROSS. */
             selectedTradingPairIds?: string[] | null;
         };
+        TransferRewardsRequest: {
+            /** @description Reward token contract address (0x-prefixed) to transfer. */
+            token: string;
+            /**
+             * @description Amount to transfer, in RAW atomic units of the token.
+             * @example 1000000
+             */
+            amount: string;
+        };
+        TransferRewardsResponse: {
+            /**
+             * @description Your rewards-bucket balance after the transfer, RAW atomic units.
+             * @example 0
+             */
+            rewardsBalance?: string | null;
+            /**
+             * @description Your trading balance for the token after the transfer, RAW atomic units.
+             * @example 1000000
+             */
+            tradingBalance?: string | null;
+        };
         UpdateLimitRequest: {
             /**
              * Format: uuid
@@ -5519,6 +5833,8 @@ export interface components {
              * @example 3b6a27bcceb6a42d62a3a8d02a6f0d73653215771de243a63ac048a18b59da29
              */
             sessionPublicKey: string;
+            /** @description Optional PitPass TraderCode captured at signup (e.g. from a `?ref=CODE` link). When a user verifies for the very first time with a valid code, a referral relationship is recorded atomically. Ignored for users who already exist, and silently ignored if the code is unknown — a bad code never blocks sign-in. */
+            referralCode?: string | null;
         };
         VerifyResponse: {
             /**
@@ -8559,6 +8875,162 @@ export interface operations {
             };
         };
     };
+    get_my_trader_code: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["TraderCodeResponse"];
+                };
+            };
+            /** @description Authentication required */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Internal server error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    get_trader_code_info: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                code: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["GetTraderCodeInfoResponse"];
+                };
+            };
+            /** @description Code not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Internal server error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    get_rewards_balance: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["GetRewardsBalanceResponse"];
+                };
+            };
+            /** @description Authentication required */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Internal server error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    transfer_rewards: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["TransferRewardsRequest"];
+            };
+        };
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["TransferRewardsResponse"];
+                };
+            };
+            /** @description Invalid token or amount */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Authentication required */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Insufficient rewards balance */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Internal server error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
     list_positions: {
         parameters: {
             query?: {
@@ -8745,6 +9217,63 @@ export interface operations {
             };
         };
     };
+    get_position_pnl_history: {
+        parameters: {
+            query: {
+                /** @description Sample interval */
+                interval: "1m" | "5m" | "15m" | "1h" | "4h" | "1d";
+                /** @description Start time as Unix timestamp (milliseconds) */
+                startTime?: number;
+                /** @description End time as Unix timestamp (milliseconds) */
+                endTime?: number;
+            };
+            header?: never;
+            path: {
+                positionId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["GetPositionPnlHistoryResponse"];
+                };
+            };
+            /** @description Invalid interval or time range */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Authentication required */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Position not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Internal server error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
     get_position_risk: {
         parameters: {
             query?: never;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@0xmonaco/types",
-	"version": "0.8.21",
+	"version": "0.8.22-develop.efb9dc9",
 	"type": "module",
 	"repository": {
 		"type": "git",
@@ -20,7 +20,7 @@
 		"lint": "biome lint ."
 	},
 	"dependencies": {
-		"@0xmonaco/contracts": "0.8.21",
+		"@0xmonaco/contracts": "0.8.22-develop.efb9dc9",
 		"zod": "^4.1.12"
 	},
 	"peerDependencies": {