> ## Documentation Index
> Fetch the complete documentation index at: https://docs.0xmonaco.com/llms.txt
> Use this file to discover all available pages before exploring further.

# V0.8.18

# 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](/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

```bash theme={null}
npm install @0xmonaco/core@0.8.18 @0xmonaco/types@0.8.18 @0xmonaco/react@0.8.18
# or bun
bun add @0xmonaco/core@0.8.18 @0xmonaco/types@0.8.18 @0xmonaco/react@0.8.18
```

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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.