An ergonomic Rust client for interacting with Polymarket services, primarily the Central Limit Order Book (CLOB).
This crate provides strongly typed request builders, authenticated endpoints, alloy support and more.
- Overview
- Getting Started
- Examples
- Setting Token Allowances
- Minimum Supported Rust Version (MSRV)
- Contributing
- About Polymarket
- Typed CLOB requests (orders, trades, markets, balances, and more)
- Dual authentication flows
- Normal authenticated flow
- Builder authentication flow
- Type-level state machine
- Prevents using authenticated endpoints before authenticating
- Compile-time enforcement of correct transitions
- Signer support via
alloy::signers::Signer- Including remote signers, e.g. AWS KMS
- Zero-cost abstractions — no dynamic dispatch in hot paths
- Order builders for easy construction & signing
- Full
serdesupport - Async-first design with
reqwest
Add the crate to your Cargo.toml:
[dependencies]
polymarket-client-sdk = "0.1"or
cargo add polymarket-client-sdkThen run any of the examples
cargo run --example unauthenticatedSome hand-picked examples. Please see examples/ for more.
use polymarket_client_sdk::clob::Client;
#[tokio::main]
async fn main() -> anyhow::Result<()> {
let client = Client::default();
let ok = client.ok().await?;
println!("Ok: {ok}");
Ok(())
}Set POLYMARKET_PRIVATE_KEY as an environment variable with your private key.
EOA wallets
If using MetaMask or hardware wallet, you must first set token allowances. See Token Allowances section below.
use std::str::FromStr as _;
use alloy::signers::Signer as _;
use alloy::signers::local::LocalSigner;
use polymarket_client_sdk::{POLYGON, PRIVATE_KEY_VAR};
use polymarket_client_sdk::clob::{Client, Config};
#[tokio::main]
async fn main() -> anyhow::Result<()> {
let private_key = std::env::var(PRIVATE_KEY_VAR).expect("Need a private key");
let signer = LocalSigner::from_str(&private_key)?.with_chain_id(Some(POLYGON));
let client = Client::new("https://clob.polymarket.com", Config::default())?
.authentication_builder(&signer)
.authenticate()
.await?;
let ok = client.ok().await?;
println!("Ok: {ok}");
let api_keys = client.api_keys().await?;
println!("API keys: {api_keys:?}");
Ok(())
}For proxy/Safe wallets, create your client as such:
let client = Client::new("https://clob.polymarket.com", Config::default())?
.authentication_builder(&signer)
.funder(address!("<your-address>"))
.signature_type(SignatureType::Proxy)
.authenticate()
.await?;The funder address is the actual address that holds your funds on Polymarket. When using proxy wallets (email wallets like Magic or browser extension wallets), the signing key differs from the address holding the funds. The funder address ensures orders are properly attributed to your funded account.
The signature_type parameter tells the system how to verify your signatures:
signature_type=0(default): Standard EOA (Externally Owned Account) signatures - includes MetaMask, hardware wallets, and any wallet where you control the private key directlysignature_type=1: Email/Magic wallet signatures (delegated signing)signature_type=2: Browser wallet proxy signatures (when using a proxy contract, not direct wallet connections)
See SignatureType for more information.
Place a market order
use std::str::FromStr as _;
use alloy::signers::Signer as _;
use alloy::signers::local::LocalSigner;
use polymarket_client_sdk::{POLYGON, PRIVATE_KEY_VAR};
use polymarket_client_sdk::clob::{Client, Config};
use polymarket_client_sdk::types::{Amount, OrderType, Side};
use rust_decimal::Decimal;
#[tokio::main]
async fn main() -> anyhow::Result<()> {
let private_key = std::env::var(PRIVATE_KEY_VAR).expect("Need a private key");
let signer = LocalSigner::from_str(&private_key)?.with_chain_id(Some(POLYGON));
let client = Client::new("https://clob.polymarket.com", Config::default())?
.authentication_builder(&signer)
.authenticate()
.await?;
let order = client
.market_order()
.token_id("token")
.amount(Amount::usdc(Decimal::ONE_HUNDRED)?)
.side(Side::Buy)
.order_type(OrderType::FOK)
.build()
.await?;
let signed_order = client.sign(&signer, order).await?;
let response = client.post_order(signed_order).await?;
Ok(())
}Place a limit order
use std::str::FromStr as _;
use alloy::signers::Signer as _;
use alloy::signers::local::LocalSigner;
use polymarket_client_sdk::{POLYGON, PRIVATE_KEY_VAR};
use polymarket_client_sdk::clob::{Client, Config};
use polymarket_client_sdk::types::{Amount, OrderType, Side};
use rust_decimal::Decimal;
use rust_decimal_macros::dec;
#[tokio::main]
async fn main() -> anyhow::Result<()> {
let private_key = std::env::var(PRIVATE_KEY_VAR).expect("Need a private key");
let signer = LocalSigner::from_str(&private_key)?.with_chain_id(Some(POLYGON));
let client = Client::new("https://clob.polymarket.com", Config::default())?
.authentication_builder(&signer)
.authenticate()
.await?;
let order = client
.limit_order()
.token_id("1")
.size(Decimal::ONE_HUNDRED)
.price(dec!(0.1))
.side(Side::Buy)
.build()
.await?;
let signed_order = client.sign(&signer, order).await?;
let response = client.post_order(signed_order).await?;
Ok(())
}Remote signing
use std::str::FromStr as _;
use alloy::primitives::{Address, address};
use alloy::signers::Signer as _;
use alloy::signers::local::LocalSigner;
use polymarket_client_sdk::auth::builder::Config as BuilderConfig;
use polymarket_client_sdk::{POLYGON, PRIVATE_KEY_VAR};
use polymarket_client_sdk::clob::{Client, Config};
use polymarket_client_sdk::types::{SignatureType, TradesRequest};
#[tokio::main]
async fn main() -> anyhow::Result<()> {
let private_key = std::env::var(PRIVATE_KEY_VAR).expect("Need a private key");
let signer = LocalSigner::from_str(&private_key)?.with_chain_id(Some(POLYGON));
let builder_config = BuilderConfig::remote("http://localhost:3000/sign", None)?; // Or your signing server
let funder = address!("0xf39fd6e51aad88f6f4ce6ab8827279cfffb92266"); // Use your funder address
let client = Client::new("https://clob.polymarket.com", Config::default())?
.authentication_builder(&signer)
.funder(funder)
.signature_type(SignatureType::Proxy)
.authenticate()
.await?;
let client = client.promote_to_builder(builder_config)?;
let ok = client.ok().await?;
println!("Ok: {ok}");
let api_keys = client.api_keys().await?;
println!("API keys: {api_keys:?}");
let builder_trades = client.builder_trades(&TradesRequest::default(), None).await?;
println!("Builder trades: {builder_trades:?}");
Ok(())
}MetaMask and EOA users must set token allowances. If you are using a proxy or Safe-type wallet, then you do not.
Think of allowances as permissions. Before Polymarket can move your funds to execute trades, you need to give the exchange contracts permission to access your USDC and conditional tokens.
You need to approve two types of tokens:
- USDC (for deposits and trading)
- Conditional Tokens (the outcome tokens you trade)
Each needs approval for the exchange contracts to work properly.
Use examples/approvals.rs to approve the right contracts. Run once to approve USDC. Then change
the TOKEN_TO_APPROVE and run for each conditional token.
Pro tip: You only need to set these once per wallet. After that, you can trade freely.
MSRV: Rust 1.88
Older versions may compile, but are not supported.
This project aims to maintain compatibility with a Rust version that is at least six months old.
Version updates may occur more frequently than the policy guideline states if external forces require it. For example, a CVE in a downstream dependency requiring an MSRV bump would be considered an acceptable reason to violate the six-month guideline.
We encourage contributions from the community. Check out our contributing guidelines for instructions on how to contribute to this SDK.
Polymarket is the world’s largest prediction market, allowing you to stay informed and profit from your knowledge by betting on future events across various topics. Studies show prediction markets are often more accurate than pundits because they combine news, polls, and expert opinions into a single value that represents the market’s view of an event’s odds. Our markets reflect accurate, unbiased, and real-time probabilities for the events that matter most to you. Markets seek truth.