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

# Futures balance summary

> Authenticated. Sends updates on all of a user's futures (FCM) balances,
including subsequent updates. No products required.




## AsyncAPI

````yaml api-reference/advanced-trade-api/advanced-trade-asyncapi.json futures_balance_summary
id: futures_balance_summary
title: Futures balance summary
description: |
  Authenticated. Sends updates on all of a user's futures (FCM) balances,
  including subsequent updates. No products required.
servers:
  - id: production
    protocol: wss
    host: advanced-trade-ws.coinbase.com
    bindings: []
    variables: []
address: futures_balance_summary
parameters: []
bindings: []
operations:
  - &ref_3
    id: futuresBalanceSummarySubscribe
    title: Subscribe to futures balance summary
    description: >-
      Client sends an authenticated subscribe or unsubscribe request for the
      futures_balance_summary channel. A JWT is required.
    type: receive
    messages:
      - &ref_5
        id: subscribe_request
        contentType: application/json
        payload:
          - name: Subscription request
            description: >-
              Subscribe to the futures_balance_summary channel. A JWT is
              required to receive data.
            type: object
            properties:
              - name: type
                type: string
                enumValues:
                  - subscribe
                  - unsubscribe
                required: true
              - name: channel
                type: string
                required: true
              - name: jwt
                type: string
                description: CDP JWT. Required to receive data on this channel.
                required: true
        headers: []
        jsonPayloadSchema:
          type: object
          additionalProperties: false
          required:
            - type
            - channel
            - jwt
          properties:
            type:
              type: string
              enum:
                - subscribe
                - unsubscribe
              default: subscribe
              x-parser-schema-id: <anonymous-schema-205>
            channel:
              type: string
              default: futures_balance_summary
              x-parser-schema-id: <anonymous-schema-206>
            jwt:
              type: string
              description: CDP JWT. Required to receive data on this channel.
              x-parser-schema-id: <anonymous-schema-207>
          x-parser-schema-id: <anonymous-schema-204>
        title: Subscription request
        description: >-
          Subscribe to the futures_balance_summary channel. A JWT is required to
          receive data.
        example: |-
          {
            "type": "subscribe",
            "channel": "futures_balance_summary",
            "jwt": "<JWT>"
          }
        bindings: []
        extensions:
          - id: x-parser-unique-object-id
            value: subscribe_request
    bindings: []
    extensions: &ref_2
      - id: x-parser-unique-object-id
        value: futures_balance_summary
  - &ref_4
    id: futuresBalanceSummaryStream
    title: Futures balance summary stream
    description: >-
      Server streams the user's futures (FCM) balance updates to the subscribed
      client.
    type: send
    messages:
      - &ref_6
        id: futures_balance_summary
        contentType: application/json
        payload:
          - allOf: &ref_1
              - type: object
                properties:
                  channel:
                    type: string
                    description: The channel that produced this message.
                    x-parser-schema-id: <anonymous-schema-5>
                  timestamp:
                    type: string
                    format: date-time
                    description: Server time the message was sent (RFC 3339).
                    x-parser-schema-id: <anonymous-schema-6>
                  sequence_num:
                    type: integer
                    description: >-
                      Per-connection message sequence number; use it to detect
                      dropped or out-of-order messages.
                    x-parser-schema-id: <anonymous-schema-7>
                x-parser-schema-id: EnvelopeBase
              - type: object
                properties:
                  channel:
                    const: futures_balance_summary
                    x-parser-schema-id: <anonymous-schema-209>
                  events:
                    type: array
                    items:
                      type: object
                      properties:
                        type:
                          type: string
                          enum:
                            - snapshot
                            - update
                          x-parser-schema-id: <anonymous-schema-212>
                        fcm_balance_summary:
                          type: object
                          properties:
                            futures_buying_power:
                              type: string
                              description: Cash balance available to trade CFM futures.
                              x-parser-schema-id: <anonymous-schema-213>
                            total_usd_balance:
                              type: string
                              description: >-
                                Aggregate USD across your CFTC-regulated futures
                                account and your Coinbase Inc. spot account.
                              x-parser-schema-id: <anonymous-schema-214>
                            cbi_usd_balance:
                              type: string
                              description: >-
                                USD maintained in your Coinbase Inc. spot
                                account.
                              x-parser-schema-id: <anonymous-schema-215>
                            cfm_usd_balance:
                              type: string
                              description: >-
                                USD in your CFTC-regulated futures account; not
                                available to trade spot.
                              x-parser-schema-id: <anonymous-schema-216>
                            total_open_orders_hold_amount:
                              type: string
                              description: >-
                                Total balance on hold for spot and futures open
                                orders.
                              x-parser-schema-id: <anonymous-schema-217>
                            unrealized_pnl:
                              type: string
                              description: >-
                                Current unrealized PnL across all open
                                positions.
                              x-parser-schema-id: <anonymous-schema-218>
                            daily_realized_pnl:
                              type: string
                              description: Realized PnL from the current trade date.
                              x-parser-schema-id: <anonymous-schema-219>
                            initial_margin:
                              type: string
                              description: Margin required to initiate futures positions.
                              x-parser-schema-id: <anonymous-schema-220>
                            available_margin:
                              type: string
                              description: >-
                                Funds available to meet your anticipated margin
                                requirement.
                              x-parser-schema-id: <anonymous-schema-221>
                            liquidation_threshold:
                              type: string
                              description: >-
                                When available collateral drops to this
                                threshold, positions are liquidated.
                              x-parser-schema-id: <anonymous-schema-222>
                            liquidation_buffer_amount:
                              type: string
                              description: >-
                                Funds available in excess of the liquidation
                                threshold (available margin minus liquidation
                                threshold).
                              x-parser-schema-id: <anonymous-schema-223>
                            liquidation_buffer_percentage:
                              type: string
                              description: >-
                                Funds available in excess of the liquidation
                                threshold, as a percentage.
                              x-parser-schema-id: <anonymous-schema-224>
                            intraday_margin_window_measure: &ref_0
                              type: object
                              properties:
                                margin_window_type:
                                  type: string
                                  enum:
                                    - FCM_MARGIN_WINDOW_TYPE_UNSPECIFIED
                                    - FCM_MARGIN_WINDOW_TYPE_OVERNIGHT
                                    - FCM_MARGIN_WINDOW_TYPE_WEEKEND
                                    - FCM_MARGIN_WINDOW_TYPE_INTRADAY
                                    - FCM_MARGIN_WINDOW_TYPE_TRANSITION
                                  description: The margin window this measure applies to.
                                  x-parser-schema-id: <anonymous-schema-225>
                                margin_level:
                                  type: string
                                  enum:
                                    - MARGIN_LEVEL_TYPE_UNSPECIFIED
                                    - MARGIN_LEVEL_TYPE_BASE
                                    - MARGIN_LEVEL_TYPE_WARNING
                                    - MARGIN_LEVEL_TYPE_DANGER
                                    - MARGIN_LEVEL_TYPE_LIQUIDATION
                                  description: Margin level for this window.
                                  x-parser-schema-id: <anonymous-schema-226>
                                initial_margin:
                                  type: string
                                  description: Initial margin for this window.
                                  x-parser-schema-id: <anonymous-schema-227>
                                maintenance_margin:
                                  type: string
                                  description: Maintenance margin for this window.
                                  x-parser-schema-id: <anonymous-schema-228>
                                liquidation_buffer_percentage:
                                  type: string
                                  description: >-
                                    Liquidation buffer percentage for this
                                    window.
                                  x-parser-schema-id: <anonymous-schema-229>
                                total_hold:
                                  type: string
                                  description: Total hold for this window.
                                  x-parser-schema-id: <anonymous-schema-230>
                                futures_buying_power:
                                  type: string
                                  description: Futures buying power for this window.
                                  x-parser-schema-id: <anonymous-schema-231>
                              x-parser-schema-id: MarginWindowMeasure
                            overnight_margin_window_measure: *ref_0
                          x-parser-schema-id: FCMBalanceSummary
                      x-parser-schema-id: <anonymous-schema-211>
                    x-parser-schema-id: <anonymous-schema-210>
                x-parser-schema-id: <anonymous-schema-208>
            x-parser-schema-id: FCMEnvelope
            name: Futures balance summary message
        headers: []
        jsonPayloadSchema:
          allOf: *ref_1
          x-parser-schema-id: FCMEnvelope
        title: Futures balance summary message
        example: '{}'
        bindings: []
        extensions:
          - id: x-parser-unique-object-id
            value: futures_balance_summary
    bindings: []
    extensions: *ref_2
sendOperations:
  - *ref_3
receiveOperations:
  - *ref_4
sendMessages:
  - *ref_5
receiveMessages:
  - *ref_6
extensions:
  - id: x-parser-unique-object-id
    value: futures_balance_summary
securitySchemes: []

````