API Reference

PolyNode exposes authenticated REST APIs for Polymarket market data, wallet analytics, positions, trades, builders, orderbooks, profiles, search, and supporting tools.

Core APIs

API	Use it for
V3 Data API	Polymarket markets, positions, trades, wallet P&L, builders, combos, rewards, tags, fees, and global stats.
Wallet P&L	Wallet summaries, realized P&L, P&L events, open positions, and wallet activity.
Markets & Search	Market discovery, condition lookups, market-level positions, prices, trades, and candles.
Orderbook	Current orderbook, midpoint, and spread snapshots.
Profiles	Polymarket profile lookup and username setup flows.
Onchain V2	Legacy onchain V2 trade, position, redemption, volume, and candle endpoints.

Base URLs

Surface	Base URL
REST API	`https://api.polynode.dev`
WebSocket streams	`wss://polynode.dev/ws`
Orderbook stream	`wss://polynode.dev/orderbook/ws`

Authentication

Send your API key with either x-api-key, Authorization: Bearer <key>, or ?key=<key>.

Rate Limits

REST and streaming limits vary by plan. See Rate Limits for the current public limits, including the separate bucket for heavy trade-history endpoints.

Overview

V3 Data API

Wallet P&L

Wallet Activity

Credits

Identity

Fees

Combos

Rewards

Markets & Search

Orderbook

Leaderboard & Tags

Builders

Polymarket Profiles

Global

Tokens

Perps

Perps Market Data

Perps Wallets

Perps Analytics

Perps On-Chain

Perps Streaming

Crypto

Sports

BYOL

Backtesting

Market Card

System

Search & Context

Onchain V2 (legacy)

Core APIs

Base URLs

Authentication

Rate Limits

​Core APIs

​Base URLs

​Authentication

​Rate Limits

Core APIs

Base URLs

Authentication

Rate Limits