Skip to main content

​
Monaco Protocol SDK v0.8.18

This release adds a fee-tier lookup and corrects spot equity valuation in portfolio stats. The new GET /api/v1/fees/tier endpoint (sdk.fees.getMyFeeTier) returns your current volume-based fee tier, your rolling 14-day volumes, how much more volume reaches the next tier, and a trading pair’s full six-row fee schedule — with a matching React hook and MCP tool.

​
Fixed

​
spotEquity valued at mark price

GET /api/v1/accounts/me/portfolio (sdk.profile.getPortfolioStats) now marks each spot balance to its current price before summing, instead of adding up raw token quantities as if every asset were worth one dollar. Previously spotEquity could be materially wrong in both directions — assets trading above a dollar were undercounted while sub-dollar assets were overcounted. totalEquity (which includes spotEquity) is corrected accordingly, and assets with no active USDC-quoted pair are valued at 0. The response shape is unchanged; only the values change.

​
Added

​
getMyFeeTier — query your fee tier

Monaco charges volume-based maker/taker fees across six tiers, recalculated daily from a trailing 14-day weighted volume (14d perp + 2.5 × 14d spot). The new endpoint returns, for the authenticated caller:
  • currentTierLevel — resolved tier, 1 (lowest volume) through 6 (highest).
  • weightedVolume14d — weighted 14-day volume used to resolve the tier.
  • spotVolume14d / perpVolume14d — the rolling 14-day spot and perp volume components.
  • volumeToNextTier / nextTierLevel — additional weighted volume needed to reach the next tier and its level; both omitted once you are at tier 6.
  • feeSchedule — the requested pair’s six rows (tierLevel, minVolumeThreshold, makerFeeBps, takerFeeBps), ascending by tier. Fees are in human basis points; a negative makerFeeBps is a rebate.
Surfaces
  • REST: GET /api/v1/fees/tier?tradingPairId=<uuid> (authenticated)
  • Core SDK: sdk.fees.getMyFeeTier({ tradingPairId })
  • React: useFees().getMyFeeTier({ tradingPairId })
  • MCP: get_my_fee_tier tool
  • gRPC: FeesService.GetMyFeeTier

​
Upgrade

This release is additive — existing request and response shapes are unchanged, and no code changes are required to upgrade.