Python — Overview

Install

pip install polynode

Requires Python 3.10+. For trading support (order placement on Polymarket):

pip install polynode[trading]

Quick Start

from polynode import PolyNode

pn = PolyNode(api_key="pn_live_...")

# Fetch top markets
markets = pn.markets(count=10)
print(f"{markets.count} markets, {markets.total} total")

# Search
results = pn.search("bitcoin")
print(results.results[0].question)

pn.close()

Context Manager

with PolyNode(api_key="pn_live_...") as pn:
    status = pn.status()
    print(f"Tracking {status.state.market_count} markets")

Sports and Online Context

Available in polynode>=0.10.5.

from polynode import PolyNode

with PolyNode(api_key="pn_live_...") as pn:
    state = pn.sports_game_state(
        "nba-cle-nyk-2026-05-31",
        price_limit_tokens=20,
    )

    context = pn.sports_game_context(
        "nba-cle-nyk-2026-05-31",
        sources=["online"],
        query_set="injuries",
        max_queries=2,
        max_per_query=5,
        include_state=True,
    )

    web = pn.search_online(
        "Cavaliers Knicks injury news",
        max_results=5,
    )

Async Client

Every method is available in both sync and async variants:

import asyncio
from polynode import AsyncPolyNode

async def main():
    async with AsyncPolyNode(api_key="pn_live_...") as pn:
        status = await pn.status()
        markets = await pn.markets(count=3)
        print(f"{status.state.market_count} markets, {status.ws_subscribers} ws subs")

asyncio.run(main())