polyte-data

Rust client library for Polymarket Data API.

The Data API provides access to Polymarket's data endpoints, including user positions, trades, holders, open interest, and live volume.

More information about this crate can be found in the crate documentation.

Installation

cargo add polyte-data

Usage

Basic Example

use polyte_data::DataApi;

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

    // Get positions for a user
    let positions = data.user("0x1234567890123456789012345678901234567890")
        .list_positions()
        .limit(10)
        .send()
        .await?;

    for position in positions {
        println!("{}: size {}", position.title, position.size);
    }

    Ok(())
}

Get User Traded Markets

let traded = data.user("0x...")
    .traded()
    .await?;

println!("Total markets traded: {}", traded.total_traded);

Get Trades

let trades = data.trades()
    .list()
    .limit(10)
    .send()
    .await?;

for trade in trades {
    println!("Trade: {} @ {}", trade.size, trade.price);
}

Get Holders

let holders = data.holders()
    .get("token_id_here")
    .send()
    .await?;

println!("Total holders: {}", holders.len());

Get Open Interest

let open_interest = data.open_interest()
    .get("condition_id_here")
    .send()
    .await?;

println!("Open interest: {}", open_interest.open_interest);

Get Live Volume

let volume = data.live_volume()
    .get("clob_token_id_here")
    .send()
    .await?;

println!("Live volume: {}", volume.volume);

Get Builder Leaderboard

use polyte_data::api::builders::TimePeriod;

let rankings = data.builders()
    .leaderboard()
    .time_period(TimePeriod::Week)
    .limit(10)
    .send()
    .await?;

for ranking in rankings {
    println!("#{} {} - volume: {}", ranking.rank, ranking.builder, ranking.volume);
}

Get Builder Volume Time Series

use polyte_data::api::builders::TimePeriod;

let volumes = data.builders()
    .volume()
    .time_period(TimePeriod::Month)
    .send()
    .await?;

for entry in volumes {
    println!("{}: {} - {}", entry.dt, entry.builder, entry.volume);
}

API Coverage

• Users: User positions and traded markets
• Trades: Trade history
• Holders: Token holder information
• Open Interest: Market open interest data
• Live Volume: Real-time trading volume
• Builders: Builder leaderboard and volume time series
• Health: API health checks

License

This project is licensed under the MIT License.