Struct LightconeApiClient 

pub struct LightconeApiClient { /* private fields */ }

Lightcone REST API client.

Provides methods for all Lightcone API endpoints including markets, orderbooks, orders, positions, and price history.

Implementations

impl LightconeApiClient

pub fn new(base_url: impl Into<String>) -> ApiResult<Self>

Create a new client with the given base URL.

Uses default settings (30s timeout, connection pooling).

Errors

Returns an error if the HTTP client cannot be initialized.

pub fn builder(base_url: impl Into<String>) -> LightconeApiClientBuilder

Create a new client builder for custom configuration.

pub fn base_url(&self) -> &str

Get the base URL.

pub async fn health_check(&self) -> ApiResult<()>

Check API health.

Returns Ok(()) if the API is healthy.

pub async fn get_markets(&self) -> ApiResult<MarketsResponse>

Get all markets.

Returns a list of all markets with their metadata.

pub async fn get_market( &self, market_pubkey: &str, ) -> ApiResult<MarketInfoResponse>

Get market details by pubkey.

Returns complete market information including deposit assets.

pub async fn get_market_by_slug( &self, slug: &str, ) -> ApiResult<MarketInfoResponse>

Get market by URL-friendly slug.

pub async fn get_deposit_assets( &self, market_pubkey: &str, ) -> ApiResult<DepositAssetsResponse>

Get deposit assets for a market.

pub async fn get_orderbook( &self, orderbook_id: &str, depth: Option<u32>, ) -> ApiResult<OrderbookResponse>

Get orderbook depth.

Returns price levels for bids and asks.

Arguments

• orderbook_id - Orderbook identifier (can be “orderbook_id” or “market_pubkey:orderbook_id”)
• depth - Optional max price levels per side (0 or None = all)

pub async fn submit_order( &self, request: SubmitOrderRequest, ) -> ApiResult<OrderResponse>

Submit a new order.

The order must be pre-signed with the maker’s Ed25519 key.

pub async fn submit_full_order( &self, order: &FullOrder, orderbook_id: impl Into<String>, ) -> ApiResult<OrderResponse>

Submit a signed FullOrder to the API.

Convenience method that converts the order and submits it. This bridges on-chain order creation with REST API submission.

Arguments

• order - A signed FullOrder (must have called order.sign(&keypair))
• orderbook_id - Target orderbook (use order.derive_orderbook_id() or from market API)

Example

let mut order = FullOrder::new_bid(params);
order.sign(&keypair);

let response = api_client
    .submit_full_order(&order, order.derive_orderbook_id())
    .await?;

pub async fn cancel_order( &self, order_hash: &str, maker: &str, ) -> ApiResult<CancelResponse>

Cancel a specific order.

The maker must match the order creator.

pub async fn cancel_all_orders( &self, user_pubkey: &str, market_pubkey: Option<&str>, ) -> ApiResult<CancelAllResponse>

Cancel all orders for a user.

Optionally filter by market.

pub async fn get_user_positions( &self, user_pubkey: &str, ) -> ApiResult<PositionsResponse>

Get all positions for a user.

pub async fn get_user_market_positions( &self, user_pubkey: &str, market_pubkey: &str, ) -> ApiResult<MarketPositionsResponse>

Get user positions in a specific market.

pub async fn get_user_orders( &self, user_pubkey: &str, ) -> ApiResult<UserOrdersResponse>

Get all open orders and balances for a user.

pub async fn get_price_history( &self, params: PriceHistoryParams, ) -> ApiResult<PriceHistoryResponse>

Get historical price data (candlesticks).

pub async fn get_trades( &self, params: TradesParams, ) -> ApiResult<TradesResponse>

Get executed trades.

pub async fn admin_health_check(&self) -> ApiResult<AdminResponse>

Admin health check endpoint.

pub async fn create_orderbook( &self, request: CreateOrderbookRequest, ) -> ApiResult<CreateOrderbookResponse>

Create a new orderbook for a market.

Trait Implementations

impl Clone for LightconeApiClient

fn clone(&self) -> LightconeApiClient

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for LightconeApiClient

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.