> ## Documentation Index
> Fetch the complete documentation index at: https://staging-docs.orderly.network/llms.txt
> Use this file to discover all available pages before exploring further.

# Position context

> Single-symbol view: position, open orders for that symbol, market snapshot, and account risk summary — in one parallelized call.

Composite single-symbol view. Combines the matching position (if any), open orders for that symbol, a market snapshot, and an account-risk summary. All sub-handlers run in parallel.

Equivalent to `accountState` + `openOrders` (symbol-filtered) + `marketSummary`, but cheaper.

**Weight:** `2`

## Request

```json theme={null}
{
  "type": "positionContext",
  "address": "0x1234567890abcdef1234567890abcdef12345678",
  "symbol": "PERP_BTC_USDC",
  "broker_id": "orderly"
}
```

| Field        | Type   | Required | Default | Notes                                  |
| ------------ | ------ | -------- | ------- | -------------------------------------- |
| `address`    | string | Yes      | —       | Wallet address                         |
| `symbol`     | string | Yes      | —       | Trading pair                           |
| `broker_id`  | string | No       | —       | Optional                               |
| `account_id` | string | No       | —       | Optional — see "Primary account" below |

## Response

| Field             | Type           | Notes                                                          |
| ----------------- | -------------- | -------------------------------------------------------------- |
| `position`        | object \| null | `null` if the account does not hold this symbol                |
| `open_orders[]`   | array          | Already filtered to `symbol` — no client-side filtering needed |
| `market`          | object \| null | `null` if the symbol is absent from the latest summary         |
| `account_summary` | object \| null | `null` on `ADDRESS_NOT_FOUND`                                  |

## Notes

* **Primary account selection** (when `account_id` is omitted): the largest `account_value`, with `account_type == "main"` as the tiebreaker
* Sub-handlers run in parallel

<ResponseExample>
  ```json Response theme={null}
  {
    "success": true,
    "data": {
      "position": {
        /* same shape as accountState.positions[] item */
      },
      "open_orders": [
        /* openOrders rows, already filtered by symbol */
      ],
      "market": {
        "mark_price": "70305.1",
        "index_price": "70298.5",
        "bid_price": "70304.8",
        "ask_price": "70305.5",
        "last_funding_rate": "-0.00005082",
        "est_funding_rate": "-0.00009308",
        "next_funding_time": 1779278400000,
        "24h_volume": "523456789.50",
        "open_interest": "156789012.30"
      },
      "account_summary": {
        "free_collateral": "85000.00",
        "margin_ratio": "0.15"
      }
    },
    "ts": 1779269143700
  }
  ```
</ResponseExample>