> For the complete documentation index, see [llms.txt](https://docs.v2.pod.network/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.v2.pod.network/guides-references/references/rest/markets.md).

# Markets

Market configuration, live statistics, candles, the resting book and per-tick solution history.

&#x20;   &#x20;

## Get Solution Time

> 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\`.<br>

```json
{"openapi":"3.0.0","info":{"title":"REST API","version":"1.0.0"},"tags":[{"name":"Markets","description":"Market configuration, live statistics, candles, the resting book and per-tick\nsolution history.\n\n&nbsp; &nbsp; &nbsp;\n"}],"servers":[{"url":"https://staging-rpc.podtestnet.dev/v1","description":"Pod testnet"}],"paths":{"/clob/status":{"get":{"tags":["Markets"],"summary":"Get Solution Time","operationId":"getClobStatus","description":"The indexer's solution time: the newest indexed batch deadline, in microseconds.\nUse it as `since` when subscribing over the websocket after a REST read.\n\n`Cache-Control: no-store`.\n","responses":{"200":{"description":"Solution time","content":{"application/json":{"schema":{"type":"object","required":["solution_now"],"properties":{"solution_now":{"$ref":"#/components/schemas/Timestamp"}}}}}},"503":{"$ref":"#/components/responses/Unavailable"}}}}},"components":{"schemas":{"Timestamp":{"type":"integer","format":"int64","description":"Unix time in microseconds, as a JSON number"},"NodeBehindBody":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"$ref":"#/components/schemas/Timestamp","description":"The node's current value for the route."}}}},"responses":{"Unavailable":{"description":"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`).","content":{"text/plain":{"schema":{"type":"string"}},"application/json":{"schema":{"$ref":"#/components/schemas/NodeBehindBody"}}}}}}}
```

## List Markets

> 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\`.<br>

```json
{"openapi":"3.0.0","info":{"title":"REST API","version":"1.0.0"},"tags":[{"name":"Markets","description":"Market configuration, live statistics, candles, the resting book and per-tick\nsolution history.\n\n&nbsp; &nbsp; &nbsp;\n"}],"servers":[{"url":"https://staging-rpc.podtestnet.dev/v1","description":"Pod testnet"}],"paths":{"/clob/markets":{"get":{"tags":["Markets"],"summary":"List Markets","operationId":"getMarkets","description":"Every market's static configuration and lifecycle status, including markets\ncreated after the node started. Live statistics are on `/clob/markets/stats`.\n\n`Cache-Control: public, max-age=60`.\n","responses":{"200":{"description":"Market list","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/MarketStatic"}}}}}}}}},"components":{"schemas":{"MarketStatic":{"type":"object","description":"Static market configuration. Numeric amounts are decimal strings.","properties":{"status":{"type":"string","enum":["pending","active","disabled","settled"],"description":"Lifecycle status."},"id":{"$ref":"#/components/schemas/Bytes32"},"owner":{"$ref":"#/components/schemas/Address","description":"The market's owner, the only address that may disable, settle, rebind the oracle of or transfer it (see `transferMarket`)."},"name":{"type":"string","description":"`{base_symbol}/{quote_symbol}`"},"base_token_address":{"$ref":"#/components/schemas/Address"},"quote_token_address":{"$ref":"#/components/schemas/Address"},"base_token_symbol":{"type":"string"},"quote_token_symbol":{"type":"string"},"base_token_name":{"type":"string"},"quote_token_name":{"type":"string"},"market_type":{"type":"string","enum":["spot","perp"],"description":"Order rows spell this `perpetual`."},"auction_interval_us":{"type":"integer","format":"int64","description":"Batch interval, microseconds"},"maker_fee":{"type":"string","description":"Fee rate as a decimal fraction, six places (`\"0.000150\"` is 1.5 bps)."},"taker_fee":{"type":"string","description":"Fee rate as a decimal fraction, six places."},"tick_precision":{"$ref":"#/components/schemas/DecimalUint256"},"lot_size":{"$ref":"#/components/schemas/DecimalUint256"},"min_notional":{"type":"string","description":"Minimum quote notional per order, 1e18-scaled decimal string. `\"0\"` is no floor."},"max_leverage":{"type":"integer"},"initial_margin":{"type":"string","description":"Initial-margin rate, 1e18-scaled decimal string, unrounded (`max_leverage` is rounded)."},"funding_window_us":{"type":"integer","format":"int64","description":"Period `funding_rate` applies over, microseconds"},"live_at_us":{"type":"integer","format":"int64","description":"When a `pending` market goes live, microseconds. Omitted when not scheduled."},"disable_at_us":{"type":"integer","format":"int64","description":"Scheduled halt, microseconds. Omitted when none."},"settlement_price":{"type":"string","description":"Price open positions settle at, fixed when a perp market halts. 1e18-scaled decimal string. Omitted until then."}}},"Bytes32":{"type":"string","pattern":"^0x[a-fA-F0-9]{64}$","description":"32-byte value, `0x` hex. Orderbook ids, order ids and hashes."},"Address":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"20-byte address, `0x` hex"},"DecimalUint256":{"type":"string","pattern":"^[0-9]+$","description":"Unsigned 256-bit integer, decimal string"}}}}
```

## Get Market Statistics

> 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\`.<br>

```json
{"openapi":"3.0.0","info":{"title":"REST API","version":"1.0.0"},"tags":[{"name":"Markets","description":"Market configuration, live statistics, candles, the resting book and per-tick\nsolution history.\n\n&nbsp; &nbsp; &nbsp;\n"}],"servers":[{"url":"https://staging-rpc.podtestnet.dev/v1","description":"Pod testnet"}],"paths":{"/clob/markets/stats":{"get":{"tags":["Markets"],"summary":"Get Market Statistics","operationId":"getMarketStats","description":"Live per-market statistics, overlaying the forming candle. Same entry shape as the\n`pod_markets` websocket channel. Sorted by `orderbook_id`.\n\n`Cache-Control: no-store`.\n","parameters":[{"$ref":"#/components/parameters/MinTimestamp"}],"responses":{"200":{"description":"Statistics for every market","content":{"application/json":{"schema":{"type":"object","required":["solution_now","markets"],"properties":{"solution_now":{"$ref":"#/components/schemas/Timestamp"},"markets":{"type":"array","items":{"$ref":"#/components/schemas/MarketStats"}}}}}}},"503":{"$ref":"#/components/responses/Unavailable"}}}}},"components":{"parameters":{"MinTimestamp":{"name":"timestamp","in":"query","description":"The lowest tick deadline accepted, in microseconds — typically the highest `timestamp`\n(or `solution_now`) already held. The node answers once the state behind the route has\nreached it, otherwise `503` after its wait (default 2s, `POD_RPC_TIMESTAMP_WAIT`).\nOmitted means answer now.\n","schema":{"type":"integer","format":"int64"}}},"schemas":{"Timestamp":{"type":"integer","format":"int64","description":"Unix time in microseconds, as a JSON number"},"MarketStats":{"type":"object","description":"Live statistics for one market. Prices and amounts are 1e18-scaled decimal\nstrings. Optional fields are omitted until the data exists.\n","required":["orderbook_id","volume_24h"],"properties":{"orderbook_id":{"$ref":"#/components/schemas/Bytes32"},"last_clearing_price":{"type":"string","description":"Omitted until the market's first fill."},"volume_24h":{"type":"string","description":"Quote notional traded over 24 hours."},"high_24h":{"type":"string","description":"Omitted until the market has a closed candle."},"low_24h":{"type":"string","description":"Omitted until the market has a closed candle."},"price_change_24h":{"type":"integer","description":"24-hour price change in basis points."},"oracle_price":{"type":"string","description":"Perp only."},"internal":{"type":"boolean","description":"`true` when `oracle_price` is derived from the book because every oracle source was stale."},"mark_price":{"type":"string","description":"Perp only."},"funding_rate":{"type":"string","description":"Perp only. Signed."},"funding_index":{"type":"string","description":"Perp only. Signed, undivided funding accumulator."},"funding_settling_index":{"type":"string","description":"Perp only. The index positions settle against (`funding_settling_index × size − funding_basis` is a position's accrual). Absent until the market's first perp batch after the node started."},"funding_last_updated_us":{"type":"integer","format":"int64","description":"Perp only."},"open_interest":{"type":"string","description":"Perp only. USD notional."}}},"Bytes32":{"type":"string","pattern":"^0x[a-fA-F0-9]{64}$","description":"32-byte value, `0x` hex. Orderbook ids, order ids and hashes."},"NodeBehindBody":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"$ref":"#/components/schemas/Timestamp","description":"The node's current value for the route."}}}},"responses":{"Unavailable":{"description":"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`).","content":{"text/plain":{"schema":{"type":"string"}},"application/json":{"schema":{"$ref":"#/components/schemas/NodeBehindBody"}}}}}}}
```

## Get Candles

> 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\`.<br>

```json
{"openapi":"3.0.0","info":{"title":"REST API","version":"1.0.0"},"tags":[{"name":"Markets","description":"Market configuration, live statistics, candles, the resting book and per-tick\nsolution history.\n\n&nbsp; &nbsp; &nbsp;\n"}],"servers":[{"url":"https://staging-rpc.podtestnet.dev/v1","description":"Pod testnet"}],"paths":{"/clob/candles/{orderbook}":{"get":{"tags":["Markets"],"summary":"Get Candles","operationId":"getCandles","description":"Closed OHLCV bars in the half-open window `[from, to)`, newest first. The forming\nbar is dropped after `limit` applies, so a page that reaches the present can hold\none bar fewer than `limit`.\n\nPage back with `to = range.from_us / 1e6`. The forming bar is the bucket containing\n`solution_now_us`; build it from the `pod_candles` websocket channel, subscribed\nwith `since` one microsecond before that bucket's start.\n\nAn orderbook id that names no book returns an empty window.\n\n`Cache-Control: public, max-age=31536000, immutable` once every bucket of the\nwindow has closed, otherwise `no-store`.\n","parameters":[{"$ref":"#/components/parameters/OrderbookPath"},{"$ref":"#/components/parameters/MinTimestamp"},{"name":"resolution","in":"query","required":true,"schema":{"$ref":"#/components/schemas/CandleResolution"}},{"name":"from","in":"query","description":"Window start, unix seconds, inclusive.","schema":{"type":"integer","format":"int64","default":0}},{"name":"to","in":"query","description":"Window end, unix seconds, exclusive. Defaults to solution time.","schema":{"type":"integer","format":"int64"}},{"name":"limit","in":"query","description":"Maximum bars. Above 500 is a `400`.","schema":{"type":"integer","minimum":0,"maximum":500,"default":500}}],"responses":{"200":{"description":"Candle page","content":{"application/json":{"schema":{"type":"object","required":["candles","resolution","range","solution_now_us"],"properties":{"candles":{"type":"array","items":{"$ref":"#/components/schemas/Candle"}},"resolution":{"$ref":"#/components/schemas/CandleResolution"},"range":{"type":"object","nullable":true,"description":"Bucket starts of the oldest and newest bar returned, in microseconds. `null` when no bar matched.","properties":{"from_us":{"type":"integer","format":"int64"},"to_us":{"type":"integer","format":"int64"}}},"solution_now_us":{"$ref":"#/components/schemas/Timestamp"}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"503":{"$ref":"#/components/responses/Unavailable"}}}}},"components":{"parameters":{"OrderbookPath":{"name":"orderbook","in":"path","required":true,"description":"32-byte orderbook id.","schema":{"$ref":"#/components/schemas/Bytes32"}},"MinTimestamp":{"name":"timestamp","in":"query","description":"The lowest tick deadline accepted, in microseconds — typically the highest `timestamp`\n(or `solution_now`) already held. The node answers once the state behind the route has\nreached it, otherwise `503` after its wait (default 2s, `POD_RPC_TIMESTAMP_WAIT`).\nOmitted means answer now.\n","schema":{"type":"integer","format":"int64"}}},"schemas":{"Bytes32":{"type":"string","pattern":"^0x[a-fA-F0-9]{64}$","description":"32-byte value, `0x` hex. Orderbook ids, order ids and hashes."},"CandleResolution":{"type":"string","enum":["1m","5m","15m","30m","1h","4h","1d","1w","1M"]},"Candle":{"type":"object","description":"One closed OHLCV bar. Prices and volumes are 1e18-scaled `0x` hex.","properties":{"timestamp":{"$ref":"#/components/schemas/Timestamp"},"open":{"$ref":"#/components/schemas/HexUint256"},"close":{"$ref":"#/components/schemas/HexUint256"},"high":{"$ref":"#/components/schemas/HexUint256"},"low":{"$ref":"#/components/schemas/HexUint256"},"volume":{"$ref":"#/components/schemas/HexUint256","description":"Base volume traded in the bucket."},"quote_volume":{"$ref":"#/components/schemas/HexUint256","description":"Quote notional traded in the bucket."}}},"Timestamp":{"type":"integer","format":"int64","description":"Unix time in microseconds, as a JSON number"},"HexUint256":{"type":"string","pattern":"^0x[a-fA-F0-9]+$","description":"Unsigned 256-bit integer, `0x` hex"},"NodeBehindBody":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"$ref":"#/components/schemas/Timestamp","description":"The node's current value for the route."}}}},"responses":{"BadRequest":{"description":"Malformed path or query parameter. Plain-text reason.","content":{"text/plain":{"schema":{"type":"string"}}}},"Unavailable":{"description":"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`).","content":{"text/plain":{"schema":{"type":"string"}},"application/json":{"schema":{"$ref":"#/components/schemas/NodeBehindBody"}}}}}}}
```

## Get Orderbook

> 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\`.<br>

```json
{"openapi":"3.0.0","info":{"title":"REST API","version":"1.0.0"},"tags":[{"name":"Markets","description":"Market configuration, live statistics, candles, the resting book and per-tick\nsolution history.\n\n&nbsp; &nbsp; &nbsp;\n"}],"servers":[{"url":"https://staging-rpc.podtestnet.dev/v1","description":"Pod testnet"}],"paths":{"/clob/orderbook/{orderbook}":{"get":{"tags":["Markets"],"summary":"Get Orderbook","operationId":"getOrderbook","description":"The resting book as of the latest batch that cleared this orderbook. Optionally\ntruncated to the best `depth` price levels per side; `buys_count` and\n`sells_count` still count the full book.\n\n`Cache-Control: no-store`.\n","parameters":[{"$ref":"#/components/parameters/OrderbookPath"},{"$ref":"#/components/parameters/MinTimestamp"},{"name":"depth","in":"query","description":"Best price levels per side. `0` is a `400`. Omit for the whole book.","schema":{"type":"integer","minimum":1}}],"responses":{"200":{"description":"Orderbook snapshot","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrderbookSnapshot"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"404":{"description":"No batch has cleared this orderbook since the node started, or the id names no\nbook. Body `no orderbook snapshot yet`.\n","content":{"text/plain":{"schema":{"type":"string"}}}}}}}},"components":{"parameters":{"OrderbookPath":{"name":"orderbook","in":"path","required":true,"description":"32-byte orderbook id.","schema":{"$ref":"#/components/schemas/Bytes32"}},"MinTimestamp":{"name":"timestamp","in":"query","description":"The lowest tick deadline accepted, in microseconds — typically the highest `timestamp`\n(or `solution_now`) already held. The node answers once the state behind the route has\nreached it, otherwise `503` after its wait (default 2s, `POD_RPC_TIMESTAMP_WAIT`).\nOmitted means answer now.\n","schema":{"type":"integer","format":"int64"}}},"schemas":{"Bytes32":{"type":"string","pattern":"^0x[a-fA-F0-9]{64}$","description":"32-byte value, `0x` hex. Orderbook ids, order ids and hashes."},"OrderbookSnapshot":{"type":"object","properties":{"orderbook_id":{"$ref":"#/components/schemas/Bytes32"},"buys":{"type":"object","additionalProperties":{"type":"object","properties":{"volume":{"$ref":"#/components/schemas/HexUint256"}}},"description":"Buy levels keyed by price (decimal string), price-ascending; the best bid is the last key."},"sells":{"type":"object","additionalProperties":{"type":"object","properties":{"volume":{"$ref":"#/components/schemas/HexUint256"}}},"description":"Sell levels keyed by price (decimal string), price-ascending; the best ask is the first key."},"buys_count":{"type":"integer","description":"Buy levels in the full book."},"sells_count":{"type":"integer","description":"Sell levels in the full book."},"grouping_precision":{"$ref":"#/components/schemas/HexUint256"},"timestamp":{"$ref":"#/components/schemas/Timestamp"},"new_orders_count":{"type":"integer"},"clearing_price":{"$ref":"#/components/schemas/HexUint256","description":"The orderbook's current mark, carried forward on ticks without fills."},"oracle_price":{"type":"string","nullable":true,"description":"Perp only, `0x` hex. `null` for spot."},"funding_rate":{"type":"string","nullable":true,"description":"Perp only, signed decimal string. `null` for spot."},"funding_index":{"type":"string","nullable":true,"description":"Perp only, signed decimal string. `null` for spot."},"funding_last_updated":{"type":"integer","format":"int64","nullable":true,"description":"Perp only, microseconds. `null` for spot."}}},"HexUint256":{"type":"string","pattern":"^0x[a-fA-F0-9]+$","description":"Unsigned 256-bit integer, `0x` hex"},"Timestamp":{"type":"integer","format":"int64","description":"Unix time in microseconds, as a JSON number"}},"responses":{"BadRequest":{"description":"Malformed path or query parameter. Plain-text reason.","content":{"text/plain":{"schema":{"type":"string"}}}}}}}
```

## Get Solutions

> 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\`.<br>

```json
{"openapi":"3.0.0","info":{"title":"REST API","version":"1.0.0"},"tags":[{"name":"Markets","description":"Market configuration, live statistics, candles, the resting book and per-tick\nsolution history.\n\n&nbsp; &nbsp; &nbsp;\n"}],"servers":[{"url":"https://staging-rpc.podtestnet.dev/v1","description":"Pod testnet"}],"paths":{"/clob/solutions":{"get":{"tags":["Markets"],"summary":"Get Solutions","operationId":"getSolutions","description":"Per-tick solution history: clearing, mark and oracle prices, volume, funding,\nopen interest and the mark/funding inputs. Newest first, in whole ticks: `limit`\ncounts ticks, and a tick carries one row per orderbook.\n\nPage back by passing the oldest `timestamp` of the previous page as `until_us`.\n\nAn orderbook id that names no book returns no rows.\n\n`Cache-Control: no-store`.\n","parameters":[{"$ref":"#/components/parameters/MinTimestamp"},{"$ref":"#/components/parameters/OrderbookQuery"},{"name":"since_us","in":"query","description":"Lower bound on the batch deadline, microseconds, inclusive.","schema":{"$ref":"#/components/schemas/TimestampString"}},{"name":"until_us","in":"query","description":"Upper bound on the batch deadline, microseconds, exclusive.","schema":{"$ref":"#/components/schemas/TimestampString"}},{"name":"limit","in":"query","description":"Ticks per page, clamped to `[1, 200]`.","schema":{"type":"integer","minimum":1,"maximum":200,"default":200}}],"responses":{"200":{"description":"Solution rows","content":{"application/json":{"schema":{"type":"object","required":["solutions","solution_now"],"properties":{"solutions":{"type":"array","items":{"$ref":"#/components/schemas/Solution"}},"solution_now":{"$ref":"#/components/schemas/Timestamp"}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"503":{"$ref":"#/components/responses/Unavailable"}}}}},"components":{"parameters":{"MinTimestamp":{"name":"timestamp","in":"query","description":"The lowest tick deadline accepted, in microseconds — typically the highest `timestamp`\n(or `solution_now`) already held. The node answers once the state behind the route has\nreached it, otherwise `503` after its wait (default 2s, `POD_RPC_TIMESTAMP_WAIT`).\nOmitted means answer now.\n","schema":{"type":"integer","format":"int64"}},"OrderbookQuery":{"name":"orderbook","in":"query","description":"Restrict to one orderbook (32-byte id).","schema":{"$ref":"#/components/schemas/Bytes32"}}},"schemas":{"Bytes32":{"type":"string","pattern":"^0x[a-fA-F0-9]{64}$","description":"32-byte value, `0x` hex. Orderbook ids, order ids and hashes."},"TimestampString":{"type":"string","pattern":"^[0-9]+$","description":"Unix time in microseconds, as a decimal string"},"Solution":{"type":"object","description":"One orderbook's record for one tick. Unsigned values are 1e18-scaled `0x` hex,\nsigned values decimal strings. Perp-only fields are omitted on spot ticks and on\nrows recorded before the field existed.\n","properties":{"orderbook_id":{"$ref":"#/components/schemas/Bytes32"},"timestamp":{"$ref":"#/components/schemas/Timestamp","description":"Batch deadline."},"clearing_price":{"$ref":"#/components/schemas/HexUint256","description":"Omitted for a market that has never traded."},"mark_price":{"$ref":"#/components/schemas/HexUint256","description":"`0x0` for spot."},"volume":{"$ref":"#/components/schemas/HexUint256"},"oracle_price":{"$ref":"#/components/schemas/HexUint256"},"funding_rate":{"$ref":"#/components/schemas/DecimalInt256"},"funding_index":{"$ref":"#/components/schemas/DecimalInt256"},"open_interest":{"$ref":"#/components/schemas/HexUint256"},"mark_best_bid":{"$ref":"#/components/schemas/HexUint256"},"mark_best_ask":{"$ref":"#/components/schemas/HexUint256"},"premium_ema":{"$ref":"#/components/schemas/DecimalInt256"},"book_median_ema":{"$ref":"#/components/schemas/HexUint256"},"impact_bid":{"$ref":"#/components/schemas/HexUint256"},"impact_ask":{"$ref":"#/components/schemas/HexUint256"}}},"Timestamp":{"type":"integer","format":"int64","description":"Unix time in microseconds, as a JSON number"},"HexUint256":{"type":"string","pattern":"^0x[a-fA-F0-9]+$","description":"Unsigned 256-bit integer, `0x` hex"},"DecimalInt256":{"type":"string","pattern":"^-?[0-9]+$","description":"Signed 256-bit integer, decimal string"},"NodeBehindBody":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"$ref":"#/components/schemas/Timestamp","description":"The node's current value for the route."}}}},"responses":{"BadRequest":{"description":"Malformed path or query parameter. Plain-text reason.","content":{"text/plain":{"schema":{"type":"string"}}}},"Unavailable":{"description":"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`).","content":{"text/plain":{"schema":{"type":"string"}},"application/json":{"schema":{"$ref":"#/components/schemas/NodeBehindBody"}}}}}}}
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.v2.pod.network/guides-references/references/rest/markets.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
