Protobuf Reference

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

Module

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

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

AuthService

Wallet auth, refresh, and revoke.

AccountsService

Profiles, balances, movements, sub-accounts, trades, and portfolio data.

ApplicationsService

Application config, users, balances, orders, movements, and stats.

HealthService

Public service health checks.

WhitelistService

Retired public whitelist endpoint.

Trading

MarketService

Trading pairs, candles, metadata, screener, funding, open interest, and perp market data.

OrdersService

Order entry, cancellation, replacement, batch operations, and order lookup.

OrderbookService

Public orderbook snapshots.

TradesService

Public trade history and authenticated user trade history.

FeesService

Fee simulation.

Perps

MarginAccountsService

Margin account summaries, collateral transfers, movements, and risk simulation.

PositionsService

Position listing, close flows, risk, margin adjustments, history, and TP/SL.

Vault and Delegation

WithdrawalsService

Withdrawal allocation and signed calldata lookup.

DelegatedAgentsService

Delegated-agent registration, lookup, revocation, and delegated sessions.

FaucetService

Testnet token minting.

Common Packages

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

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.

Learn

Build

Libraries

APIs

Resources

Module

Package Layout

Core

AuthService

AccountsService

ApplicationsService

HealthService

WhitelistService

Trading

MarketService

OrdersService

OrderbookService

TradesService

FeesService

Perps

MarginAccountsService

PositionsService

Vault and Delegation

WithdrawalsService

DelegatedAgentsService

FaucetService

Common Packages

​Module

​Package Layout

​Core

AuthService

AccountsService

ApplicationsService

HealthService

WhitelistService

​Trading

MarketService

OrdersService

OrderbookService

TradesService

FeesService

​Perps

MarginAccountsService

PositionsService

​Vault and Delegation

WithdrawalsService

DelegatedAgentsService

FaucetService

​Common Packages

Module

Package Layout

Core

Trading

Perps

Vault and Delegation

Common Packages