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

# Multi-symbol GEX levels

> Multi-symbol GEX levels in one round-trip. Returns a `results` map keyed by symbol with the same shape per-entry as /v2/gex/levels. Symbols with no current data return null in `results` and appear in `missing` rather than failing the whole request. Up to 8 symbols per request. Includes: `ranked` (top-10 strikes by |GEX|), `max_pain` (0DTE only), `expected_move` (1σ / 2σ implied range), `zones` (gamma flip zones).

Bundled multi-symbol read. Up to 8 symbols per request. Returns per-symbol entries + a `served` / `missing` / `invalid` breakdown.

## See also

<CardGroup cols={2}>
  <Card title="Multi-symbol bundling" href="/concepts/multi-symbol" icon="bookmark" />

  <Card title="What is GEX?" href="/concepts/gex" icon="bookmark" />
</CardGroup>


## OpenAPI

````yaml GET /multi/gex/levels
openapi: 3.1.0
info:
  title: BackQuant API v2
  description: >-

    # BackQuant API v2


    Options + gamma-exposure focused public API. Built on the same data the

    BackQuant Pro Terminal renders — pre-computed every 30s, served from cache.


    ## What's in v2


    * **Discovery**: `/v2/symbols` (universe + per-symbol freshness + supported
      endpoint list), `/v2/expiries` (active expiry tokens with DTE), `/v2/status`
      (per-symbol-per-category health with thresholds + overall classification).
    * **GEX**: composable levels (HVL / call wall / put support / max-pain /
      expected move / gamma-flip zones), strike profile with typed expiry
      filter, expiry profile, strike × expiry heatmap with downsampling,
      greek time-heatmap with DTE/OI/IV filters, history (cursor-paginated),
      Postgres-backed stress history, **per-expiry max-pain with pain curve**.
    * **Options**: filtered options chain with two-layer projection (top-level
      `?fields=` and per-contract `?include=oi,iv,greeks,bid_ask,volume,gex`)
      plus moneyness filter (`?moneyness_min=0.9&moneyness_max=1.1`), expiry
      summary table, full IV suite (surface / term structure / 25Δ-10Δ skew /
      curves / **single-expiry smile** / IV-RV history / VRP), expected move,
      **Breeden-Litzenberger probability density and surface**, typed greek
      profiles (delta / theta / vanna / charm / vega), strike × time charm/vega
      surfaces, strike × expiry 3D greek surface, OI by expiry + history,
      put/call ratio (intraday or daily), 0DTE & weekly premium tide,
      dated-futures term structure.
    * **Liquidation**: heatmap + leverage-tiered distribution.

    * **Multi**: `/v2/multi/gex/levels` — bundled multi-symbol read across the
      universe in one round-trip, with the same `?include=` model as the
      single-symbol endpoint.

    ## Authentication


    Every v2 route (except `/v2/openapi.json`, `/v2/docs`, `/v2/redoc`, and

    `/v2/health`) requires the `X-API-Key` header.


    ```

    X-API-Key: bq_live_your_api_key_here

    ```


    **Get your API key at
    [backquant.com/api-access](https://backquant.com/api-access).**


    The same key works across v1 and v2 — if you already have a v1 key, no

    re-issuance is needed.


    ## Rate limits


    Per-key, derived from your subscription tier:


    | Tier        | Limit                |

    |-------------|----------------------|

    | Monthly     | 60 requests/min      |

    | Yearly      | 120 requests/min     |

    | Enterprise  | No limit             |


    Headers `X-RateLimit-Limit / -Remaining / -Reset` are included in every

    response, and the same triple is echoed inside `meta.rate_limit` when

    populated by middleware.


    ## Response envelope


    ```json

    {
      "success": true,
      "data": { ... },
      "meta": {
        "version": "2.0",
        "timestamp": "2026-04-29T12:00:00.000Z",
        "request_id": "req_…",
        "symbol": "BTCUSDT",
        "spot_price": 67213.5,
        "computed_at": "2026-04-29T11:59:48.000Z",
        "freshness_seconds": 12.0,
        "source": ["deribit","bybit","okx","binance"],
        "exchanges_filtered": ["deribit","bybit"]
      }
    }

    ```


    ## Errors


    ```json

    {
      "success": false,
      "error": {
        "code": "NOT_FOUND",
        "message": "No data for BTCUSDT"
      },
      "meta": { "version": "2.0", "timestamp": "..." }
    }

    ```


    | Code                  | When |

    |-----------------------|------|

    | `UNAUTHORIZED`        | Missing or invalid API key |

    | `FORBIDDEN`           | Subscription doesn't allow API access |

    | `NOT_FOUND`           | Symbol/expiry/etc. not present in cache |

    | `VALIDATION_ERROR`    | Bad query parameters |

    | `RATE_LIMIT_EXCEEDED` | Per-tier limit hit |

    | `UPSTREAM_ERROR`      | Cache or DB temporarily unreachable |

    | `INTERNAL_ERROR`      | Anything else |
        
  version: 2.0.0
servers: []
security: []
tags:
  - name: Meta
    description: Unauthenticated metadata + endpoint catalog (planning your integration)
  - name: Discovery
    description: Symbol catalog, active expiries, and service status
  - name: GEX
    description: Gamma exposure analytics
  - name: Options
    description: Options chain, IV, greeks, probability, premium tide
  - name: Liquidation
    description: Liquidation heatmap and distribution
  - name: Multi
    description: Bundled multi-symbol endpoints (single round-trip across the universe)
paths:
  /multi/gex/levels:
    get:
      tags:
        - Multi
      summary: GEX levels across multiple symbols (bundled)
      description: >-
        Multi-symbol GEX levels in one round-trip. Returns a `results` map keyed
        by symbol with the same shape per-entry as /v2/gex/levels. Symbols with
        no current data return null in `results` and appear in `missing` rather
        than failing the whole request. Up to 8 symbols per request. Includes:
        `ranked` (top-10 strikes by |GEX|), `max_pain` (0DTE only),
        `expected_move` (1σ / 2σ implied range), `zones` (gamma flip zones).
      operationId: get_multi_gex_levels_multi_gex_levels_get
      parameters:
        - name: symbols
          in: query
          required: true
          schema:
            type: string
            description: Comma-separated symbols, e.g. `BTCUSDT,ETHUSDT,SOLUSDT,HYPEUSDT`.
            examples:
              all-four:
                value: BTCUSDT,ETHUSDT,SOLUSDT,HYPEUSDT
            title: Symbols
          description: Comma-separated symbols, e.g. `BTCUSDT,ETHUSDT,SOLUSDT,HYPEUSDT`.
        - name: exchanges
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: Comma-separated venue filter
            title: Exchanges
          description: Comma-separated venue filter
        - name: include
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: 'Optional sections: expected_move,max_pain,ranked,zones'
            title: Include
          description: 'Optional sections: expected_move,max_pain,ranked,zones'
        - name: X-API-Key
          in: header
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            title: X-Api-Key
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MultiGexLevelsResponse'
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/V2ErrorEnvelope'
          description: Bad Request
        '401':
          description: Invalid or missing API key
          content:
            application/json:
              example:
                success: false
                error:
                  code: UNAUTHORIZED
                  message: Invalid API key
                meta:
                  version: '2.0'
                  timestamp: '2026-04-29T12:00:00Z'
        '404':
          description: No data available for the requested resource
          content:
            application/json:
              example:
                success: false
                error:
                  code: NOT_FOUND
                  message: No data for BTCUSDT
                meta:
                  version: '2.0'
                  timestamp: '2026-04-29T12:00:00Z'
        '422':
          description: Validation error on query parameters
          content:
            application/json:
              example:
                success: false
                error:
                  code: VALIDATION_ERROR
                  message: Invalid request parameters
                  details:
                    errors: []
                meta:
                  version: '2.0'
                  timestamp: '2026-04-29T12:00:00Z'
        '429':
          description: Rate limit exceeded
          content:
            application/json:
              example:
                success: false
                error:
                  code: RATE_LIMIT_EXCEEDED
                  message: Rate limit exceeded. Try again later.
                meta:
                  version: '2.0'
                  timestamp: '2026-04-29T12:00:00Z'
      security:
        - ApiKeyAuth: []
components:
  schemas:
    MultiGexLevelsResponse:
      properties:
        success:
          type: boolean
          const: true
          title: Success
          default: true
        data:
          $ref: '#/components/schemas/MultiGexLevelsData'
        meta:
          $ref: '#/components/schemas/V2Meta'
      type: object
      required:
        - data
        - meta
      title: MultiGexLevelsResponse
    V2ErrorEnvelope:
      properties:
        success:
          type: boolean
          const: false
          title: Success
          default: false
        error:
          $ref: '#/components/schemas/V2Error'
        meta:
          $ref: '#/components/schemas/V2Meta'
      type: object
      required:
        - error
        - meta
      title: V2ErrorEnvelope
      description: Returned for every non-2xx response.
    MultiGexLevelsData:
      properties:
        results:
          additionalProperties:
            anyOf:
              - $ref: '#/components/schemas/MultiSymbolEntry'
              - type: 'null'
          type: object
          title: Results
          description: Per-symbol entries; null for missing symbols.
        requested:
          items:
            type: string
          type: array
          title: Requested
        served:
          items:
            type: string
          type: array
          title: Served
        missing:
          items:
            type: string
          type: array
          title: Missing
        invalid:
          items:
            type: string
          type: array
          title: Invalid
      type: object
      required:
        - results
        - requested
        - served
        - missing
        - invalid
      title: MultiGexLevelsData
    V2Meta:
      properties:
        version:
          type: string
          const: '2.0'
          title: Version
          description: API version tag.
        timestamp:
          type: string
          title: Timestamp
          description: ISO 8601 wall-clock when the response was built.
        request_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Request Id
          description: X-Request-ID for tracing across logs / Sentry.
        symbol:
          anyOf:
            - type: string
            - type: 'null'
          title: Symbol
          description: Symbol the response is about, if applicable.
        spot_price:
          anyOf:
            - type: number
            - type: 'null'
          title: Spot Price
          description: Current spot price for the symbol.
        computed_at:
          anyOf:
            - type: string
            - type: 'null'
          title: Computed At
          description: ISO 8601 of when the underlying cache value was last written.
        freshness_seconds:
          anyOf:
            - type: number
            - type: 'null'
          title: Freshness Seconds
          description: '`now - computed_at` in seconds; useful for staleness alarms.'
        source:
          anyOf:
            - items:
                type: string
              type: array
            - type: 'null'
          title: Source
          description: Upstream venue list the data flowed through.
        exchanges_filtered:
          anyOf:
            - items:
                type: string
              type: array
            - type: 'null'
          title: Exchanges Filtered
          description: Echo of the `?exchanges=` filter when one was applied.
        rate_limit:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          title: Rate Limit
          description: '`{limit, remaining, reset}` echo of the rate-limit headers.'
        extra:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          title: Extra
          description: Open dict for endpoint-specific metadata (filter_hash, etc.).
      type: object
      required:
        - version
        - timestamp
      title: V2Meta
      description: |-
        The meta block returned alongside every v2 response.

        Every field after `version`/`timestamp` is optional because endpoints
        attach different combinations — e.g. `/v2/status` skips `symbol`, the
        chain endpoint sets `extra.filter_hash`, etc. Listing them here means
        SDKs get a typed accessor for each instead of a generic `meta: dict`.
    V2Error:
      properties:
        code:
          type: string
          title: Code
          description: Stable machine-readable error code (see /v2/meta).
        message:
          type: string
          title: Message
          description: Human-readable description.
        details:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          title: Details
          description: >-
            Optional structured payload — e.g. validation_error returns the
            failing field list.
      type: object
      required:
        - code
        - message
      title: V2Error
    MultiSymbolEntry:
      properties:
        all_expiry:
          $ref: '#/components/schemas/GexAllExpiryLevels'
        odte:
          $ref: '#/components/schemas/GexOdteLevels'
        spot_price:
          anyOf:
            - type: number
            - type: 'null'
          title: Spot Price
        computed_at:
          anyOf:
            - type: string
            - type: 'null'
          title: Computed At
        ranked:
          anyOf:
            - $ref: '#/components/schemas/GexRanked'
            - type: 'null'
        max_pain:
          anyOf:
            - $ref: '#/components/schemas/GexMaxPainBlock'
            - type: 'null'
        expected_move:
          anyOf:
            - $ref: '#/components/schemas/GexExpectedMove'
            - type: 'null'
        gamma_flip_zones:
          anyOf:
            - items: {}
              type: array
            - type: 'null'
          title: Gamma Flip Zones
      type: object
      required:
        - all_expiry
        - odte
      title: MultiSymbolEntry
      description: |-
        One symbol's slice of the bundle. Same shape as a single-symbol
        /v2/gex/levels response, sans the wrapper envelope.
    GexAllExpiryLevels:
      properties:
        hvl:
          anyOf:
            - type: number
            - type: 'null'
          title: Hvl
          description: Hedging volume level (gamma-flip).
        call_resistance:
          anyOf:
            - type: number
            - type: 'null'
          title: Call Resistance
        call_wall_2:
          anyOf:
            - type: number
            - type: 'null'
          title: Call Wall 2
        call_wall_3:
          anyOf:
            - type: number
            - type: 'null'
          title: Call Wall 3
        put_support:
          anyOf:
            - type: number
            - type: 'null'
          title: Put Support
        put_wall_2:
          anyOf:
            - type: number
            - type: 'null'
          title: Put Wall 2
        put_wall_3:
          anyOf:
            - type: number
            - type: 'null'
          title: Put Wall 3
      type: object
      title: GexAllExpiryLevels
    GexOdteLevels:
      properties:
        hvl:
          anyOf:
            - type: number
            - type: 'null'
          title: Hvl
        call_resistance:
          anyOf:
            - type: number
            - type: 'null'
          title: Call Resistance
        put_support:
          anyOf:
            - type: number
            - type: 'null'
          title: Put Support
      type: object
      title: GexOdteLevels
    GexRanked:
      properties:
        all_expiry_top_10:
          items:
            $ref: '#/components/schemas/GexRankedLevel'
          type: array
          title: All Expiry Top 10
          default: []
        odte_top_10:
          items:
            $ref: '#/components/schemas/GexRankedLevel'
          type: array
          title: Odte Top 10
          default: []
      type: object
      title: GexRanked
    GexMaxPainBlock:
      properties:
        strike:
          anyOf:
            - type: number
            - type: 'null'
          title: Strike
        value:
          anyOf:
            - type: number
            - type: 'null'
          title: Value
      type: object
      title: GexMaxPainBlock
    GexExpectedMove:
      properties:
        upper_1sd:
          anyOf:
            - type: number
            - type: 'null'
          title: Upper 1Sd
        lower_1sd:
          anyOf:
            - type: number
            - type: 'null'
          title: Lower 1Sd
        upper_2sd:
          anyOf:
            - type: number
            - type: 'null'
          title: Upper 2Sd
        lower_2sd:
          anyOf:
            - type: number
            - type: 'null'
          title: Lower 2Sd
      type: object
      title: GexExpectedMove
    GexRankedLevel:
      properties:
        rank:
          type: integer
          title: Rank
        strike:
          type: number
          title: Strike
        gex:
          type: number
          title: Gex
        abs_gex:
          type: number
          title: Abs Gex
      type: object
      required:
        - rank
        - strike
        - gex
        - abs_gex
      title: GexRankedLevel
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key
      description: Your BackQuant API key (same key as v1)

````