polymarket-sdk-cpp

High-performance C++23 SDK for Polymarket prediction markets.

Features

• CLOB V2 — pUSD exchange, EIP-712 domain v2, Poly1271 smart-contract signatures, builder-code attribution, GET /version protocol auto-detection (current default)
• CLOB V1 — USDC.e exchange (still available alongside V2 — pin tag v1.0.0 or branch release/v1.x)
• Gamma API — Markets, events, tags, series (simdjson + arena allocator, zero-copy)
• CLOB API — Orderbook, prices, spreads, trading (Glaze compile-time JSON)
• Data API — Positions, trades, leaderboard, activity, open interest
• WebSocket — Real-time book/price/trade updates + V2 newmarket/marketresolved/bestbidask (opt-in via customfeatureenabled)
• RTDS — Live trade feed from ws-live-data.polymarket.com (whale tracking, copy trading)
• Crypto — Keccak-256, secp256k1, HMAC-SHA256, EIP-712 signing
• Auth — L1 wallet auth, L2 HMAC headers, order building + signing
• RFQ — Request-for-Quote (11 endpoints)

Quick Start

Fetch top market and orderbook

#include <polymarket/gamma/gamma_client.hpp>
#include <polymarket/clob/clob_client.hpp>
#include <cstdio>
using namespace polymarket;
int main() {     GammaClient gamma;     ClobClient  clob;
// Fetch the top market by volume     MarketsFilter f;     f.limit = 1; f.active = true; f.order = "volume"; f.ascending = false;     auto markets = gamma.get_markets(f);     if (!markets || markets->data.empty()) return 1;
auto& m = markets->data[0];     printf("Market: %.*s\n", (int)m.question.size(), m.question.data());
// Token IDs come from the Gamma API's clobtokenids field     // e.g. '["71321...","99421..."]' — see examples/03clobpublic.cpp for parsing     auto book = clob.book("71321045679252212594626385532706912750332728571942532289631379312455583992563");     if (book && !book->bids.empty())         printf("Best bid: %s @ %s\n", book->bids.back().price.cstr(), book->bids.back().size.cstr()); }

Real-time WebSocket

#include <polymarket/ws/ws_client.hpp>
using namespace polymarket;
WsClient ws; ws.on_book([](WsBookUpdate book) {     printf("Book update: %zu bids, %zu asks\n", book.bids.size(), book.asks.size()); }); ws.on_trade([](WsLastTradePrice t) {     printf("Trade: %s @ %s\n", t.assetid.cstr(), t.price.c_str()); }); ws.subscribe({"71321045679252212594626385532706912750332728571942532289631379312455583992563"}); ws.connect();  // non-blocking, I/O thread handles reconnect automatically

Authenticated trading (V2 — current default, pUSD exchange)

#include <polymarket/clob/authenticated_client.hpp>
using namespace polymarket;
Signer signer("0xYourPrivateKey"); AuthenticatedClobClient clob(signer, {api_key, secret, passphrase},     "0xYourProxyWalletAddress",     /chain_id=/137,     /host=/std::string(CLOBAPIURL),        // serves V2 directly     /sig_type=/SignatureType::Poly1271);      // match your wallet (see docs/auth.md)
// Optional: probe protocol version if (clob.is_v2()) printf("Connected to V2 (pUSD)\n");
auto signedorder = clob.buildorderv2(tokenid, "0.55", "100", Side::Buy); auto result = clob.placeorderv2(*signed_order); printf("Order: %s (%s)\n", result->orderID.cstr(), result->status.cstr());
clob.cancel_order(result->orderID); clob.cancelmarketorders();   // V2 endpoint

Authenticated trading (V1 — legacy, USDC.e exchange)

// V1 contracts still exist on-chain; use them for in-flight order settlement
// or pin v1.0.0 release: GIT_TAG v1.0.0 in FetchContent.
AuthenticatedClobClient clob(signer, {api_key, secret, passphrase},
    "0xYourProxyWalletAddress");                 // defaults to V1 host
auto order = clob.buildorder(tokenid, "0.55", "100", Side::Buy); auto result = clob.place_order(*order);

See examples/ for 10 complete runnable examples — including 09clobv2order_placement.cpp and 10protocol_detection.cpp.

Build

git clone https://github.com/Wammero/polymarket-sdk-cpp.git
cd polymarket-sdk-cpp
cmake -B build -DCMAKEBUILDTYPE=Release
cmake --build build -j$(nproc)

Run tests

# Unit tests (no network required)
ctest --test-dir build -R "^(crypto|auth|order|error|queryparams|jsonparse|containers|config|enums|rtds)$"
Integration tests (requires Python 3 — starts mock server automatically)
ctest --test-dir build -R "^api$"

Coverage report

cmake -B build-cov -DCMAKEBUILDTYPE=Debug \
    -DCMAKECXXFLAGS="--coverage -O0 -g" \
    -DCMAKEEXELINKER_FLAGS="--coverage"
cmake --build build-cov -j$(nproc)
ctest --test-dir build-cov
gcovr --root . --filter 'include/polymarket/' --filter 'src/' build-cov/ \
    --gcov-ignore-errors=sourcenotfound \
    --gcov-ignore-errors=noworkingdir_found \
    --print-summary

Use as dependency (FetchContent)

include(FetchContent)
V2 (current — pUSD, EIP-712 v2)
FetchContent_Declare(polymarket
    GIT_REPOSITORY https://github.com/Wammero/polymarket-sdk-cpp.git
    GIT_TAG v2.0.0)
V1 (legacy — USDC.e, EIP-712 v1)
FetchContent_Declare(polymarket
    GIT_REPOSITORY https://github.com/Wammero/polymarket-sdk-cpp.git
    GITTAG v1.0.0)        # or: GITTAG release/v1.x
FetchContent_MakeAvailable(polymarket) targetlinklibraries(your_app PRIVATE polymarket)

Versioning

Parallel-branch release strategy mirroring Polymarket's own clob-client → clob-client-v2 migration (archived 2026-05-11):

• v1.0.0 — last release targeting CLOB V1 (USDC.e, EIP-712 domain v1).

Tag: v1.0.0. Branch: release/v1.x for maintenance fixes.

• v2.0.0 — adds V2 support (pUSD, EIP-712 domain v2, new exchange

0xE111...996B, Poly1271 smart-contract signatures, builder attribution, GET /version auto-detection). V1 API surface is preserved alongside V2 — V1 callers compile unchanged.

Requirements

• C++23 compiler (GCC 13+, Clang 17+)
• CMake 3.21+
• OpenSSL
• libcurl
• Python 3 (for integration tests only)

All other dependencies fetched automatically via CMake FetchContent: simdjson, Glaze, secp256k1, ethash/keccak, unordered\_dense, uSockets, mimalloc, Catch2.

Test Coverage

555 test cases, 1760 assertions across 14 test suites (47 cases / 96 assertions are V2-tagged and cover the V2 EIP-712 hash, JSON wire format, Poly1271 signature type, contractconfigv2, and GET /version detection):

| Suite | Tests | Asserts | Covers | |-------|------:|--------:|--------| | crypto | 23 | 50 | Keccak-256, HMAC-SHA256, secp256k1 signer, base64url, hex | | auth | 8 | 19 | L1 EIP-712 wallet auth, L2 HMAC headers, Builder auth | | order | 68 | 315 | Decimal math, tick sizes, V1+V2 order hash, EIP-712 v1+v2 signing, V2 wire JSON | | error | 36 | 74 | Error constructors, factory methods, categorization, Result<T> | | query_params | 28 | 54 | QueryParams building, locale-independent float serialization | | json_parse | 57 | 110 | simdjson helpers, string-encoded numbers, optional/default fields | | containers | 99 | 359 | SmallVector inline/heap/grow/erase/swap, Arena (OOM, absorb), FixedStr | | config | 19 | 48 | V1 + V2 contractconfig for all chains + neg\risk, V2 URLs/constants | | enums | 39 | 122 | Side, OrderType, SignatureType (incl. Poly1271 = 3), TickSize, intervals | | rtds | 6 | 29 | RTDS trade/envelope parsing, array dispatch | | ws | 19 | 78 | WS event parsing, variant dispatch, V1 + V2 subscribe serialization | | bugfixes | 40 | 162 | Regression tests for previously-fixed defects | | api | 113 | 340 | CLOB (incl. V2 GET /version probe), Data, Gamma HTTP endpoints via mock server | | live_api | (opt-in) | — | Read-only smoke tests against production endpoints (skipped without creds) |

Integration tests (test_api) start a Python mock server automatically and exercise the public client classes end-to-end.

Performance

Benchmarked against the official Polymarket Rust SDK on the same machine. Identical JSON inputs. Rust: cargo bench (criterion). C++: nanobench.

| Operation | C++ | Rust | Speedup | |---|---|---|---| | Orderbook 10 levels | 949 ns | 1,792 ns | 1.9x | | Market response | 762 ns | 1,495 ns | 2.0x | | secp256k1 ECDSA sign | 17.3 us | 51.3 us | 3.0x | | Keccak-256 | 211 ns | 290 ns | 1.4x | | HMAC-SHA256 | 167 ns | 150 ns | 0.9x | | Order build + sign | 23 us | — | — |

JSON: Glaze compile-time reflection (C++) vs serde_json runtime (Rust). ECDSA: bitcoin-core/secp256k1 (C) vs alloy/k256 (pure Rust). HMAC: Rust slightly faster — both use platform-native crypto.

Architecture

| Layer | Library | Purpose | |-------|---------|---------| | Gamma JSON | simdjson on-demand + arena | Large arrays, zero-copy string_view | | CLOB/Data JSON | Glaze | Small responses, compile-time reflection | | WebSocket JSON | Glaze direct dispatch | Per-event-type parsing, no variant overhead | | WebSocket transport | uSockets (epoll/kqueue) | Custom frame parser, TLS, auto-reconnect | | HTTP | libcurl | Keep-alive, gzip, HTTP/2 | | Hashing | ethash/keccak | Keccak-256 with BMI2 | | Signing | bitcoin-core/secp256k1 | ECDSA sign + recovery | | HMAC | OpenSSL EVP\_MAC | SHA-256 with hardware acceleration | | Memory | mimalloc | Global allocator |

Examples

| # | File | Description | |---|------|-------------| | 01 | 01gamma_markets.cpp | Market lookup, events, pagination, batch fetch, tags | | 02 | 02gamma_streaming.cpp | Auto-pagination, streaming callbacks, predicate filtering | | 03 | 03clob_public.cpp | Orderbook, prices, spreads, batch queries, price history | | 04 | 04data_api.cpp | Leaderboard, positions, trades, activity, open interest | | 05 | 05websocket_market.cpp | Real-time book/price/trade streaming | | 06 | 06_credentials.cpp | Derive API credentials from private key | | 07 | 07order_placement.cpp | GTC/GTD/FOK orders, batch placement, cancellation (V1) | | 08 | 08whale_tracker.cpp | Live trade feed whale detection (RTDS + Data API) | | 09 | 09clobv2order_placement.cpp | V2 order placement (pUSD, EIP-712 domain v2, builder attribution) | | 10 | 10protocoldetection.cpp | V2 GET /version probe + isv2() |

Run examples after building:

./build/examples/01gammamarkets       # market data (no auth)
./build/examples/03clobpublic         # orderbook, prices (no auth)
./build/examples/10protocoldetection  # V2: GET /version probe (no auth)
./build/examples/08whaletracker       # live whale alerts (no auth, Ctrl+C to stop)
Authenticated:
./build/examples/09clobv2orderplacement   # V2 trading (needs POLY_* env vars)

For AI Agents

• llms.txt — Compact SDK overview for LLM context
• llms-full.txt — Complete API reference for writing code with this SDK

License

MIT