Rust SDK

The Rust crate provides Tokio clients for the complete V3 registry, event streaming, PN1 orderbooks, perps, short-form markets, and optional trading and cache features.

Install

Cargo.toml

[dependencies]
polynode = "0.15.2"
tokio = { version = "1", features = ["macros", "rt-multi-thread"] }

Keep the key outside source control:

export POLYNODE_API_KEY="pn_live_..."

First request

use polynode::{PolyNodeClient, V3RequestOptions};

#[tokio::main]
async fn main() -> polynode::Result<()> {
    let api_key = std::env::var("POLYNODE_API_KEY")
        .expect("Set POLYNODE_API_KEY");
    let client = PolyNodeClient::new(api_key)?;
    let stats = client
        .v3()
        .execute_named("GET /v3/stats", V3RequestOptions::default())
        .await?;
    println!("{stats:#}");
    Ok(())
}

Client surfaces

Entry point	Use it for
`client.v3()`	Complete V3 API registry
`client.stream(...)`	Settlements, confirmations, Chainlink prices, combos, and other events
`client.orderbook_stream(...)`	Raw orderbook messages
`OrderbookEngine::connect(...)`	Managed local books and PN1 integrity
`client.perps_stream()`	Managed V3 perps WebSocket
`client.short_form(...)`	Rotating 5m, 15m, 1h, and 4h crypto markets
`PolyNodeTrader`	Current V2 trading with the `trading` feature

V3 API

Call any registered V3 operation.

Settlement stream

Subscribe with replay and backpressure.

Short-form and TWAP

Rotate with the correct Chainlink window.

PN1 orderbook

Maintain fail-closed local state.

Perps stream

Subscribe to tickers, books, trades, and klines.

Trading and fees

Enable the trading feature and use V2 defaults.

Getting Started

Core Guides

Optional Helpers

TypeScript

Python

Rust

Charts (Browser)

Install

First request

Client surfaces

V3 API

Settlement stream

Short-form and TWAP

PN1 orderbook

Perps stream

Trading and fees

​Install

​First request

​Client surfaces

V3 API

Settlement stream

Short-form and TWAP

PN1 orderbook

Perps stream

Trading and fees

Install

First request

Client surfaces