Markets
Market configuration, live statistics, candles, the resting book and per-tick solution history.
The indexer's solution time: the newest indexed batch deadline, in microseconds. Use it as since when subscribing over the websocket after a REST read.
Cache-Control: no-store.
Solution time
Unix time in microseconds, as a JSON number
1704153600000000The indexer or execution engine read failed. Body clob indexer unavailable, with Cache-Control: no-store. When the request set timestamp, a 503 may instead be the NodeBehind answer (JSON body, Retry-After: 1).
GET /v1/clob/status HTTP/1.1
Host: rpc.podtestnet.dev
Accept: */*
{
"solution_now": 1704153600000000
}Every market's static configuration and lifecycle status, including markets created after the node started. Live statistics are on /clob/markets/stats.
Cache-Control: public, max-age=60.
Market list
Static market configuration. Numeric amounts are decimal strings.
Lifecycle status.
32-byte value, 0x hex. Orderbook ids, order ids and hashes.
0x0000000000000000000000000000000000000000000000000000000000000001Pattern: ^0x[a-fA-F0-9]{64}${base_symbol}/{quote_symbol}
20-byte address, 0x hex
0x742d35Cc6634C0532925a3b844Bc9e7595f2bD28Pattern: ^0x[a-fA-F0-9]{40}$20-byte address, 0x hex
0x742d35Cc6634C0532925a3b844Bc9e7595f2bD28Pattern: ^0x[a-fA-F0-9]{40}$Order rows spell this perpetual.
Batch interval, microseconds
Fee rate as a decimal fraction, six places ("0.000150" is 1.5 bps).
Fee rate as a decimal fraction, six places.
Unsigned 256-bit integer, decimal string
1000000000000000000Pattern: ^[0-9]+$Unsigned 256-bit integer, decimal string
1000000000000000000Pattern: ^[0-9]+$Minimum quote notional per order, 1e18-scaled decimal string. "0" is no floor.
Initial-margin rate, 1e18-scaled decimal string, unrounded (max_leverage is rounded).
Period funding_rate applies over, microseconds
When a pending market goes live, microseconds. Omitted when not scheduled.
Scheduled halt, microseconds. Omitted when none.
Price open positions settle at, fixed when a perp market halts. 1e18-scaled decimal string. Omitted until then.
GET /v1/clob/markets HTTP/1.1
Host: rpc.podtestnet.dev
Accept: */*
Market list
[
{
"status": "active",
"id": "0x0000000000000000000000000000000000000000000000000000000000000001",
"name": "BTC/USD",
"base_token_address": "0x0000000000000000000000000000000000000b7c",
"quote_token_address": "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee",
"base_token_symbol": "BTC",
"quote_token_symbol": "USD",
"base_token_name": "Bitcoin",
"quote_token_name": "US Dollar",
"market_type": "perp",
"auction_interval_us": 100000,
"maker_fee": "0.000150",
"taker_fee": "0.000450",
"tick_precision": "1000000000000000000",
"lot_size": "1000000000000000",
"min_notional": "0",
"max_leverage": 20,
"initial_margin": "50000000000000000",
"funding_window_us": 3600000000
}
]Live per-market statistics, overlaying the forming candle. Same entry shape as the pod_markets websocket channel. Sorted by orderbook_id.
Cache-Control: no-store.
The lowest tick deadline accepted, in microseconds — typically the highest timestamp
(or solution_now) already held. The node answers once the state behind the route has
reached it, otherwise 503 after its wait (default 2s, POD_RPC_TIMESTAMP_WAIT).
Omitted means answer now.
Statistics for every market
Unix time in microseconds, as a JSON number
1704153600000000The indexer or execution engine read failed. Body clob indexer unavailable, with Cache-Control: no-store. When the request set timestamp, a 503 may instead be the NodeBehind answer (JSON body, Retry-After: 1).
GET /v1/clob/markets/stats HTTP/1.1
Host: rpc.podtestnet.dev
Accept: */*
{
"solution_now": 1704153600000000,
"markets": [
{
"orderbook_id": "0x0000000000000000000000000000000000000000000000000000000000000001",
"last_clearing_price": "65000000000000000000000",
"volume_24h": "120000000000000000000",
"high_24h": "66000000000000000000000",
"low_24h": "64000000000000000000000",
"price_change_24h": 125,
"oracle_price": "65010000000000000000000",
"mark_price": "65005000000000000000000",
"funding_rate": "12500000000000",
"open_interest": "3200000000000000000000000"
}
]
}Closed OHLCV bars in the half-open window [from, to), newest first. The forming bar is dropped after limit applies, so a page that reaches the present can hold one bar fewer than limit.
Page back with to = range.from_us / 1e6. The forming bar is the bucket containing solution_now_us; build it from the pod_candles websocket channel, subscribed with since one microsecond before that bucket's start.
An orderbook id that names no book returns an empty window.
Cache-Control: public, max-age=31536000, immutable once every bucket of the window has closed, otherwise no-store.
32-byte value, 0x hex. Orderbook ids, order ids and hashes.
0x0000000000000000000000000000000000000000000000000000000000000001Pattern: ^0x[a-fA-F0-9]{64}$The lowest tick deadline accepted, in microseconds — typically the highest timestamp
(or solution_now) already held. The node answers once the state behind the route has
reached it, otherwise 503 after its wait (default 2s, POD_RPC_TIMESTAMP_WAIT).
Omitted means answer now.
Window start, unix seconds, inclusive.
0Window end, unix seconds, exclusive. Defaults to solution time.
Maximum bars. Above 500 is a 400.
500Candle page
Unix time in microseconds, as a JSON number
1704153600000000Malformed path or query parameter. Plain-text reason.
The indexer or execution engine read failed. Body clob indexer unavailable, with Cache-Control: no-store. When the request set timestamp, a 503 may instead be the NodeBehind answer (JSON body, Retry-After: 1).
GET /v1/clob/candles/{orderbook}?resolution=1m HTTP/1.1
Host: rpc.podtestnet.dev
Accept: */*
{
"candles": [
{
"timestamp": 1704150000000000,
"open": "0xdc3a8351f3d86a00000",
"close": "0xdc3a8351f3d86a00000",
"high": "0xdc3a8351f3d86a00000",
"low": "0xdc3a8351f3d86a00000",
"volume": "0x2386f26fc10000",
"quote_volume": "0x8ac7230489e80000"
}
],
"resolution": "1h",
"range": {
"from_us": 1704150000000000,
"to_us": 1704150000000000
},
"solution_now_us": 1704153600000000
}The resting book as of the latest batch that cleared this orderbook. Optionally truncated to the best depth price levels per side; buys_count and sells_count still count the full book.
Cache-Control: no-store.
32-byte value, 0x hex. Orderbook ids, order ids and hashes.
0x0000000000000000000000000000000000000000000000000000000000000001Pattern: ^0x[a-fA-F0-9]{64}$The lowest tick deadline accepted, in microseconds — typically the highest timestamp
(or solution_now) already held. The node answers once the state behind the route has
reached it, otherwise 503 after its wait (default 2s, POD_RPC_TIMESTAMP_WAIT).
Omitted means answer now.
Best price levels per side. 0 is a 400. Omit for the whole book.
Orderbook snapshot
32-byte value, 0x hex. Orderbook ids, order ids and hashes.
0x0000000000000000000000000000000000000000000000000000000000000001Pattern: ^0x[a-fA-F0-9]{64}$Buy levels in the full book.
Sell levels in the full book.
Unsigned 256-bit integer, 0x hex
0x6f05b59d3b200000Pattern: ^0x[a-fA-F0-9]+$Unix time in microseconds, as a JSON number
1704153600000000The orderbook's current mark, carried forward on ticks without fills.
0x6f05b59d3b200000Pattern: ^0x[a-fA-F0-9]+$Perp only, 0x hex. null for spot.
Perp only, signed decimal string. null for spot.
Perp only, signed decimal string. null for spot.
Perp only, microseconds. null for spot.
Malformed path or query parameter. Plain-text reason.
No batch has cleared this orderbook since the node started, or the id names no
book. Body no orderbook snapshot yet.
GET /v1/clob/orderbook/{orderbook} HTTP/1.1
Host: rpc.podtestnet.dev
Accept: */*
{
"orderbook_id": "0x0000000000000000000000000000000000000000000000000000000000000001",
"buys": {
"ANY_ADDITIONAL_PROPERTY": {
"volume": "0x6f05b59d3b200000"
}
},
"sells": {
"ANY_ADDITIONAL_PROPERTY": {
"volume": "0x6f05b59d3b200000"
}
},
"buys_count": 1,
"sells_count": 1,
"grouping_precision": "0x6f05b59d3b200000",
"timestamp": 1704153600000000,
"new_orders_count": 1,
"clearing_price": "0x6f05b59d3b200000",
"oracle_price": "text",
"funding_rate": "text",
"funding_index": "text",
"funding_last_updated": 1
}Per-tick solution history: clearing, mark and oracle prices, volume, funding, open interest and the mark/funding inputs. Newest first, in whole ticks: limit counts ticks, and a tick carries one row per orderbook.
Page back by passing the oldest timestamp of the previous page as until_us.
An orderbook id that names no book returns no rows.
Cache-Control: no-store.
32-byte value, 0x hex. Orderbook ids, order ids and hashes.
0x0000000000000000000000000000000000000000000000000000000000000001Pattern: ^0x[a-fA-F0-9]{64}$Unix time in microseconds, as a decimal string
1704153600000000Pattern: ^[0-9]+$Unix time in microseconds, as a decimal string
1704153600000000Pattern: ^[0-9]+$Ticks per page, clamped to [1, 200].
200Solution rows
Malformed path or query parameter. Plain-text reason.
The indexer or execution engine read failed. Body clob indexer unavailable, with Cache-Control: no-store. When the request set timestamp, a 503 may instead be the NodeBehind answer (JSON body, Retry-After: 1).
GET /v1/clob/solutions HTTP/1.1
Host: rpc.podtestnet.dev
Accept: */*
{
"solutions": [
{
"orderbook_id": "0x0000000000000000000000000000000000000000000000000000000000000001",
"timestamp": 1704153600000000,
"clearing_price": "0x6f05b59d3b200000",
"mark_price": "0x6f05b59d3b200000",
"volume": "0x6f05b59d3b200000",
"oracle_price": "0x6f05b59d3b200000",
"funding_rate": "-1000000000000000000",
"funding_index": "-1000000000000000000",
"open_interest": "0x6f05b59d3b200000",
"mark_best_bid": "0x6f05b59d3b200000",
"mark_best_ask": "0x6f05b59d3b200000",
"premium_ema": "-1000000000000000000",
"book_median_ema": "0x6f05b59d3b200000",
"impact_bid": "0x6f05b59d3b200000",
"impact_ask": "0x6f05b59d3b200000"
}
]
}Last updated

