Reading data with Info

The Info client covers every read: market data, account and order queries, and realtime WebSocket streams. It needs no wallet and signs nothing. Every method returns the raw parsed JSON — see the Info API pages for the exact response shapes.

from upside import Info
from upside.utils import constants

info = Info(base_url=constants.QA_API_URL)   # WebSocket starts automatically

Pass skip_ws=True to construct a REST-only client (no background WebSocket thread). Call info.close() when you are done to stop the WebSocket cleanly.

Market data

info.configs()                                   # contracts, coins, scales, tiers — cache this
info.l2_book(asset)                              # full order-book snapshot
info.market_state(asset)                         # mark / oracle / last price, funding
info.candle_snapshot(asset, "1m", start_ms, end_ms)   # historical OHLCV

configs is the source of truth for contract IDs, coin IDs, and the priceScale / qtyScale / tickSize / stepSize you need to convert display values to the raw integers the API expects. Fetch it once and cache it.

Account & orders

info.user_account(account_id, market_deployer_id)        # balances + positions
info.user_market_deployers(account_id)                   # market deployers the account is enrolled in
info.user_agents(account_id)                             # authorized API wallets
info.user_orders(account_id, market_deployer_id, contract_id=0)   # active open orders (0 = all contracts)
info.orders_by_ids(market_deployer_id, ["8280"])         # look up by exchange order id
info.orders_by_cloids(account_id, market_deployer_id, ["1778844423064"])  # look up by client order id
info.share_group_state(group_id=0)                       # portfolio-margin share group

account_id accepts an int or string; ids that are not found are simply omitted from the orders_by_ids / orders_by_cloids results.

WebSocket streams

The Info client manages one shared WebSocket connection. Subscribe with a subscription dict and a callback; the callback receives each decoded message. subscribe returns an integer subscription id you pass back to unsubscribe.

sid = info.subscribe(
    {"type": "l2Book", "asset": "1"},
    lambda m: print(m["data"]["bookVersion"]),
)
info.subscribe({"type": "trades", "asset": "1"}, print)

# Per-address (private) channels take the wallet address as `user`:
info.subscribe({"type": "orderUpdates", "user": "0x<address>"}, print)
info.subscribe({"type": "userFills", "user": "0x<address>"}, print)

info.unsubscribe({"type": "l2Book", "asset": "1"}, sid)
info.close()

Channels — see the WebSocket reference for payloads:

Scope	Channels
Public	`l2Book`, `bbo`, `trades`, `candle`, `config`
Per-address	`orderUpdates`, `openOrders`, `userFills`

The client pings every 30 seconds and automatically reconnects, replaying its active subscriptions. The WebSocket does not push position or balance changes — poll user_account for those.

Overview

Authentication

Request Format

Reference

SDKs

Reading data with Info

Market data

Account & orders

WebSocket streams

​Market data

​Account & orders

​WebSocket streams

Market data

Account & orders

WebSocket streams