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.

polyte-data 0.1.1