stakewiz-rs

Unofficial Rust client for the Stakewiz API — Solana validator analytics, Wiz Score, epoch info, and more.

Installation

[dependencies]
stakewiz-rs = "0.1"
tokio = { version = "1", features = ["full"] }

Quick Start

use stakewiz_rs::{StakewizClient, QueryParams};

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

    // Get a validator by vote account
    let v = client.get_validator("GE6atKoWiQ2pt3zL7N13pjNHjdLVys8LinG8qeJLcAiL").await?;
    println!("{} — APY: {:.2}%", v.name.unwrap_or_default(), v.apy_estimate.unwrap_or(0.0));

    // Get all stake accounts (includes deactivated)
    let stakes = client.get_validator_stakes("LSTmLs1DENX82ihc7jU134mydiV3NDEPXsRrekAY6Ys").await?;
    println!("Stake accounts: {}", stakes.len());

    // Query params: sort & limit
    let params = QueryParams::new().sort_desc("epoch").limit(10);
    let epoch_stakes = client.get_validator_total_stakes("GE6atK...", Some(&params)).await?;

    // Current epoch
    let epoch = client.get_epoch_info().await?;
    println!("Epoch {} — {:.0}s remaining", epoch.epoch, epoch.remaining_seconds);

    Ok(())
}

API Coverage

Custom HTTP Client

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

let http = Client::builder()
    .timeout(Duration::from_secs(30))
    .build()?;

let client = StakewizClient::with_http_client(http);

License

MIT