TESTNET
Connect

Public trades

Public prints for a spot market live on client.market_data (not client.trades, which is your private fills). No authentication is required. Call await client.wait_for_catalogs() first; quantity decoding fails closed when the market scale is unavailable.

Methods

Method Summary
get_trades Recent public trades, newest first.
subscribe_trades Live public tape for one symbol.

Get trades

result = await client.market_data.get_trades(symbol="BTC-USDT", limit=20)
for t in result.trades:
    print(t.match_id, t.is_buy, t.price, t.qty, t.ts_ns)

# Continue with the page token when present
if result.next_page_token:
    more = await client.market_data.get_trades(
        symbol="BTC-USDT",
        limit=20,
        page_token=result.next_page_token,
    )
Field Notes
symbol / symbol_id One required
limit Default 100
start_time / end_time Optional range, inclusive
side Optional aggressor: buy / sell
page_token Opaque cursor
after_trade_id Backfill cursor; see below

To backfill trades a live stream missed, walk by trade ID instead: oldest first and gap-free. Start from after_trade_id=0 (or the last trade ID you hold) and pass each result's next_after_trade_id to the next call. Every trade up to complete_through_trade_id is returned, across trade-ID epoch ends (epoch_ends). When next_after_trade_id equals the ID you sent, nothing newer is available yet; retry later with backoff. after_trade_id cannot be combined with the time range, side, or page token.

Subscribe trades

Handshake completes before return. Consume with async for.

subscription = await client.market_data.subscribe_trades(symbol="BTC-USDT")
async with subscription:
    async for trade in subscription:
        print(trade.price, trade.qty, trade.is_buy)
        break

MarketTrade shape

symbol_id, match_id, is_buy, price, qty, ts_ns. Result wrapper: MarketTradesResult with trades, next_page_token, complete_through_trade_id, next_after_trade_id, and epoch_ends.

is_buy is a bool from the wire is_buy / isBuy field: True when the aggressor (taker) side is buy, False when the aggressor is sell. MarketTrade has no separate side string.

REST and realtime attach the same hydrated catalog scale to qty. The SDK does not decode public trade quantities using a guessed scale.

Address book Saved destinations and whitelist views. API keys List, get, subscribe, and generate local API key material (no create on API-key SDKs). Auth Auth service helpers including nested profile access. Balances Read ledger balances and history, see reserved amounts, and stream live balance updates. Candles Read and stream public spot OHLCV candles via market data (candles alias). Catalog Spot and Zipper catalog hydration, symbol lookups, and quantity scales used by decimal order writes. Chain helpers On-chain Funding → Trading and Funding withdraw helpers. Chain analytics Chain analytics read APIs. Client configuration Constructor options, URLs, catalogs, wire format, and from_env behavior. Deposit Create and list per-account chain deposit addresses for funding your Polyester account. Errors Python SDK error types, MFA auth codes, realtime overflow, and retry guidance. Fees Read effective spot fee rates, reserve rates, scheduled changes, and the fee breakdown with client.fees. Guard signer Guard signer approval helpers. Heatmap L2 order book heatmap reads. Internal transfers Move trading balances between Polyester accounts without touching a chain. Lifecycle Deposit/withdraw lifecycle flows and subscribe. Market overview List and subscribe to per-market stats with optional snapshot-then-stream merge. Order book Depth snapshots and a stateful live order book that reconstructs the book for you. Orders Place, modify, cancel, batch, and stream spot orders, with optional attached take-profit, stop-loss, and trailing-stop risk. Policies Realtime API-key and subaccount-policy updates. Profile Profile identity reads and subscribe helpers. Realtime Shared Centrifugo WebSocket client, subscription contract, handshake-before-return, and fail-closed overflow. Social verification Social verification APIs (reference-only). Subaccounts Subaccount reads, members, invites, activity. User trades List and stream your private spot fills (not the public tape). Transfers Transfer history reads. Triggers Create, manage, pause/resume, and stream standalone automations that place a child order when a market condition fires. Withdrawals Trading withdraw intents to funding or external chain destinations (signed payload). Zipper Deposit/withdraw config and related Zipper reads.
Previous

Profile
Next

Realtime