> 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/account.md).

# Account

One account's orders, fills, positions, balances, triggers, backstop transfers, unified activity feed and nonce window. `{account}` is a 20-byte `0x` address.

&#x20;   &#x20;

## Get Orders

> The account's orders with their fills, newest first by \`(deadline, nonce,\
> order\_id)\`. \`/clob/fills/{account}\` and the activity \`fill\` entries are the per-fill\
> record that also carries the fee and running totals. Backstop position transfers\
> appear as terminal rows with \`kind: backstop\_transfer\`.\
> \
> Two paging modes:\
> \- Cursor (default): pass \`next\_cursor\` back as \`cursor\`; \`null\` on the last page.\
> &#x20; \`until\` bounds the first page.\
> \- Offset: set \`offset\`. \`cursor\` and \`until\` are then ignored and \`next\_cursor\`\
> &#x20; is \`null\`; page with \`offset += limit\` while \`offset < total\_count\`.\
> \
> \`Cache-Control: public, max-age=31536000, immutable\` when the page's upper bound\
> (\`cursor\` or \`until\`) has been reached by solution time and every returned order\
> is terminal, otherwise \`no-store\`. Offset pages are \`no-store\`.<br>

```json
{"openapi":"3.0.0","info":{"title":"REST API","version":"1.0.0"},"tags":[{"name":"Account","description":"One account's orders, fills, positions, balances, triggers, backstop transfers,\nunified activity feed and nonce window. `{account}` is a 20-byte `0x` address.\n\n&nbsp; &nbsp; &nbsp;\n"}],"servers":[{"url":"https://staging-rpc.podtestnet.dev/v1","description":"Pod testnet"}],"paths":{"/clob/orders/{account}":{"get":{"tags":["Account"],"summary":"Get Orders","operationId":"getOrders","description":"The account's orders with their fills, newest first by `(deadline, nonce,\norder_id)`. `/clob/fills/{account}` and the activity `fill` entries are the per-fill\nrecord that also carries the fee and running totals. Backstop position transfers\nappear as terminal rows with `kind: backstop_transfer`.\n\nTwo paging modes:\n- Cursor (default): pass `next_cursor` back as `cursor`; `null` on the last page.\n  `until` bounds the first page.\n- Offset: set `offset`. `cursor` and `until` are then ignored and `next_cursor`\n  is `null`; page with `offset += limit` while `offset < total_count`.\n\n`Cache-Control: public, max-age=31536000, immutable` when the page's upper bound\n(`cursor` or `until`) has been reached by solution time and every returned order\nis terminal, otherwise `no-store`. Offset pages are `no-store`.\n","parameters":[{"$ref":"#/components/parameters/AccountPath"},{"$ref":"#/components/parameters/MinTimestamp"},{"name":"until","in":"query","description":"Upper bound on order deadline, unix seconds. Ignored when `cursor` or `offset` is set.","schema":{"type":"integer","format":"int64"}},{"name":"limit","in":"query","description":"Page size, capped at 500.","schema":{"type":"integer","minimum":0,"maximum":500,"default":500}},{"name":"cursor","in":"query","description":"`next_cursor` from the previous page, `\"{deadline_us}:{nonce}:{order_id_hex}\"`. Malformed is a `400`.","schema":{"type":"string"}},{"name":"offset","in":"query","description":"Skip this many newest-first rows. Switches to offset mode.","schema":{"type":"integer","minimum":0}},{"name":"orderbook","in":"query","description":"Restrict to one orderbook. An id wider than the node's 32-bit form is a `400`.","schema":{"$ref":"#/components/schemas/Bytes32"}},{"name":"status","in":"query","description":"Restrict to one status. Unknown values are a `400`.","schema":{"$ref":"#/components/schemas/OrderStatus"}}],"responses":{"200":{"description":"Order page","content":{"application/json":{"schema":{"type":"object","required":["orders","next_cursor","total_count","solution_now"],"properties":{"orders":{"type":"array","items":{"$ref":"#/components/schemas/Order"}},"next_cursor":{"type":"string","nullable":true,"description":"Cursor for the next page. `null` on the last page and in offset mode."},"total_count":{"type":"integer","description":"Orders matching the filters, across all pages."},"solution_now":{"$ref":"#/components/schemas/Timestamp"}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"503":{"$ref":"#/components/responses/Unavailable"}}}}},"components":{"parameters":{"AccountPath":{"name":"account","in":"path","required":true,"schema":{"$ref":"#/components/schemas/Address"}},"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":{"Address":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"20-byte address, `0x` hex"},"Bytes32":{"type":"string","pattern":"^0x[a-fA-F0-9]{64}$","description":"32-byte value, `0x` hex. Orderbook ids, order ids and hashes."},"OrderStatus":{"type":"string","enum":["pending","active","filled","expired","canceled","margin_canceled","self_trade_canceled","post_only_refused","invalid"],"description":"- `pending`: submitted, not yet in the book\n- `active`: resting in the book\n- `filled`: completely filled\n- `expired`: TTL passed\n- `canceled`: canceled by the owner\n- `margin_canceled`: removed by the engine because the owner's margin was exhausted\n- `self_trade_canceled`: removed by the engine because it was about to fill against an order of the same owner\n- `post_only_refused`: a `post_only` order refused because its price crossed the book left by the previous batch\n- `invalid`: rejected at execution and never entered the book; see `invalid_reason`\n\nEverything except `pending` and `active` is terminal.\n"},"Order":{"type":"object","description":"An order with its fills. Unsigned amounts and prices are 1e18-scaled `0x` hex,\nsigned ones decimal strings. Perp-only fields are omitted on spot orders.\n","properties":{"orderbook_id":{"$ref":"#/components/schemas/Bytes32"},"market_type":{"$ref":"#/components/schemas/MarketType"},"kind":{"$ref":"#/components/schemas/OrderKind"},"order_id":{"$ref":"#/components/schemas/Bytes32"},"tx_hash":{"$ref":"#/components/schemas/Bytes32","description":"Creating transaction. Zero for engine-generated orders."},"bidder":{"$ref":"#/components/schemas/Address"},"nonce":{"type":"integer","format":"int64"},"order_type":{"type":"string","enum":["limit","market"]},"status":{"$ref":"#/components/schemas/OrderStatus"},"side":{"type":"string","enum":["buy","sell"]},"price":{"$ref":"#/components/schemas/HexUint256"},"initial_size":{"$ref":"#/components/schemas/DecimalInt256","description":"Signed; positive buy/long, negative sell/short."},"filled_base_amount":{"$ref":"#/components/schemas/HexUint256"},"filled_quote_amount":{"$ref":"#/components/schemas/HexUint256"},"fee":{"$ref":"#/components/schemas/HexUint256"},"deadline":{"$ref":"#/components/schemas/TimestampString","description":"The batch the order targets, microseconds, as a string."},"end":{"$ref":"#/components/schemas/Timestamp","description":"TTL expiry, microseconds. Orders that never expire carry `18446744073709551615`, which exceeds a JavaScript safe integer."},"included_batch":{"$ref":"#/components/schemas/Timestamp","description":"Deadline of the batch that first included the order. `0` for engine-generated orders and older rows."},"invalid_reason":{"type":"string","description":"Why the engine rejected the order. Only when `status` is `invalid`."},"effective_price":{"$ref":"#/components/schemas/HexUint256","description":"`filled_quote / filled_base` so far."},"fills":{"type":"array","items":{"$ref":"#/components/schemas/PartialFill"},"description":"Always present, oldest first."},"reduce_only":{"type":"boolean","description":"Perp only."},"ioc":{"type":"boolean","description":"Perp only."},"post_only":{"type":"boolean","description":"Omitted when false."},"direction":{"$ref":"#/components/schemas/OrderDirection"},"realized_pnl":{"$ref":"#/components/schemas/DecimalInt256","description":"Perp only, present once a fill closed exposure. Price drift minus funding across the slices it closed."},"grouping":{"$ref":"#/components/schemas/TriggerGrouping","description":"Inherited from the parent trigger. Omitted when `none`."},"trigger_type":{"$ref":"#/components/schemas/TriggerType","description":"Set only on orders a fired trigger produced (`kind` `triggered`)."}}},"MarketType":{"type":"string","enum":["spot","perpetual"]},"OrderKind":{"type":"string","enum":["user_signed","liquidation","triggered","adl","adl_counterparty","backstop_transfer"],"description":"- `user_signed`: submitted by the account\n- `liquidation`: generated by the engine when the account fell below maintenance margin\n- `triggered`: the order a fired TP/SL trigger produced\n- `adl`: auto-deleveraging close of this account's position\n- `adl_counterparty`: this account's side covering an auto-deleveraging close\n- `backstop_transfer`: a backstop sweep of this account's position, shown as a terminal order\n"},"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"},"TimestampString":{"type":"string","pattern":"^[0-9]+$","description":"Unix time in microseconds, as a decimal string"},"Timestamp":{"type":"integer","format":"int64","description":"Unix time in microseconds, as a JSON number"},"PartialFill":{"type":"object","properties":{"base_amount":{"$ref":"#/components/schemas/HexUint256"},"quote_amount":{"$ref":"#/components/schemas/HexUint256"},"timestamp":{"$ref":"#/components/schemas/Timestamp"},"price":{"$ref":"#/components/schemas/HexUint256","description":"The batch's clearing price; the order's own price for ADL fills."}}},"OrderDirection":{"type":"string","enum":["buy","sell","open_long","add_long","reduce_long","close_long","open_short","add_short","reduce_short","close_short","long_to_short","short_to_long","liquidation"],"description":"Spot orders use `buy`/`sell`. Perp orders use the position effect of their fills; `liquidation` when `kind` is `liquidation`."},"TriggerGrouping":{"type":"string","enum":["none","asset"],"description":"- `none`: standalone; removed only by cancel, TTL expiry or its own fire\n- `asset`: removed, with any resting order it produced, once the owner's position on the pair (perp) or base holding (spot) reaches zero\n"},"TriggerType":{"type":"string","enum":["take_profit","stop_loss"]},"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 Fills

> The account's fills in the window \`\[from\_us, to\_us)\`, newest first. Capped at 500\
> rows; narrow the window to read further back.\
> \
> 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":"Account","description":"One account's orders, fills, positions, balances, triggers, backstop transfers,\nunified activity feed and nonce window. `{account}` is a 20-byte `0x` address.\n\n&nbsp; &nbsp; &nbsp;\n"}],"servers":[{"url":"https://staging-rpc.podtestnet.dev/v1","description":"Pod testnet"}],"paths":{"/clob/fills/{account}":{"get":{"tags":["Account"],"summary":"Get Fills","operationId":"getFills","description":"The account's fills in the window `[from_us, to_us)`, newest first. Capped at 500\nrows; narrow the window to read further back.\n\nAn orderbook id that names no book returns no rows.\n\n`Cache-Control: no-store`.\n","parameters":[{"$ref":"#/components/parameters/AccountPath"},{"$ref":"#/components/parameters/MinTimestamp"},{"$ref":"#/components/parameters/OrderbookQuery"},{"name":"from_us","in":"query","description":"Window start, microseconds, inclusive.","schema":{"$ref":"#/components/schemas/TimestampString"}},{"name":"to_us","in":"query","description":"Window end, microseconds, exclusive. Defaults to the node's current time.","schema":{"$ref":"#/components/schemas/TimestampString"}},{"name":"limit","in":"query","description":"Maximum rows, clamped to `[1, 500]`.","schema":{"type":"integer","minimum":1,"maximum":500,"default":500}}],"responses":{"200":{"description":"Fills","content":{"application/json":{"schema":{"type":"object","required":["fills","solution_now"],"properties":{"fills":{"type":"array","items":{"$ref":"#/components/schemas/Fill"}},"solution_now":{"$ref":"#/components/schemas/Timestamp"}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"503":{"$ref":"#/components/responses/Unavailable"}}}}},"components":{"parameters":{"AccountPath":{"name":"account","in":"path","required":true,"schema":{"$ref":"#/components/schemas/Address"}},"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":{"Address":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"20-byte address, `0x` hex"},"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"},"Fill":{"type":"object","properties":{"orderbook_id":{"$ref":"#/components/schemas/Bytes32"},"base_token":{"$ref":"#/components/schemas/Address"},"quote_token":{"$ref":"#/components/schemas/Address"},"order_id":{"$ref":"#/components/schemas/Bytes32"},"order_type":{"type":"string","enum":["limit","market"]},"initial_size":{"$ref":"#/components/schemas/DecimalInt256"},"fee":{"$ref":"#/components/schemas/HexUint256"},"base_amount":{"$ref":"#/components/schemas/HexUint256"},"quote_amount":{"$ref":"#/components/schemas/HexUint256"},"timestamp":{"$ref":"#/components/schemas/Timestamp"},"price":{"$ref":"#/components/schemas/HexUint256"}}},"DecimalInt256":{"type":"string","pattern":"^-?[0-9]+$","description":"Signed 256-bit integer, decimal string"},"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"},"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 Perp Positions

> The account's live perp positions and account-level aggregates, read from the\
> execution engine. Spot holdings are on \`/clob/balances/{account}\`. An account the\
> node has never seen returns an empty list and zero aggregates.\
> \
> \`Cache-Control: no-store\`.<br>

```json
{"openapi":"3.0.0","info":{"title":"REST API","version":"1.0.0"},"tags":[{"name":"Account","description":"One account's orders, fills, positions, balances, triggers, backstop transfers,\nunified activity feed and nonce window. `{account}` is a 20-byte `0x` address.\n\n&nbsp; &nbsp; &nbsp;\n"}],"servers":[{"url":"https://staging-rpc.podtestnet.dev/v1","description":"Pod testnet"}],"paths":{"/clob/positions/{account}":{"get":{"tags":["Account"],"summary":"Get Perp Positions","operationId":"getPositions","description":"The account's live perp positions and account-level aggregates, read from the\nexecution engine. Spot holdings are on `/clob/balances/{account}`. An account the\nnode has never seen returns an empty list and zero aggregates.\n\n`Cache-Control: no-store`.\n","parameters":[{"$ref":"#/components/parameters/AccountPath"},{"$ref":"#/components/parameters/MinTimestamp"}],"responses":{"200":{"description":"Positions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PositionsResponse"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"503":{"$ref":"#/components/responses/Unavailable"}}}}},"components":{"parameters":{"AccountPath":{"name":"account","in":"path","required":true,"schema":{"$ref":"#/components/schemas/Address"}},"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":{"Address":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"20-byte address, `0x` hex"},"PositionsResponse":{"type":"object","properties":{"positions":{"type":"array","items":{"$ref":"#/components/schemas/PerpPosition"}},"total_unrealized_pnl":{"$ref":"#/components/schemas/DecimalInt256"},"total_realized_pnl":{"$ref":"#/components/schemas/DecimalInt256","description":"Lifetime, spot and perp."},"perps_equity":{"$ref":"#/components/schemas/DecimalInt256","description":"Cash adjusted for unsettled funding, plus perp unrealized PnL."},"account_value":{"$ref":"#/components/schemas/DecimalInt256","description":"`perps_equity` plus the mark value of spot holdings and quote escrowed in resting spot buys."},"cash":{"$ref":"#/components/schemas/DecimalInt256"},"withdrawable_cash":{"$ref":"#/components/schemas/HexUint256","description":"What a withdrawal or transfer can take now: `max(0, equity − max(initial_margin, transfer_margin_ratio × notional))`, where `notional` is `Σ |size| × mark` and `transfer_margin_ratio` is a network parameter (10% by default). Equity counts unrealized PnL."},"net_deposits":{"$ref":"#/components/schemas/DecimalInt256","description":"Native collateral deposited minus withdrawn. Lifetime PnL is `account_value − net_deposits`."},"timestamp":{"$ref":"#/components/schemas/Timestamp","description":"Deadline of the last executed tick on the answering node, read together with the state above; 0 before the first tick. Comparable across nodes."}}},"PerpPosition":{"type":"object","description":"One open perp position. 1e18-scaled; unsigned `0x` hex, signed decimal strings.","properties":{"kind":{"type":"string","enum":["perp"]},"orderbook_id":{"$ref":"#/components/schemas/Bytes32"},"base_symbol":{"type":"string"},"quote_symbol":{"type":"string"},"side":{"type":"string","enum":["long","short"]},"size":{"$ref":"#/components/schemas/DecimalInt256","description":"Positive long, negative short."},"notional":{"$ref":"#/components/schemas/HexUint256"},"entry_price":{"$ref":"#/components/schemas/HexUint256","description":"Rounded against the holder; `unrealized_pnl` is exact."},"mark_price":{"$ref":"#/components/schemas/HexUint256"},"margin":{"$ref":"#/components/schemas/HexUint256"},"leverage":{"$ref":"#/components/schemas/HexUint256"},"funding_accrued":{"$ref":"#/components/schemas/DecimalInt256","description":"Funding owed on the position, quote wei. Positive is owed by the holder."},"funding_basis":{"$ref":"#/components/schemas/DecimalInt256"},"cost_basis":{"$ref":"#/components/schemas/DecimalInt256"},"entry_funding":{"$ref":"#/components/schemas/DecimalInt256"},"liquidation_price":{"$ref":"#/components/schemas/HexUint256"},"unrealized_pnl":{"$ref":"#/components/schemas/DecimalInt256"},"realized_pnl":{"$ref":"#/components/schemas/DecimalInt256","description":"Always `\"0\"`; realized PnL is banked into cash and `total_realized_pnl`."},"stop_loss":{"type":"string","nullable":true,"description":"Always `null`."},"take_profit":{"type":"string","nullable":true,"description":"Always `null`."}}},"Bytes32":{"type":"string","pattern":"^0x[a-fA-F0-9]{64}$","description":"32-byte value, `0x` hex. Orderbook ids, order ids and hashes."},"DecimalInt256":{"type":"string","pattern":"^-?[0-9]+$","description":"Signed 256-bit integer, decimal string"},"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"},"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 Balances

> The account's live spot holdings and cash, read from the execution engine.\
> \
> \`Cache-Control: no-store\`.<br>

```json
{"openapi":"3.0.0","info":{"title":"REST API","version":"1.0.0"},"tags":[{"name":"Account","description":"One account's orders, fills, positions, balances, triggers, backstop transfers,\nunified activity feed and nonce window. `{account}` is a 20-byte `0x` address.\n\n&nbsp; &nbsp; &nbsp;\n"}],"servers":[{"url":"https://staging-rpc.podtestnet.dev/v1","description":"Pod testnet"}],"paths":{"/clob/balances/{account}":{"get":{"tags":["Account"],"summary":"Get Balances","operationId":"getBalances","description":"The account's live spot holdings and cash, read from the execution engine.\n\n`Cache-Control: no-store`.\n","parameters":[{"$ref":"#/components/parameters/AccountPath"},{"$ref":"#/components/parameters/MinTimestamp"}],"responses":{"200":{"description":"Balances","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BalancesResponse"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"503":{"$ref":"#/components/responses/Unavailable"}}}}},"components":{"parameters":{"AccountPath":{"name":"account","in":"path","required":true,"schema":{"$ref":"#/components/schemas/Address"}},"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":{"Address":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"20-byte address, `0x` hex"},"BalancesResponse":{"type":"object","properties":{"balances":{"type":"array","items":{"$ref":"#/components/schemas/SpotHolding"}},"cash":{"$ref":"#/components/schemas/DecimalInt256"},"withdrawable_cash":{"$ref":"#/components/schemas/HexUint256"},"net_deposits":{"$ref":"#/components/schemas/DecimalInt256"},"timestamp":{"$ref":"#/components/schemas/Timestamp","description":"Deadline of the last executed tick on the answering node, read together with the state above; 0 before the first tick. Comparable across nodes."}}},"SpotHolding":{"type":"object","description":"One spot token holding. 1e18-scaled; unsigned `0x` hex, signed decimal strings.","properties":{"orderbook_id":{"$ref":"#/components/schemas/Bytes32"},"base_symbol":{"type":"string"},"quote_symbol":{"type":"string"},"balance":{"$ref":"#/components/schemas/HexUint256","description":"`free_balance + locked_balance`."},"free_balance":{"$ref":"#/components/schemas/HexUint256"},"locked_balance":{"$ref":"#/components/schemas/HexUint256","description":"Locked in open sell orders."},"cost_basis":{"$ref":"#/components/schemas/HexUint256"},"mark_price":{"$ref":"#/components/schemas/HexUint256"},"unrealized_pnl":{"$ref":"#/components/schemas/DecimalInt256"},"realized_pnl":{"$ref":"#/components/schemas/DecimalInt256","description":"Portfolio-wide lifetime spot realized PnL."}}},"Bytes32":{"type":"string","pattern":"^0x[a-fA-F0-9]{64}$","description":"32-byte value, `0x` hex. Orderbook ids, order ids and hashes."},"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"},"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":{"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 Triggers

> The account's armed TP/SL triggers, read from the execution engine, sorted by\
> \`(orderbook\_id, order\_id)\`. Pass \`next\_cursor\` back as \`cursor\` for the next page.\
> \
> \`Cache-Control: no-store\`.<br>

```json
{"openapi":"3.0.0","info":{"title":"REST API","version":"1.0.0"},"tags":[{"name":"Account","description":"One account's orders, fills, positions, balances, triggers, backstop transfers,\nunified activity feed and nonce window. `{account}` is a 20-byte `0x` address.\n\n&nbsp; &nbsp; &nbsp;\n"}],"servers":[{"url":"https://staging-rpc.podtestnet.dev/v1","description":"Pod testnet"}],"paths":{"/clob/triggers/{account}":{"get":{"tags":["Account"],"summary":"Get Triggers","operationId":"getTriggers","description":"The account's armed TP/SL triggers, read from the execution engine, sorted by\n`(orderbook_id, order_id)`. Pass `next_cursor` back as `cursor` for the next page.\n\n`Cache-Control: no-store`.\n","parameters":[{"$ref":"#/components/parameters/AccountPath"},{"$ref":"#/components/parameters/MinTimestamp"},{"$ref":"#/components/parameters/OrderbookQuery"},{"name":"limit","in":"query","description":"Page size, clamped to `[1, 200]`.","schema":{"type":"integer","minimum":1,"maximum":200,"default":200}},{"name":"cursor","in":"query","description":"`next_cursor` from the previous page, `\"{orderbook_id}:{order_id}\"` (both `0x` hex). Malformed is a `400`.","schema":{"type":"string"}}],"responses":{"200":{"description":"Trigger page","content":{"application/json":{"schema":{"type":"object","required":["triggers","total_count","next_cursor"],"properties":{"triggers":{"type":"array","items":{"$ref":"#/components/schemas/Trigger"}},"total_count":{"type":"integer","description":"Triggers matching the filter, before paging."},"next_cursor":{"type":"string","nullable":true,"description":"Cursor for the next page. `null` on the last page.","timestamp":{"$ref":"#/components/schemas/Timestamp","description":"Deadline of the last executed tick on the answering node, read together with the state above; 0 before the first tick. Comparable across nodes."}}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"503":{"$ref":"#/components/responses/Unavailable"}}}}},"components":{"parameters":{"AccountPath":{"name":"account","in":"path","required":true,"schema":{"$ref":"#/components/schemas/Address"}},"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":{"Address":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"20-byte address, `0x` hex"},"Bytes32":{"type":"string","pattern":"^0x[a-fA-F0-9]{64}$","description":"32-byte value, `0x` hex. Orderbook ids, order ids and hashes."},"Trigger":{"type":"object","description":"An armed TP/SL trigger.","properties":{"orderbook_id":{"$ref":"#/components/schemas/Bytes32"},"order_id":{"$ref":"#/components/schemas/Bytes32"},"tx_hash":{"$ref":"#/components/schemas/Bytes32"},"bidder":{"$ref":"#/components/schemas/Address"},"nonce":{"type":"integer","format":"int64"},"size":{"$ref":"#/components/schemas/DecimalInt256","description":"Signed. `\"0\"` (only with `grouping` `asset`) sizes from the owner's exposure when the trigger fires."},"limit_price":{"$ref":"#/components/schemas/HexUint256"},"trigger_price":{"$ref":"#/components/schemas/HexUint256"},"trigger_type":{"$ref":"#/components/schemas/TriggerType"},"grouping":{"$ref":"#/components/schemas/TriggerGrouping"},"reduce_only":{"type":"boolean"},"ioc":{"type":"boolean"},"deadline":{"$ref":"#/components/schemas/TimestampString"},"end":{"type":"integer","description":"TTL expiry, microseconds, as a JSON number."}}},"DecimalInt256":{"type":"string","pattern":"^-?[0-9]+$","description":"Signed 256-bit integer, decimal string"},"HexUint256":{"type":"string","pattern":"^0x[a-fA-F0-9]+$","description":"Unsigned 256-bit integer, `0x` hex"},"TriggerType":{"type":"string","enum":["take_profit","stop_loss"]},"TriggerGrouping":{"type":"string","enum":["none","asset"],"description":"- `none`: standalone; removed only by cancel, TTL expiry or its own fire\n- `asset`: removed, with any resting order it produced, once the owner's position on the pair (perp) or base holding (spot) reaches zero\n"},"TimestampString":{"type":"string","pattern":"^[0-9]+$","description":"Unix time in microseconds, as a decimal string"},"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":{"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 Backstop Transfers

> The account's backstop sweeps as raw events, newest first, with the cash and\
> equity detail the orders feed omits.\
> \
> With no query parameters the route returns the whole list, capped at 500, and no\
> \`next\_cursor\`. Setting any of \`orderbook\`, \`limit\` or \`cursor\` switches to paged\
> reads of at most 200 rows; pass \`next\_cursor\` back as \`cursor\`.\
> \
> 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":"Account","description":"One account's orders, fills, positions, balances, triggers, backstop transfers,\nunified activity feed and nonce window. `{account}` is a 20-byte `0x` address.\n\n&nbsp; &nbsp; &nbsp;\n"}],"servers":[{"url":"https://staging-rpc.podtestnet.dev/v1","description":"Pod testnet"}],"paths":{"/clob/backstop-transfers/{account}":{"get":{"tags":["Account"],"summary":"Get Backstop Transfers","operationId":"getBackstopTransfers","description":"The account's backstop sweeps as raw events, newest first, with the cash and\nequity detail the orders feed omits.\n\nWith no query parameters the route returns the whole list, capped at 500, and no\n`next_cursor`. Setting any of `orderbook`, `limit` or `cursor` switches to paged\nreads of at most 200 rows; pass `next_cursor` back as `cursor`.\n\nAn orderbook id that names no book returns no rows.\n\n`Cache-Control: no-store`.\n","parameters":[{"$ref":"#/components/parameters/AccountPath"},{"$ref":"#/components/parameters/MinTimestamp"},{"$ref":"#/components/parameters/OrderbookQuery"},{"name":"limit","in":"query","description":"Page size, clamped to `[1, 200]`.","schema":{"type":"integer","minimum":1,"maximum":200,"default":200}},{"name":"cursor","in":"query","description":"`next_cursor` from the previous page, `\"{ts}:{id}\"`. Malformed is a `400`.","schema":{"type":"string"}}],"responses":{"200":{"description":"Backstop transfers","content":{"application/json":{"schema":{"type":"object","required":["backstop_transfers","total_count","solution_now"],"properties":{"backstop_transfers":{"type":"array","items":{"$ref":"#/components/schemas/BackstopTransfer"}},"total_count":{"type":"integer"},"next_cursor":{"type":"string","description":"Cursor for the next page. Omitted on the last page and when unpaged."},"solution_now":{"$ref":"#/components/schemas/Timestamp"}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"503":{"$ref":"#/components/responses/Unavailable"}}}}},"components":{"parameters":{"AccountPath":{"name":"account","in":"path","required":true,"schema":{"$ref":"#/components/schemas/Address"}},"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":{"Address":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"20-byte address, `0x` hex"},"Bytes32":{"type":"string","pattern":"^0x[a-fA-F0-9]{64}$","description":"32-byte value, `0x` hex. Orderbook ids, order ids and hashes."},"BackstopTransfer":{"type":"object","description":"One backstop sweep. Amounts are 1e18-scaled decimal strings.","properties":{"orderbook_id":{"$ref":"#/components/schemas/Bytes32","description":"The swept position's market. Omitted on the cash-sweep row."},"size":{"type":"string","description":"Signed position size moved."},"cash":{"type":"string","description":"Signed."},"mark_price":{"type":"string"},"equity":{"type":"string","description":"Signed account equity when the sweep triggered."},"realized_pnl":{"type":"string","description":"Signed. `\"0\"` on the cash-sweep row and older rows."},"timestamp_us":{"$ref":"#/components/schemas/Timestamp"}}},"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":{"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 Account Activity

> Everything that happened to the account, as an \`ActivityFrame\`: a map from batch\
> deadline to that batch's entries. Entries are tagged by \`k\` (\`ActivityEntry\`). Within a batch, entries are ordered by kind\
> (\`order\`, \`fill\`, \`modify\`, \`termination\`, \`backstop\`, \`bridge\_transfer\`,\
> \`transfer\`, \`modify\_reject\`, \`cancel\_reject\`), then by book ascending, then in engine order.\
> \
> Pages are newest first and hold whole batches. Batches are added while the entry\
> count stays within \`limit\`; the newest batch in the window is always served, even\
> when it alone exceeds \`limit\`. Pass \`next\` back as \`to\` for the older page.\
> \
> An \`order\` entry, at the batch that admitted it, is the order as\
> \`/clob/orders/{account}\` serves it: its current status, totals and fills, so it needs no\
> folding of the later entries. A \`fill\`, \`modify\`, \`termination\`, \`modify\_reject\` or \`cancel\_reject\` names\
> its order by \`id\` and \`book\`; one of an order placed before the window is not\
> hydrated.\
> \
> Seed from this route, then subscribe to the \`pod\_activity\` websocket channel with\
> \`since\` = \`solution\_now\`.\
> \
> \`Cache-Control: public, max-age=31536000, immutable\` when \`to <= solution\_now\` and\
> every \`order\` on the page is terminal, otherwise \`no-store\`.<br>

```json
{"openapi":"3.0.0","info":{"title":"REST API","version":"1.0.0"},"tags":[{"name":"Account","description":"One account's orders, fills, positions, balances, triggers, backstop transfers,\nunified activity feed and nonce window. `{account}` is a 20-byte `0x` address.\n\n&nbsp; &nbsp; &nbsp;\n"}],"servers":[{"url":"https://staging-rpc.podtestnet.dev/v1","description":"Pod testnet"}],"paths":{"/clob/activity/{account}":{"get":{"tags":["Account"],"summary":"Get Account Activity","operationId":"getActivity","description":"Everything that happened to the account, as an `ActivityFrame`: a map from batch\ndeadline to that batch's entries. Entries are tagged by `k` (`ActivityEntry`). Within a batch, entries are ordered by kind\n(`order`, `fill`, `modify`, `termination`, `backstop`, `bridge_transfer`,\n`transfer`, `modify_reject`, `cancel_reject`), then by book ascending, then in engine order.\n\nPages are newest first and hold whole batches. Batches are added while the entry\ncount stays within `limit`; the newest batch in the window is always served, even\nwhen it alone exceeds `limit`. Pass `next` back as `to` for the older page.\n\nAn `order` entry, at the batch that admitted it, is the order as\n`/clob/orders/{account}` serves it: its current status, totals and fills, so it needs no\nfolding of the later entries. A `fill`, `modify`, `termination`, `modify_reject` or `cancel_reject` names\nits order by `id` and `book`; one of an order placed before the window is not\nhydrated.\n\nSeed from this route, then subscribe to the `pod_activity` websocket channel with\n`since` = `solution_now`.\n\n`Cache-Control: public, max-age=31536000, immutable` when `to <= solution_now` and\nevery `order` on the page is terminal, otherwise `no-store`.\n","parameters":[{"$ref":"#/components/parameters/AccountPath"},{"name":"from","in":"query","description":"Lowest batch deadline, microseconds, inclusive. Defaults to `0`.","schema":{"$ref":"#/components/schemas/TimestampString"}},{"name":"to","in":"query","description":"Highest batch deadline, microseconds, inclusive. Defaults to the whole history. `from > to` is a `422` (`from must not exceed to`).","schema":{"$ref":"#/components/schemas/TimestampString"}},{"$ref":"#/components/parameters/MinTimestamp"},{"name":"limit","in":"query","description":"Entries per page after the type filter, clamped to `[1, 2000]`. A page can exceed it by its newest batch.","schema":{"type":"integer","minimum":1,"maximum":2000,"default":500}},{"name":"activity_types","in":"query","description":"Comma-separated kinds to include: `order`, `fill`, `modify`, `termination`,\n`backstop`, `bridge_transfer`, `transfer`, `modify_reject`, `cancel_reject`. Defaults to all. An unknown or empty\nname is a `400` (`invalid activity_types`).\n","schema":{"type":"string"}}],"responses":{"200":{"description":"Activity page","content":{"application/json":{"schema":{"type":"object","required":["activity","next","solution_now"],"properties":{"activity":{"$ref":"#/components/schemas/ActivityFrame"},"next":{"type":"string","pattern":"^[0-9]+$","nullable":true,"description":"The oldest served batch minus 1µs when older history may exist, otherwise `null`. Pass it as `to`."},"solution_now":{"$ref":"#/components/schemas/Timestamp"}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"422":{"description":"`from > to`. Plain-text reason.","content":{"text/plain":{"schema":{"type":"string"}}}},"503":{"$ref":"#/components/responses/Unavailable"}}}}},"components":{"parameters":{"AccountPath":{"name":"account","in":"path","required":true,"schema":{"$ref":"#/components/schemas/Address"}},"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":{"Address":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"20-byte address, `0x` hex"},"TimestampString":{"type":"string","pattern":"^[0-9]+$","description":"Unix time in microseconds, as a decimal string"},"ActivityFrame":{"type":"object","description":"One account's activity: batch deadline (microseconds, as a decimal-string key) to that\nbatch's entries, in the order given on the route. The `pod_activity` websocket channel\nsends the same shape with one key per tick.\n","additionalProperties":{"type":"array","items":{"$ref":"#/components/schemas/ActivityEntry"}}},"ActivityEntry":{"description":"One activity entry, discriminated by `k`. Amounts and prices are 1e18-scaled decimal\nstrings. Optional fields are omitted rather than `null`; boolean flags are omitted when\nfalse. Ignore kinds and fields you do not recognise.\n","oneOf":[{"$ref":"#/components/schemas/ActivityOrder"},{"$ref":"#/components/schemas/ActivityFill"},{"$ref":"#/components/schemas/ActivityModify"},{"$ref":"#/components/schemas/ActivityTermination"},{"$ref":"#/components/schemas/ActivityBackstop"},{"$ref":"#/components/schemas/ActivityBridgeTransfer"},{"$ref":"#/components/schemas/ActivityTransfer"},{"$ref":"#/components/schemas/ActivityModifyReject"},{"$ref":"#/components/schemas/ActivityCancelReject"}],"discriminator":{"propertyName":"k","mapping":{"order":"#/components/schemas/ActivityOrder","fill":"#/components/schemas/ActivityFill","modify":"#/components/schemas/ActivityModify","termination":"#/components/schemas/ActivityTermination","backstop":"#/components/schemas/ActivityBackstop","bridge_transfer":"#/components/schemas/ActivityBridgeTransfer","transfer":"#/components/schemas/ActivityTransfer","modify_reject":"#/components/schemas/ActivityModifyReject","cancel_reject":"#/components/schemas/ActivityCancelReject"}}},"ActivityOrder":{"description":"The order as `/clob/orders/{account}` serves it, at the batch that admitted it, in its\ncurrent state. On the `pod_activity` channel it is the admission state instead:\n`active`, or `invalid` with `invalid_reason`, zero totals and `fills: []`. ADL closes\nappear as orders with `kind` `adl` or `adl_counterparty`; backstop sweeps appear only\nas `backstop` entries.\n","allOf":[{"type":"object","required":["k"],"properties":{"k":{"type":"string","enum":["order"]}}},{"$ref":"#/components/schemas/Order"}]},"Order":{"type":"object","description":"An order with its fills. Unsigned amounts and prices are 1e18-scaled `0x` hex,\nsigned ones decimal strings. Perp-only fields are omitted on spot orders.\n","properties":{"orderbook_id":{"$ref":"#/components/schemas/Bytes32"},"market_type":{"$ref":"#/components/schemas/MarketType"},"kind":{"$ref":"#/components/schemas/OrderKind"},"order_id":{"$ref":"#/components/schemas/Bytes32"},"tx_hash":{"$ref":"#/components/schemas/Bytes32","description":"Creating transaction. Zero for engine-generated orders."},"bidder":{"$ref":"#/components/schemas/Address"},"nonce":{"type":"integer","format":"int64"},"order_type":{"type":"string","enum":["limit","market"]},"status":{"$ref":"#/components/schemas/OrderStatus"},"side":{"type":"string","enum":["buy","sell"]},"price":{"$ref":"#/components/schemas/HexUint256"},"initial_size":{"$ref":"#/components/schemas/DecimalInt256","description":"Signed; positive buy/long, negative sell/short."},"filled_base_amount":{"$ref":"#/components/schemas/HexUint256"},"filled_quote_amount":{"$ref":"#/components/schemas/HexUint256"},"fee":{"$ref":"#/components/schemas/HexUint256"},"deadline":{"$ref":"#/components/schemas/TimestampString","description":"The batch the order targets, microseconds, as a string."},"end":{"$ref":"#/components/schemas/Timestamp","description":"TTL expiry, microseconds. Orders that never expire carry `18446744073709551615`, which exceeds a JavaScript safe integer."},"included_batch":{"$ref":"#/components/schemas/Timestamp","description":"Deadline of the batch that first included the order. `0` for engine-generated orders and older rows."},"invalid_reason":{"type":"string","description":"Why the engine rejected the order. Only when `status` is `invalid`."},"effective_price":{"$ref":"#/components/schemas/HexUint256","description":"`filled_quote / filled_base` so far."},"fills":{"type":"array","items":{"$ref":"#/components/schemas/PartialFill"},"description":"Always present, oldest first."},"reduce_only":{"type":"boolean","description":"Perp only."},"ioc":{"type":"boolean","description":"Perp only."},"post_only":{"type":"boolean","description":"Omitted when false."},"direction":{"$ref":"#/components/schemas/OrderDirection"},"realized_pnl":{"$ref":"#/components/schemas/DecimalInt256","description":"Perp only, present once a fill closed exposure. Price drift minus funding across the slices it closed."},"grouping":{"$ref":"#/components/schemas/TriggerGrouping","description":"Inherited from the parent trigger. Omitted when `none`."},"trigger_type":{"$ref":"#/components/schemas/TriggerType","description":"Set only on orders a fired trigger produced (`kind` `triggered`)."}}},"Bytes32":{"type":"string","pattern":"^0x[a-fA-F0-9]{64}$","description":"32-byte value, `0x` hex. Orderbook ids, order ids and hashes."},"MarketType":{"type":"string","enum":["spot","perpetual"]},"OrderKind":{"type":"string","enum":["user_signed","liquidation","triggered","adl","adl_counterparty","backstop_transfer"],"description":"- `user_signed`: submitted by the account\n- `liquidation`: generated by the engine when the account fell below maintenance margin\n- `triggered`: the order a fired TP/SL trigger produced\n- `adl`: auto-deleveraging close of this account's position\n- `adl_counterparty`: this account's side covering an auto-deleveraging close\n- `backstop_transfer`: a backstop sweep of this account's position, shown as a terminal order\n"},"OrderStatus":{"type":"string","enum":["pending","active","filled","expired","canceled","margin_canceled","self_trade_canceled","post_only_refused","invalid"],"description":"- `pending`: submitted, not yet in the book\n- `active`: resting in the book\n- `filled`: completely filled\n- `expired`: TTL passed\n- `canceled`: canceled by the owner\n- `margin_canceled`: removed by the engine because the owner's margin was exhausted\n- `self_trade_canceled`: removed by the engine because it was about to fill against an order of the same owner\n- `post_only_refused`: a `post_only` order refused because its price crossed the book left by the previous batch\n- `invalid`: rejected at execution and never entered the book; see `invalid_reason`\n\nEverything except `pending` and `active` is terminal.\n"},"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"},"Timestamp":{"type":"integer","format":"int64","description":"Unix time in microseconds, as a JSON number"},"PartialFill":{"type":"object","properties":{"base_amount":{"$ref":"#/components/schemas/HexUint256"},"quote_amount":{"$ref":"#/components/schemas/HexUint256"},"timestamp":{"$ref":"#/components/schemas/Timestamp"},"price":{"$ref":"#/components/schemas/HexUint256","description":"The batch's clearing price; the order's own price for ADL fills."}}},"OrderDirection":{"type":"string","enum":["buy","sell","open_long","add_long","reduce_long","close_long","open_short","add_short","reduce_short","close_short","long_to_short","short_to_long","liquidation"],"description":"Spot orders use `buy`/`sell`. Perp orders use the position effect of their fills; `liquidation` when `kind` is `liquidation`."},"TriggerGrouping":{"type":"string","enum":["none","asset"],"description":"- `none`: standalone; removed only by cancel, TTL expiry or its own fire\n- `asset`: removed, with any resting order it produced, once the owner's position on the pair (perp) or base holding (spot) reaches zero\n"},"TriggerType":{"type":"string","enum":["take_profit","stop_loss"]},"ActivityFill":{"type":"object","description":"One fill of an order. `tb`, `tq`, `tf`, `f` and `st` are omitted on rows indexed before they\nwere recorded.\n","required":["k","id","book","b","q"],"properties":{"k":{"type":"string","enum":["fill"]},"id":{"$ref":"#/components/schemas/Bytes32","description":"Order id."},"book":{"$ref":"#/components/schemas/Bytes32"},"b":{"$ref":"#/components/schemas/DecimalUint256","description":"Base filled by this fill."},"q":{"$ref":"#/components/schemas/DecimalUint256","description":"Quote filled by this fill."},"tb":{"$ref":"#/components/schemas/DecimalUint256","description":"Order's total base filled after this fill."},"tq":{"$ref":"#/components/schemas/DecimalUint256","description":"Order's total quote filled after this fill."},"tf":{"$ref":"#/components/schemas/DecimalUint256","description":"Order's total fee after this fill."},"f":{"$ref":"#/components/schemas/DecimalUint256","description":"Fee charged by this fill."},"st":{"type":"string","enum":["filled","canceled","margin_canceled","self_trade_canceled","expired","post_only_refused"],"description":"Terminal status, present only on the fill that closed the order."},"pa":{"$ref":"#/components/schemas/DecimalInt256","description":"The position after this fill on a perp book. Omitted when no position moved."},"pnl":{"$ref":"#/components/schemas/DecimalInt256","description":"PnL realized by this fill alone. Omitted when it closed no exposure; an order's realized_pnl is the sum of its fills' pnl."}}},"DecimalUint256":{"type":"string","pattern":"^[0-9]+$","description":"Unsigned 256-bit integer, decimal string"},"ActivityModify":{"type":"object","description":"A resting order's price and/or size changed in place. Sizes are unsigned.","required":["k","id","book","px","sz","old_px","old_sz"],"properties":{"k":{"type":"string","enum":["modify"]},"id":{"$ref":"#/components/schemas/Bytes32","description":"Order id."},"book":{"$ref":"#/components/schemas/Bytes32"},"px":{"$ref":"#/components/schemas/DecimalUint256"},"sz":{"$ref":"#/components/schemas/DecimalUint256"},"old_px":{"$ref":"#/components/schemas/DecimalUint256"},"old_sz":{"$ref":"#/components/schemas/DecimalUint256"}}},"ActivityTermination":{"type":"object","description":"An order left the book other than by filling.","required":["k","id","book","st"],"properties":{"k":{"type":"string","enum":["termination"]},"id":{"$ref":"#/components/schemas/Bytes32","description":"Order id."},"book":{"$ref":"#/components/schemas/Bytes32"},"st":{"type":"string","enum":["canceled","margin_canceled","self_trade_canceled","expired","post_only_refused"]},"expr":{"type":"string","enum":["ttl","ioc"],"description":"`ttl`: the order reached its end time. `ioc`: the unfilled rest of an immediate-or-cancel order. Omitted on expiries indexed before nodes stored the reason."}}},"ActivityBackstop":{"type":"object","description":"A perp position swept to the backstop (`book` set), or the terminal cash sweep (`book` omitted).","required":["k","sz","cash","mark","eq","pnl"],"properties":{"k":{"type":"string","enum":["backstop"]},"book":{"$ref":"#/components/schemas/Bytes32"},"sz":{"$ref":"#/components/schemas/DecimalInt256","description":"Position size moved."},"cash":{"$ref":"#/components/schemas/DecimalInt256"},"mark":{"$ref":"#/components/schemas/DecimalUint256","description":"Mark price at the sweep."},"eq":{"$ref":"#/components/schemas/DecimalInt256","description":"Account equity at the sweep."},"pnl":{"$ref":"#/components/schemas/DecimalInt256","description":"Realized PnL; `\"0\"` on the cash sweep."}}},"ActivityBridgeTransfer":{"type":"object","description":"A bridge deposit (positive `amt`) or withdrawal (negative). `err` set means it was\nrefused and nothing moved.\n","required":["k","tx","idx","tok","amt"],"properties":{"k":{"type":"string","enum":["bridge_transfer"]},"tx":{"$ref":"#/components/schemas/Bytes32","description":"The bridge transaction."},"idx":{"type":"integer","description":"Position among the tick's deposits; `0` for a withdrawal."},"tok":{"$ref":"#/components/schemas/Address"},"amt":{"$ref":"#/components/schemas/DecimalInt256"},"err":{"type":"string"}}},"ActivityTransfer":{"type":"object","description":"An account-to-account transfer, signed from the account's side: debit negative, credit\npositive. A self-transfer is two entries, the debit first. A refused transfer is reported\nto the sender only, with `err`.\n","required":["k","id","cp","tok","amt"],"properties":{"k":{"type":"string","enum":["transfer"]},"id":{"$ref":"#/components/schemas/Bytes32","description":"Transfer id."},"cp":{"$ref":"#/components/schemas/Address","description":"The other side of the transfer, the receiver when `amt` is negative and the sender otherwise; the account itself on a self-transfer."},"tok":{"$ref":"#/components/schemas/Address"},"amt":{"$ref":"#/components/schemas/DecimalInt256"},"err":{"type":"string"}}},"ActivityModifyReject":{"type":"object","description":"An amendment the engine refused; the order is untouched. `px` and `sz` are what was asked for, `sz` unsigned.","required":["k","id","book","px","sz","why"],"properties":{"k":{"type":"string","enum":["modify_reject"]},"id":{"$ref":"#/components/schemas/Bytes32","description":"Order id."},"book":{"$ref":"#/components/schemas/Bytes32"},"px":{"$ref":"#/components/schemas/DecimalUint256"},"sz":{"$ref":"#/components/schemas/DecimalUint256"},"why":{"type":"string","description":"The engine's reason."}}},"ActivityCancelReject":{"type":"object","description":"A cancel the engine refused; the order still rests.","required":["k","id","book","why"],"properties":{"k":{"type":"string","enum":["cancel_reject"]},"id":{"$ref":"#/components/schemas/Bytes32","description":"Order id."},"book":{"$ref":"#/components/schemas/Bytes32"},"why":{"type":"string","description":"The engine's reason."}}},"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 Nonce Window

> The account's nonce window: the lowest nonce not yet executed (\`watermark\`) and a\
> bitmap of which of the next 128 nonces have executed. Any nonce in\
> \`\[watermark, watermark + 128)\` whose bit is not set can be used. An account the node\
> has never seen returns \`watermark: 0\` and an empty bitmap. Served by every node. The\
> same data as the JSON-RPC method \`pod\_getNonceSlots\`.<br>

```json
{"openapi":"3.0.0","info":{"title":"REST API","version":"1.0.0"},"tags":[{"name":"Account","description":"One account's orders, fills, positions, balances, triggers, backstop transfers,\nunified activity feed and nonce window. `{account}` is a 20-byte `0x` address.\n\n&nbsp; &nbsp; &nbsp;\n"}],"servers":[{"url":"https://staging-rpc.podtestnet.dev/v1","description":"Pod testnet"}],"paths":{"/accounts/{account}/nonce-slots":{"get":{"tags":["Account"],"summary":"Get Nonce Window","operationId":"getNonceSlots","description":"The account's nonce window: the lowest nonce not yet executed (`watermark`) and a\nbitmap of which of the next 128 nonces have executed. Any nonce in\n`[watermark, watermark + 128)` whose bit is not set can be used. An account the node\nhas never seen returns `watermark: 0` and an empty bitmap. Served by every node. The\nsame data as the JSON-RPC method `pod_getNonceSlots`.\n","parameters":[{"$ref":"#/components/parameters/AccountPath"},{"name":"since","in":"query","description":"The lowest solution time accepted, in microseconds. The node answers once it has\nexecuted up to it, otherwise `503` after its wait (default 2s). Omitted means\nanswer now.\n","schema":{"$ref":"#/components/schemas/Timestamp"}}],"responses":{"200":{"description":"Nonce window","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NonceSlotsResponse"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"500":{"description":"The account read failed. Empty body."},"503":{"$ref":"#/components/responses/NodeBehind"}}}}},"components":{"parameters":{"AccountPath":{"name":"account","in":"path","required":true,"schema":{"$ref":"#/components/schemas/Address"}}},"schemas":{"Address":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"20-byte address, `0x` hex"},"Timestamp":{"type":"integer","format":"int64","description":"Unix time in microseconds, as a JSON number"},"NonceSlotsResponse":{"type":"object","required":["watermark","finalized","solution_now"],"properties":{"watermark":{"type":"integer","format":"int64","description":"The lowest nonce that has not executed. Every nonce below it has."},"finalized":{"type":"string","description":"128-bit bitmap as `0x` hex. Bit `i` is set when nonce `watermark + i` has executed."},"solution_now":{"$ref":"#/components/schemas/Timestamp","description":"The time of the last batch the node executed, in microseconds."}}},"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"}}}},"NodeBehind":{"description":"The node did not reach the requested `timestamp` within its wait; a value later than the node's clock plus the wait is rejected without waiting. Sent with `Retry-After: 1` and `Cache-Control: no-store`.","headers":{"Retry-After":{"schema":{"type":"integer"}}},"content":{"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/account.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.
