Cosmic Rust SDK 🚀

A comprehensive Rust SDK for accessing Cosmic Markets APIs, providing seamless integration with Solana DeFi protocols including Drift Protocol, Jupiter, Kamino, and more.

✨ Features

• 🎯 Drift Protocol V2 - Markets, positions, orders, PnL history, and analytics
• 🔄 Jupiter Integration - DCA orders, limit orders, and token analytics
• 💧 Kamino Finance - Swap data and analytics
• 📊 OHLC Data - Historical price data for tokens
• 👤 Trader Profiles - Trader scoring and performance metrics
• 🔍 Token Search - Comprehensive token discovery
• 🪶 Minimal Dependencies - Only 5 dependencies for a lightweight footprint

📦 Installation

Add this to your Cargo.toml:

[dependencies]
cosmic-rust-sdk = { git = "https://github.com/cosmic-markets/cosmic-rust-sdk", rev = "034d488" }

Note: For local development, use path = "." instead of the git dependency.

🚀 Quick Start

Basic Usage

use cosmic_rust_sdk::Cosmic;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    // Initialize client (no API key = rate limits apply)
    let client = Cosmic::new(None)?;

    // Fetch all Drift markets
    let markets = client.drift.get_all_markets(Default::default()).await?;
    println!("📊 Found {} markets", markets.content.len());

    Ok(())
}

With API Key (Recommended)

use cosmic_rust_sdk::Cosmic;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    // Initialize with API key for higher rate limits
    let client = Cosmic::new(Some("YOUR_API_KEY".to_string()))?;
    
    // Your code here...
    Ok(())
}

📚 Usage Examples

Fetch Perpetual Positions

use cosmic_rust_sdk::Cosmic;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let client = Cosmic::new(None)?;
    
    let wallet = "EXYq2HaS5nTarjzNHVYfcHbAbbLDJTPYkn1Jb5Q6bGz4";
    let positions = client.drift.get_user_perp_positions(wallet).await?;

    println!("📈 Found {} active positions", positions.len());
    
    for pos in positions {
        if let Some(market) = &pos.market_name {
            println!("Market: {}", market);
            println!("  Size: {} {}", 
                pos.base_asset_amount.unwrap_or(0.0),
                pos.base_asset_symbol.unwrap_or_default()
            );
            println!("  Unrealized PnL: ${:.2}", pos.unrealized_pnl.unwrap_or(0.0));
        }
    }

    Ok(())
}

Query Jupiter DCA Orders

use cosmic_rust_sdk::Cosmic;
use cosmic_rust_sdk::api::jupiter::GetDcaOrdersRequest;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let client = Cosmic::new(None)?;

    let request = GetDcaOrdersRequest {
        page: Some(1),
        size: Some(10),
        ..Default::default()
    };

    let orders = client.jupiter.get_orders(request).await?;
    println!("🔄 Found {} DCA orders", orders.content.len());

    Ok(())
}

Fetch Market Data

use cosmic_rust_sdk::Cosmic;
use cosmic_rust_sdk::api::drift::GetDriftMarketsRequest;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let client = Cosmic::new(None)?;

    let request = GetDriftMarketsRequest {
        size: Some(5),
        ..Default::default()
    };

    let markets = client.drift.get_all_markets(request).await?;
    
    for market in markets.content {
        println!("Market: {}", market.market_name.unwrap_or_default());
        println!("  Index: {}", market.market_index.unwrap_or(0));
        println!("  Type: {}", market.market_type.unwrap_or_default());
    }

    Ok(())
}

🔑 Authentication

To avoid strict rate limits, use an API key. You can purchase one at cosmic.markets/api/docs.

let client = Cosmic::new(Some("YOUR_API_KEY".to_string()))?;

📖 API Documentation

• 📘 Official API Docs
• 🦀 Rust Docs

🎯 Example Programs

Run these examples to see the SDK in action:

Example	Command	Description
Perp Positions	cargo run --example perp_positions	Retrieves active perpetual futures positions for a wallet
PnL History	cargo run --example pnl_history	Analyzes settled PnL over time for a specific market
DEX Volume	cargo run --example dex_volume	Tracks volume across Drift and Jupiter protocols
Limit Orders	cargo run --example limit_orders	Inspects recent limit order activity on Jupiter
DCA Orders	cargo run --example dca_orders	Inspects recent DCA order activity

🧪 Running Tests

When running tests without a paid API key, use single-threaded execution to avoid rate limits:

cargo test -- --test-threads=1

With a paid API key, you can run tests in parallel:

cargo test

🧩 Modules

Module	Description
drift	Drift Protocol V2 - Markets, positions, orders, history, and analytics
jupiter	Jupiter aggregator - DCA orders, limit orders, and token analytics
kamino	Kamino Finance - Swap data and analytics
ohlc	Historical OHLC price data for tokens
trader	Trader profiling, scoring, and performance metrics
search	Token search and discovery capabilities

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

🔗 Links

• 🌐 Cosmic Markets
• 📚 API Documentation
• 💬 GitHub Issues