Monaco Protocol SDK v0.8.22
This release ships the full unrealized-PnL surface — newunrealizedPnl, totalPnl, and pnlBreakdown fields on portfolio stats, six new chart metrics, and a new per-position PnL history endpoint — adds quantityStepSize to trading pairs, and fixes position endpoints to return position-scoped margin requirements instead of the parent-account aggregate.
Added
Quantity step size on trading pairs
TradingPair now exposes quantityStepSize (string): the base-token lot-size increment used to validate order quantity precision. Available on all trading-pair reads:
- REST —
GET /api/v1/market/pairs,GET /api/v1/market/pairs/{tradingPairId} - TypeScript SDK —
market.getPaginatedTradingPairs(),market.getTradingPair(tradingPairId) - gRPC —
MarketService.ListTradingPairs,MarketService.GetTradingPair
minOrderSize values that were below the provider or base-asset lot boundary have been raised to the next executable lot. maxOrderSize and tickSize semantics are unchanged.
Expanded PnL surface
Portfolio stats — unrealized PnL and breakdown
getPortfolioStats returns three new fields:
pnlBreakdown contains: spotRealized, spotUnrealized, perpsRealized, perpsUnrealized, fundingPaid, fees. fundingPaid is cost-positive (positive means paid out); negate it when displaying as a PnL contribution.
Portfolio chart — new metrics
getPortfolioChart now accepts six additional metric values: "unrealized_pnl", "total_pnl", "realized_pnl", "funding_paid", "fees", "equity". Each is served from PnL history snapshots with per-bucket forward-fill.
Position PnL history
A new endpoint returns bucketed PnL state samples for a single owned position:- REST —
GET /api/v1/positions/{positionId}/pnl/history?interval=&startTime=&endTime= - TypeScript SDK —
positions.getPositionPnlHistory(positionId, { interval, startTime?, endTime? }) - React SDK —
usePositionPnlHistory(positionId, { interval, startTime?, endTime? }) - gRPC —
PositionsService.GetPositionPnlHistory
interval accepts: "1m", "5m", "15m", "1h", "4h", "1d". Returns an array of PositionPnlPoint samples forward-filled within the requested window.
Fixed
Per-position initialMarginRequired and maintenanceMarginRequired
listPositions, getPosition, and getPositionRisk now return values scoped to the individual position rather than repeating the parent margin-account aggregate. Initial margin honors effective leverage and the market initial-margin floor; maintenance margin uses the market maintenance-margin rate. Positions with no open exposure return "0" for both fields. Request and response field names, types, and authentication requirements are unchanged.