Crate monaco_sdk 

Monaco SDK

Typed Rust client for the Monaco DEX REST API — auto-generated from the OpenAPI specification via progenitor.

Quick start

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let client = monaco_sdk::Client::new("https://develop.apimonaco.xyz");

    // Public endpoints (no auth required)
    let health = client.health_check().await?.into_inner();
    println!("Status: {:?}", health.status);

    let pairs = client
        .list_trading_pairs(None, Some(true), None, None, None, None)
        .await?
        .into_inner();
    println!("Trading pairs: {:?}", pairs.trading_pairs);

    Ok(())
}

Authentication

Authenticated endpoints require a Bearer token obtained through the challenge → sign → verify flow. Pass it via a custom reqwest::Client:

use reqwest::header::{HeaderMap, HeaderValue, AUTHORIZATION};

let mut headers = HeaderMap::new();
headers.insert(
    AUTHORIZATION,
    HeaderValue::from_str("Bearer <your-jwt>").unwrap(),
);
let http = reqwest::ClientBuilder::new()
    .default_headers(headers)
    .build()
    .unwrap();
let client = monaco_sdk::Client::new_with_client("https://develop.apimonaco.xyz", http);

API coverage

The client exposes every operation from the Monaco REST API:

Category	Methods
Market data	list_trading_pairs, get_trading_pair_by_id, get_market_metadata, get_candles
Orderbook	get_orderbook_snapshot
Trades	get_trades
Orders	create_order, replace_order, cancel_order, get_orders, get_order_by_id
Batch orders	batch_create_orders, batch_replace_orders, batch_cancel_orders, batch_cancel_all, batch_cancel_all_by_pair
Accounts	get_user_profile, get_user_balances, get_user_balance_by_asset, get_user_movements
Sub-accounts	list_sub_accounts_with_balances, create_sub_account_limit, get_sub_account_limits, update_sub_account_limit, delete_sub_account_limit
Auth	create_challenge, verify_signature, refresh_token, revoke_session, authenticate_backend
Fees	simulate_fees
Whitelist	submit_whitelist
Faucet	mint_tokens
Health	health_check

All request/response types live in the types module.

Modules

prelude

Items consumers will typically use such as the Client.

types

Types used as operation parameters and responses.

Structs

ByteStream

Untyped byte stream used for both success and error responses.

Client

Client for Monaco Protocol API

ResponseValue

Typed value returned by generated client methods.

Enums

Error

Error produced by generated client methods.

Traits

ClientInfo

Interface for which an implementation is generated for all clients.