polymarket-hft 0.0.5

A high-frequency trading system for Polymarket with built-in API clients (Data API, CLOB, CLOB WebSocket, Gamma, RTDS) and CLI
Documentation

polymarket-hft

Crates.io Documentation License: MIT

A high-frequency trading (HFT) system for Polymarket with built-in API clients and CLI.

Features

  • 🚀 High Performance - Built on Tokio for high-performance async operations
  • 📊 Built-in APIs - Data API, Gamma, CLOB, and RTDS clients available
  • 🔌 Real-Time Streaming - WebSocket support for RTDS real-time data feeds
  • 🔒 Type-Safe - Strongly typed API with comprehensive error handling
  • 🔄 Auto Retry - Built-in exponential backoff retry for transient failures
  • 🛠️ CLI Tool - Command-line interface for quick API access and testing
  • ⚡ Low Latency - Optimized for trading scenarios requiring fast execution
  • 📚 Well-Documented - Extensive documentation and examples

Documentation

Document Description
Library Guide How to use the SDK as a Rust library
CLI Guide How to use the command-line interface
API Docs Full API documentation

Quick Start

As a Library

use polymarket_hft::client::data::Client;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let client = Client::new();
    let health = client.health().await?;
    println!("API status: {}", health.data);
    Ok(())
}

👉 See Library Guide for more details.

As a CLI

# Check API health
cargo run -- data health

# Get user's traded markets count
cargo run -- data get-user-traded-markets -u 0x56687bf447db6ffa42ffe2204a05edaa20f55839

# List latest Gamma markets
cargo run -- gamma get-markets -l 5

👉 See CLI Guide for more details.

Supported APIs

API Status Description
Data API ✅ Health, holders, value, traded, open interest, live volume, positions, trades, activity
Gamma Markets ✅ Sports, events, markets, tags, series, comments, search
CLOB ✅ Public REST endpoints available; private/WS pending
CLOB WebSocket ✅ Real-time orderbook updates, trade streams, user events
RTDS ✅ Real-time data streaming (prices, trades, orderbook, comments)

Installation

[dependencies]
polymarket-hft = "0.0.5"

Architecture

polymarket-hft/
├── src/
│   ├── client/
│   │   ├── data/       # Data API client
│   │   ├── clob/       # CLOB REST API client
│   │   │   └── ws/     # CLOB WebSocket client
│   │   ├── gamma/      # Gamma Markets API client
│   │   ├── rtds/       # RTDS WebSocket client
│   │   └── http.rs     # Shared HTTP client with retry middleware
│   ├── cli/            # CLI command implementations
│   └── main.rs         # CLI entry point

Development Status

🚧 This project is in active development.

Versioning Policy

Version Stability Description
0.0.x ⚠️ Early Development Breaking changes expected. APIs are experimental and not fully validated. Use for exploration only.
0.1.x 🔄 Beta Client APIs stabilized with no breaking changes within minor versions. Trading strategies remain experimental and may have breaking changes.
1.0.x ✅ Stable Full API stability. Trading strategies validated and stable.

[!CAUTION] Current 0.0.x versions are in early development. Expect breaking changes between releases. Do not use in production trading systems.

Current Status

  • ✅ Project structure and module organization
  • ✅ Data API client with 10 endpoints:
    • health - API health check
    • get_market_top_holders - Get top holders for markets
    • get_user_portfolio_value - Get total value of user's positions
    • get_user_traded_markets - Get user's traded markets count
    • get_open_interest - Get open interest for markets
    • get_event_live_volume - Get live volume for an event
    • get_user_positions - Get current positions for a user
    • get_user_closed_positions - Get closed positions for a user
    • get_user_activity - Get on-chain activity for a user
    • get_trades - Get trades for a user or markets
  • ✅ CLI tool for Data API
  • ✅ CI/CD pipeline (GitHub Actions)

Roadmap

  1. Implement Data API endpoints ✅
  2. Implement CLOB REST API endpoints
  3. Implement CLOB WebSocket connectivity ✅
  4. Implement Gamma Markets API endpoints ✅
  5. Implement RTDS streaming ✅
  6. Add HFT trading strategies framework
  7. Add comprehensive integration tests
  8. Publish to crates.io

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

# Clone the repository
git clone https://github.com/telepair/polymarket-hft.git
cd polymarket-hft

# Build the project
cargo build

# Run tests
cargo test

# Run the CLI
cargo run -- --help

License

This project is licensed under the MIT License - see the LICENSE file for details.

Disclaimer

This is an unofficial SDK and is not affiliated with Polymarket. Use at your own risk. This software is intended for educational and research purposes.

Links