POST /info: Upside Read API Overview and Query Types

Every read operation on Upside flows through a single endpoint: POST https://dev.upsidemax.xyz/info. There is no authentication or signing required — you send a JSON body with a type field, and the API routes your request to the correct query handler. This unified design keeps integration simple whether you are fetching market data, inspecting your account, or looking up orders.

Cache configs responses locally — they only change when new contracts are listed. This avoids redundant round-trips for tick sizes, leverage tiers, and contract IDs on every request.

Endpoint

POST https://dev.upsidemax.xyz/info
Content-Type: application/json

All requests share the same shape: a JSON object with a required type string and any additional fields specific to the query.

{"type": "<query_type>", ...}

Available Query Types

Market Data

Retrieve live and historical market information for any contract.

Type	Description
`configs`	Market and contract configuration — tick sizes, leverage tiers, decimal scales
`candleSnapshot`	Historical OHLCV candles for a contract over a time range
`l2Book`	Full L2 order book snapshot for a contract
`marketState`	Mark price, index price, last trade price, and funding rate
`shareGroupState`	Portfolio share group definitions — contract membership and settlement coin

Account

Inspect your account balances, positions, and authorized agents.

Type	Description
`userMarketDeployers`	Enrolled market deployer IDs for your account
`userAccount`	Balances, open positions, and margin availability
`userAgents`	Authorized API wallet agents for a master account

Orders

Look up active and historical orders by various identifiers.

Type	Description
`userOrders`	All active open orders for an account
`ordersByIds`	Look up orders by exchange-assigned order ID
`ordersByCloids`	Look up orders by client-assigned order ID

configs: Fetch Market and Contract Configuration Data

⌘I

​Endpoint

​Available Query Types

Market Data

Account

Orders

Endpoint

Available Query Types