precolator-sdk

Async Rust client SDK for the Precolator perpetual futures trading platform on Solana.

Features

• Full API coverage — markets, portfolio, trades, leaderboard, tokens, statistics
• Strongly typed — every endpoint returns a concrete Rust struct
• Async-first — built on tokio + reqwest
• Configurable — point at mainnet, devnet, or your own deployment
• Rate-limit aware — detects 429 responses and surfaces them as typed errors

Quick Start

[dependencies]
precolator-sdk = "1.0"
tokio = { version = "1", features = ["full"] }

use precolator_sdk::PrecolatorClient;

#[tokio::main]
async fn main() -> precolator_sdk::Result<()> {
    let client = PrecolatorClient::new("https://precolator.xyz");

    // List all markets
    let markets = client.get_markets().await?;
    for m in &markets {
        println!("{}: ${:.2}", m.name, m.price);
    }

    // Fetch a user portfolio
    let portfolio = client.get_portfolio("5TfY...xQw").await?;
    println!("Balance: {:.2}  PnL: {:.2}", portfolio.total_balance, portfolio.unrealized_pnl);

    // Platform stats
    let stats = client.get_platform_stats().await?;
    println!("Total volume: ${:.0}", stats.total_volume);

    Ok(())
}

Available Methods

Custom HTTP Client

use reqwest::Client;
use precolator_sdk::PrecolatorClient;
use std::time::Duration;

let http = Client::builder()
    .timeout(Duration::from_secs(10))
    .build()
    .unwrap();

let client = PrecolatorClient::with_client("https://precolator.xyz", http).unwrap();

Error Handling

The SDK uses PrecolatorError with variants for HTTP, API, rate-limits, and serialization errors:

use precolator_sdk::{PrecolatorClient, PrecolatorError};

match client.get_market("INVALID").await {
    Ok(m) => println!("{}", m.name),
    Err(PrecolatorError::NotFound(path)) => eprintln!("Not found: {path}"),
    Err(PrecolatorError::RateLimited { retry_after_secs }) => {
        eprintln!("Rate limited, retry in {retry_after_secs}s");
    }
    Err(e) => eprintln!("Error: {e}"),
}

License

Apache License 2.0 — see LICENSE for details.