Skip to main content

​
2026-03-21

​
TypeScript SDK v0.4.4 — Enriched Data Methods

Eight new typed methods on the PolyNode client for all enriched data endpoints:
  • leaderboard() — top 20 traders by profit or volume, with period filtering
  • trending() — carousel, breaking markets, hot topics, featured events, and biggest movers
  • activity() — platform-wide trade feed (50 most recent)
  • movers() — markets with largest 24h price swings
  • traderProfile(wallet) — full trader stats: PnL, volume, trades, largest win
  • traderPnl(wallet, { period }) — cumulative PnL time series
  • event(slug) — full event detail with all sub-markets
  • marketsByCategory(category) — browse markets by category
All methods are fully typed with dedicated response interfaces. Install: 
npm install [email protected]

​
TypeScript SDK v0.4.3 — Cache UI Primitives

Four new features for building dashboards on top of the local cache.
  • View methods — watchlistSummary(), walletDashboard(), leaderboard(), marketOverview(). Pre-shaped data for common dashboard patterns. No SQL, no aggregation.
  • Reactive subscriptions — onChange() and onWalletChange() fire callbacks when new trades or settlements land from the live WebSocket stream. Returns an unsub() function for cleanup.
  • Export helpers — exportCSV(), exportJSON(), exportRows() dump filtered data for charting libraries, spreadsheets, or custom analysis.
  • Query builder — Chainable fluent API: .wallet(), .side(), .since(), .market(), .minPnl(), .limit(), .run(). Complex filters without writing SQL.
npm install [email protected]
Full documentation: Local Cache

​
2026-03-21

​
API — Enriched Data Endpoints

Eight new REST endpoints for trader analytics, market discovery, and platform trends.
  • GET /v1/leaderboard — Top 20 traders ranked by profit or volume (daily, weekly, monthly, all-time)
  • GET /v1/trader/{wallet} — Full trader profile: PnL, volume, trade count, largest win, portfolio value
  • GET /v1/trader/{wallet}/pnl — PnL time series at 4 resolutions (1D, 1W, 1M, ALL)
  • GET /v1/trending — Carousel highlights, breaking markets, hot topics, featured events, biggest movers
  • GET /v1/activity — Platform-wide live trade feed (last 50 trades with tx hashes)
  • GET /v1/event/{slug} — Full event data with all sub-markets, outcome prices, condition IDs
  • GET /v1/movers — Markets with the largest 24h price changes
  • GET /v1/markets/{category} — Category market listings with counts (crypto, politics, sports, etc.)
Rate limit: 1 request per second per API key. Responses cached 1-3 minutes.

​
TypeScript SDK v0.4.1

  • Fix: ESM imports now work correctly. v0.4.0 crashed on cache.start() when using import syntax.
  • Fix: Eliminated MODULE_TYPELESS_PACKAGE_JSON Node.js warning.
  • New: getActiveTestWallet() / getActiveTestWallets() — returns known-active wallet addresses for testing and examples.
npm install [email protected]

​
API — Wallet positions fix

  • Fixed firstTradeAt / lastTradeAt returning null for certain wallets on GET /v1/markets/{id}/positions?includeTrades=true.
  • Added fallback query path for wallets where the primary trade lookup returns empty.

​
API — Per-endpoint rate limiting

  • includeTrades=true on market positions now has its own 20 req/min rate limit per key.
  • Separate bucket from standard rate limit — doesn’t consume your normal quota.

​
2026-03-21

​
TypeScript SDK v0.4.0

  • New: Local Cache — SQLite-backed local storage for instant offline queries.
  • Backfill wallet history in seconds (1 request per wallet, up to 500 trades).
  • Live WebSocket stream keeps the cache up to date automatically.
  • Query trades, positions, and settlements locally with zero API calls.
  • Watchlist file with hot-reload and runtime add/remove API.
  • Full documentation at Local Cache.

​
Rust SDK v0.4.0

  • New: Local Cache ported from TypeScript. Same architecture, same SQL schema, same query methods.
  • Builder pattern: PolyNodeCache::builder(client).db_path(...).build()?
  • rusqlite (bundled) + notify as optional dependencies behind cache feature flag.

​
2026-03-20

​
Web Frontend

  • Speed comparison test redesigned with 3-second warm-up period, win % scoreboard, and visual win ratio bar.
  • Updated “Run this test yourself” code snippet to match new logic.

​
2026-03-19

​
TypeScript SDK v0.3.0

  • New: OrderbookEngine — higher-level orderbook client with shared state and filtered views per component.
  • New: LocalOrderbook — local orderbook state management.
  • New: ShortFormStream — condensed event stream for bandwidth-constrained environments.

​
API

  • Orderbook REST endpoints: /v1/orderbook/{token}, /v1/midpoint/{token}, /v1/spread/{token}.
  • Wallet trades limit parameter now allows up to 1,000 (was 500).

​
2026-03-15

​
API v1 — Initial Public Release

  • WebSocket streaming: settlements, trades, prices, blocks, wallets, markets, large trades, oracle, chainlink
  • REST API: markets, search, candles, stats, settlements, wallets
  • Orderbook streaming via ob.polynode.dev
  • RPC endpoint via rpc.polynode.dev — JSON-RPC with TX #1 delivery
  • CLI (pn) — stream events, query markets, manage API keys from the terminal