predict-fun-sdk

Rust SDK for the Predict.fun prediction market API on BNB Chain.

Features

• Full REST API coverage — all 30 endpoints from the OpenAPI spec
• EIP-712 order signing — native Rust via alloy, no ethers dependency
• Execution pipeline — auth → market lookup → sign → submit, with dry-run safety guard
• All 8 exchange contracts — mainnet + testnet × CTF/NegRisk/Yield/YieldNegRisk
• Amount math — predict_limit_order_amounts matches the official TypeScript SDK's getLimitOrderAmounts

Quick Start

use predict_fun_sdk::{PredictApiClient, PredictExecutionClient, PredictExecConfig};
use predict_fun_sdk::order::BNB_MAINNET_CHAIN_ID;

#[tokio::main]
async fn main() -> anyhow::Result<()> {
    // Public endpoints (no auth needed)
    let client = PredictApiClient::new_mainnet("your-api-key")?;
    let markets = client.list_markets(&[("limit", "10".to_string())]).await?;
    let ob = client.get_market_orderbook(12345).await?;

    // Authenticated order execution
    let config = PredictExecConfig {
        api_key: "your-api-key".into(),
        private_key: "0x...".into(),
        chain_id: BNB_MAINNET_CHAIN_ID,
        live_execution: false, // dry-run — won't submit orders
        fill_or_kill: true,
    };
    let exec = PredictExecutionClient::new(config).await?;

    // Place a limit order (dry-run)
    use predict_fun_sdk::{PredictLimitOrderRequest, PredictOutcome, PredictSide, PredictStrategy};
    let result = exec.place_limit_order(&PredictLimitOrderRequest {
        market_id: 12345,
        outcome: PredictOutcome::Yes,
        side: PredictSide::Buy,
        price_per_share: 0.45,
        quantity: 10.0,
        strategy: PredictStrategy::Limit,
        slippage_bps: None,
    }).await?;

    println!("Order hash: {}", result.prepared.signed_order.hash);
    println!("Submitted: {}", result.submitted); // false in dry-run

    Ok(())
}

Environment Variables

API Coverage

All 30 endpoints from the OpenAPI spec are covered:

Public — Markets, Orderbook, Timeseries, Categories, Tags, Search, Positions by address, Order matches

JWT-gated — Orders (create/list/cancel/get), Account, Activity, Positions, Yield pending

OAuth — Finalize, Orders (list/create/cancel), Positions

Architecture

predict_fun_sdk
├── api        — REST client, endpoint specs, raw/typed request helpers
├── order      — EIP-712 structs, signing, amount math, exchange addresses
└── execution  — High-level pipeline: auth → prepare → sign → submit

Exchange Contracts

References

• Predict.fun Dev Docs
• OpenAPI Explorer
• TypeScript SDK (reference implementation)
• Python SDK

License

MIT