> ## 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.5.9

# Monaco Protocol SDK v0.5.9

## Movements API Cleanup & Order Status Update

This release removes the unsupported `source` filter from movements APIs and adds `SETTLED_ON_CHAIN` as a terminal order status.

***

## Breaking Changes

### `source` Removed from Movements APIs

The `source` parameter has been removed from `getPaginatedUserMovements()` and `useUserMovements()`. It was never supported by the API and would cause a 400 error if passed.

**Affected packages:** `@0xmonaco/types`, `@0xmonaco/core`, `@0xmonaco/react`, `@0xmonaco/mcp-server`

**Migration:**

```typescript theme={null}
// Before — would return a 400 error
await sdk.profile.getPaginatedUserMovements({ source: "hot_storage" });

// After — remove source, other filters still work
await sdk.profile.getPaginatedUserMovements({ page: 1, limit: 20 });
await sdk.profile.getPaginatedUserMovements({ entry_type: "CREDIT" });
await sdk.profile.getPaginatedUserMovements({ transaction_type: "TRADE" });
```

***

## New Features

### `SETTLED_ON_CHAIN` Order Status

`SETTLED_ON_CHAIN` is now a supported `OrderStatus` value. It represents the terminal state where a filled order has been fully settled on-chain.

**Full order lifecycle:**

```
SUBMITTED → PARTIALLY_FILLED → FILLED → SETTLED → SETTLED_ON_CHAIN
```

**Affected packages:** `@0xmonaco/types`, `@0xmonaco/mcp-server`

**Usage:**

```typescript theme={null}
const orders = await sdk.trading.getPaginatedOrders({ status: "SETTLED_ON_CHAIN" });
```

***

## Package Versions

| Package | Version |
| - | - |
| `@0xmonaco/core` | 0.5.9 |
| `@0xmonaco/react` | 0.5.9 |
| `@0xmonaco/types` | 0.5.9 |
| `@0xmonaco/mcp-server` | 0.5.9 |
| `@0xmonaco/contracts` | 0.5.9 |

```bash theme={null}
npm install @0xmonaco/core@0.5.9 @0xmonaco/react@0.5.9
```

All examples in these docs target the **staging** network (`https://staging.apimonaco.xyz`).


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