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

# Quickstart

> All interactions with Monaco happen through REST, WebSocket, or gRPC APIs. Connect directly, or use an SDK to manage the details for you.

## API URLs

<CodeGroup>
  ```text REST theme={null}
  https://staging.apimonaco.xyz/api
  ```

  ```text WebSocket theme={null}
  wss://ws-staging.apimonaco.xyz/ws
  ```

  ```text gRPC theme={null}
  https://staging.apimonaco.xyz
  ```
</CodeGroup>

## Build Surface Map

Each Build page starts with a surface map: use it to choose the REST route family, TypeScript SDK namespace, live WebSocket channel, or gRPC service for the action on that page.

| Family | Build page | Primary SDK namespace | REST / stream family |
| - | - | - | - |
| Wallets and auth | [Wallets & Auth](/developers/accounts/wallets) | `sdk.login()`, `sdk.auth` | `/auth`, WebSocket `Authenticate` |
| Balances | [Account Balances](/developers/account-balances) | `sdk.profile` | `/accounts`, `balances`, `movements` |
| Deposits and withdrawals | [Vault Deposits & Withdrawals](/developers/vault) | `sdk.vault`, `sdk.withdrawals` | `/withdrawals` plus vault contract actions |
| Perps collateral | [Perps Collateral](/developers/perps-collateral) | `sdk.marginAccounts` | `/margin` |
| Markets | [Markets](/developers/markets) | `sdk.market` | `/market` |
| Orderbooks and trades | [Orderbooks & Trades](/developers/orderbooks-trades) | `sdk.orderbook`, `sdk.trades` | `/orderbook`, `/trades`, public streams |
| Orders | [Order Management](/developers/trade) | `sdk.trading` | `/orders`, order streams |
| Positions | [Positions](/developers/positions) | `sdk.positions` | `/positions`, raw position streams |
| Delegated agents | [Delegated Agents](/developers/delegated-agents) | `sdk.delegatedAgents` | `/delegated-agents` |
| Test assets | [Testnet Faucet](/developers/faucet) | `sdk.faucet` | `/faucet` |

## SDKs

Official SDKs handle Monaco auth, request signing, request formatting, and trading workflows. Generated clients expose typed REST or gRPC clients for other languages.

### TypeScript

<Card title={<img src="https://cdn.simpleicons.org/typescript/3178C6" alt="" width="20" height="20" />} href="/sdk/typescript/intro">
  Build authenticated clients, sign requests, place and cancel orders, query markets and profiles, manage vault flows, and subscribe to live feeds.

  <div style={{ display: "flex", gap: "0.4rem", flexWrap: "wrap", marginTop: "0.9rem" }}>
    <code><span style={{ display: "inline-flex", alignItems: "center", gap: "0.25rem" }}><svg aria-hidden="true" width="13" height="13" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2.4" strokeLinecap="round" strokeLinejoin="round" style={{ flex: "0 0 auto" }}><path d="m16 18 6-6-6-6" /><path d="m8 6-6 6 6 6" /></svg>REST</span></code>
    <code><span style={{ display: "inline-flex", alignItems: "center", gap: "0.25rem" }}><svg aria-hidden="true" width="13" height="13" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2.4" strokeLinecap="round" strokeLinejoin="round" style={{ flex: "0 0 auto" }}><path d="m16 3 4 4-4 4" /><path d="M20 7H4" /><path d="m8 21-4-4 4-4" /><path d="M4 17h16" /></svg>WebSocket</span></code>
  </div>
</Card>

### React

<Card title={<img src="https://cdn.simpleicons.org/react/61DAFB" alt="" width="20" height="20" />} href="/sdk/react/intro">
  Provider and hooks for wallet login, live orderbooks and trades, user balances, positions, orders, fees, and vault actions in React apps.

  <div style={{ display: "flex", gap: "0.4rem", flexWrap: "wrap", marginTop: "0.9rem" }}>
    <code><span style={{ display: "inline-flex", alignItems: "center", gap: "0.25rem" }}><svg aria-hidden="true" width="13" height="13" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2.4" strokeLinecap="round" strokeLinejoin="round" style={{ flex: "0 0 auto" }}><path d="m16 18 6-6-6-6" /><path d="m8 6-6 6 6 6" /></svg>REST</span></code>
    <code><span style={{ display: "inline-flex", alignItems: "center", gap: "0.25rem" }}><svg aria-hidden="true" width="13" height="13" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2.4" strokeLinecap="round" strokeLinejoin="round" style={{ flex: "0 0 auto" }}><path d="m16 3 4 4-4 4" /><path d="M20 7H4" /><path d="m8 21-4-4 4-4" /><path d="M4 17h16" /></svg>WebSocket</span></code>
  </div>
</Card>

### Rust

<Card title={<img src="https://cdn.simpleicons.org/rust/B7410E" alt="" width="20" height="20" />} href="/sdk/rust-and-bsr">
  Backend clients for authenticated REST and gRPC integrations, including request signing, order management, account data, and market data.

  <div style={{ display: "flex", gap: "0.4rem", flexWrap: "wrap", marginTop: "0.9rem" }}>
    <code><span style={{ display: "inline-flex", alignItems: "center", gap: "0.25rem" }}><svg aria-hidden="true" width="13" height="13" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2.4" strokeLinecap="round" strokeLinejoin="round" style={{ flex: "0 0 auto" }}><path d="m16 18 6-6-6-6" /><path d="m8 6-6 6 6 6" /></svg>REST</span></code>
    <code><span style={{ display: "inline-flex", alignItems: "center", gap: "0.25rem" }}><svg aria-hidden="true" width="13" height="13" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2.8" strokeLinecap="round" strokeLinejoin="round" style={{ flex: "0 0 auto" }}><path d="M4 14a1 1 0 0 1-.78-1.63l9.9-10.2a.5.5 0 0 1 .86.46l-1.92 6.02A1 1 0 0 0 13 10h7a1 1 0 0 1 .78 1.63l-9.9 10.2a.5.5 0 0 1-.86-.46l1.92-6.02A1 1 0 0 0 11 14z" /></svg>gRPC</span></code>
  </div>
</Card>

### Other languages

Generate typed REST or gRPC clients from Monaco's published protobuf files for Go, Python, Java, C++, and other backend languages. Start with [Python, Go, C++ & More](/sdk/python-quickstart) or the [Buf registry](https://buf.build/monaco-sdk/api/tree).

## Authentication

Public market data can be read without a user session. Trading, account, deposit, withdrawal, and other user-specific routes require an authenticated wallet session. SDKs handle session creation, request signing, and session refresh. Direct integrations sign each request with a session key: over REST follow the [REST authentication flow](/api-reference#authentication-flow), and over gRPC follow [authenticated gRPC](/reference/grpc#authenticate-requests) (metadata names, canonical signing string, and a runnable signed example). See [Wallets & Auth](/developers/accounts/wallets) for Sei network, gas, wallet setup, and asset IDs.

<div style={{ margin: "1rem 0 1.5rem", border: "1px solid rgba(58, 85, 68, 0.18)", borderRadius: "10px", padding: "0.72rem 0.85rem", background: "rgba(58, 85, 68, 0.045)", fontSize: "0.86rem", lineHeight: 1.55 }}>
  <span style={{ display: "block", marginBottom: "0.18rem", fontSize: "0.72rem", fontWeight: 800, textTransform: "uppercase", letterSpacing: "0", color: "#3A5544" }}>Private alpha requirements</span>

  <span>
    Authenticated requests require a Monaco client ID. Email [team@0xmonaco.com](mailto:team@0xmonaco.com) to get one.
  </span>
</div>

## APIs

Applications require different connection patterns. REST is the most compatible request/response interface, WebSockets are for live market and account events, and gRPC is the typed low-latency path for backend services. Choose based on your infrastructure, tooling, and latency requirements.

### REST API

<Card title={<span style={{ color: "#3A5544" }}><svg aria-hidden="true" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2.4" strokeLinecap="round" strokeLinejoin="round"><path d="m16 18 6-6-6-6" /><path d="m8 6-6 6 6 6" /></svg></span>} href="/api-reference">
  Standard HTTP/JSON access to Monaco routes for market data, account state, orders, deposits, withdrawals, and admin workflows. Use it when you want broad tooling support, predictable request/response calls, or OpenAPI-based clients.

  <div style={{ display: "flex", gap: "0.4rem", flexWrap: "wrap", marginTop: "0.9rem" }}>
    <code>Most compatible and standard</code>
  </div>
</Card>

### WebSocket API

<Card title={<span style={{ color: "#3A5544" }}><svg aria-hidden="true" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2.4" strokeLinecap="round" strokeLinejoin="round"><path d="m16 3 4 4-4 4" /><path d="M20 7H4" /><path d="m8 21-4-4 4-4" /><path d="M4 17h16" /></svg></span>} href="/reference/websockets">
  Configurable live subscriptions for Monaco events: all trades, orderbook updates, candles, and authenticated streams for your own orders, balances, positions, and liquidation risk. Use it when your UI or service needs data pushed as markets move.

  <div style={{ display: "flex", gap: "0.4rem", flexWrap: "wrap", marginTop: "0.9rem" }}>
    <code>Best for listening to data</code>
  </div>
</Card>

### gRPC API

<Card title={<span style={{ color: "#3A5544" }}><svg aria-hidden="true" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2.8" strokeLinecap="round" strokeLinejoin="round"><path d="M4 14a1 1 0 0 1-.78-1.63l9.9-10.2a.5.5 0 0 1 .86.46l-1.92 6.02A1 1 0 0 0 13 10h7a1 1 0 0 1 .78 1.63l-9.9 10.2a.5.5 0 0 1-.86-.46l1.92-6.02A1 1 0 0 0 11 14z" /></svg></span>} href="/reference/grpc">
  Strongly typed HTTP/2 services for backend systems that need fast order entry, account queries, market data, and generated clients from Monaco protobuf contracts. Use it when latency and typed service contracts matter more than generic HTTP tooling.

  <div style={{ display: "flex", gap: "0.4rem", flexWrap: "wrap", marginTop: "0.9rem" }}>
    <code>Fastest for trading quickly</code>
  </div>
</Card>


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