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

# Protobuf Reference

> Packages, service groups, and protobuf entry points

Monaco's public gRPC API is defined by protobuf files in `protos/api/` and published through BSR as `buf.build/monaco-sdk/api`.

## Module

```text theme={null}
buf.build/monaco-sdk/api:main
```

## Package Layout

Each API service has its own package under `monaco.api.<service>`. Shared messages live under `monaco.common.*`.

```protobuf theme={null}
package monaco.api.auth;             // auth.proto
package monaco.api.orders;           // orders.proto
package monaco.api.accounts;         // accounts.proto
package monaco.api.market;           // market.proto
package monaco.api.orderbook;        // orderbook.proto
package monaco.api.trades;           // trades.proto
package monaco.api.fees;             // fees.proto
package monaco.api.applications;     // applications.proto
package monaco.api.withdrawals;      // withdrawals.proto
package monaco.api.delegated_agents; // delegated_agents.proto
package monaco.api.faucet;           // faucet.proto
package monaco.api.health;           // health.proto
package monaco.api.margin_accounts;  // margin_accounts.proto
package monaco.api.positions;        // positions.proto
package monaco.api.whitelist;        // whitelist.proto
```

## Core

<CardGroup cols={2}>
  <Card title="AuthService" icon="key" href="/grpc/protos/auth">
    Wallet auth, refresh, and revoke.
  </Card>

  <Card title="AccountsService" icon="user" href="/grpc/protos/accounts">
    Profiles, balances, movements, sub-accounts, trades, and portfolio data.
  </Card>

  <Card title="ApplicationsService" icon="gear" href="/grpc/protos/applications">
    Application config, users, balances, orders, movements, and stats.
  </Card>

  <Card title="HealthService" icon="server" href="/grpc/protos/health">
    Public service health checks.
  </Card>

  <Card title="WhitelistService" icon="list-check" href="/grpc/protos/whitelist">
    Retired public whitelist endpoint.
  </Card>
</CardGroup>

## Trading

<CardGroup cols={2}>
  <Card title="MarketService" icon="chart-candlestick" href="/grpc/protos/market">
    Trading pairs, candles, metadata, screener, funding, open interest, and perp market data.
  </Card>

  <Card title="OrdersService" icon="list-check" href="/grpc/protos/orders">
    Order entry, cancellation, replacement, batch operations, and order lookup.
  </Card>

  <Card title="OrderbookService" icon="book-open" href="/grpc/protos/orderbook">
    Public orderbook snapshots.
  </Card>

  <Card title="TradesService" icon="chart-line" href="/grpc/protos/trades">
    Public trade history and authenticated user trade history.
  </Card>

  <Card title="FeesService" icon="calculator" href="/grpc/protos/fees">
    Fee simulation.
  </Card>
</CardGroup>

## Perps

<CardGroup cols={2}>
  <Card title="MarginAccountsService" icon="scale" href="/grpc/protos/margin-accounts">
    Margin account summaries, collateral transfers, movements, and risk simulation.
  </Card>

  <Card title="PositionsService" icon="chart-line" href="/grpc/protos/positions">
    Position listing, close flows, risk, margin adjustments, history, and TP/SL.
  </Card>
</CardGroup>

## Vault and Delegation

<CardGroup cols={2}>
  <Card title="WithdrawalsService" icon="vault" href="/grpc/protos/withdrawals">
    Withdrawal allocation and signed calldata lookup.
  </Card>

  <Card title="DelegatedAgentsService" icon="user" href="/grpc/protos/delegated-agents">
    Delegated-agent registration, lookup, revocation, and delegated sessions.
  </Card>

  <Card title="FaucetService" icon="vault" href="/grpc/protos/faucet">
    Testnet token minting.
  </Card>
</CardGroup>

## Common Packages

Shared messages are imported by service packages and live under `protos/common/`.

```protobuf theme={null}
package monaco.common.trade;
package monaco.common.orders;
package monaco.common.user;
package monaco.common.balances;
package monaco.common.movements;
package monaco.common.sub_account;
package monaco.common.ohlcv;
package monaco.common.orderbook;
package monaco.common.faucet;
package monaco.common.enums;
```

For generated clients, start from the [gRPC API quickstart](/reference/grpc).


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