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

# Subaccount quotes

> Channel name: `{subaccount_id}.quotes`. Private channel (requires authentication) that streams updates to your RFQ quotes for a subaccount, where {subaccount_id} is the numeric subaccount identifier.



## AsyncAPI

````yaml subscriptions.asyncapi.json subaccountQuotes
id: subaccountQuotes
title: Subaccount quotes
description: >-
  Channel name: `{subaccount_id}.quotes`. Private channel (requires
  authentication) that streams updates to your RFQ quotes for a subaccount,
  where {subaccount_id} is the numeric subaccount identifier.
servers:
  - id: production
    protocol: wss
    host: api.derive.xyz
    bindings: []
    variables: []
  - id: testnet
    protocol: wss
    host: testnet.api.derive.xyz
    bindings: []
    variables: []
address: /v3/ws
parameters: []
bindings: []
operations:
  - &ref_8
    id: receive_subaccountQuotes
    title: Receive_subaccount quotes
    type: send
    messages:
      - &ref_11
        id: subaccountQuotesNotification
        payload:
          - name: subaccountQuotesNotification
            description: Pushed as a JSON array; each element has the fields below.
            type: object
            properties:
              - name: cancel_reason
                type: string
                required: false
              - name: creation_timestamp
                type: integer
                required: true
              - name: direction
                type: string
                enumValues:
                  - buy
                  - sell
                required: true
              - name: extra_fee
                type: string
                description: >-
                  Non-negative decimal string of the human value (e.g. `"1.5"`),
                  up to 12 fractional digits; a string or JSON number is
                  accepted
                required: true
              - name: fee
                type: string
                description: >-
                  Non-negative decimal string of the human value (e.g. `"1.5"`),
                  up to 12 fractional digits; a string or JSON number is
                  accepted
                required: true
              - name: fill_pct
                type: string
                description: >-
                  Non-negative decimal string of the human value (e.g. `"1.5"`),
                  up to 12 fractional digits; a string or JSON number is
                  accepted
                required: true
              - name: is_transfer
                type: boolean
                required: true
              - name: label
                type: string
                required: true
              - name: last_update_timestamp
                type: integer
                required: true
              - name: legs
                type: array
                required: true
                properties:
                  - name: amount
                    type: string
                    description: >-
                      Non-negative decimal string of the human value (e.g.
                      `"1.5"`), up to 12 fractional digits; a string or JSON
                      number is accepted
                    required: true
                  - name: direction
                    type: string
                    enumValues:
                      - buy
                      - sell
                    required: true
                  - name: instrument_name
                    type: string
                    required: true
                  - name: price
                    type: string
                    description: >-
                      Non-negative decimal string of the human value (e.g.
                      `"1.5"`), up to 12 fractional digits; a string or JSON
                      number is accepted
                    required: true
              - name: legs_hash
                type: string
                required: true
              - name: liquidity_role
                type: string
                enumValues:
                  - maker
                  - taker
                required: true
              - name: max_fee
                type: string
                description: >-
                  Non-negative decimal string of the human value (e.g. `"1.5"`),
                  up to 12 fractional digits; a string or JSON number is
                  accepted
                required: true
              - name: mmp
                type: boolean
                required: true
              - name: nonce
                type: string
                required: true
              - name: quote_id
                type: string
                description: UUID v4 string
                required: true
              - name: rfq_id
                type: string
                description: UUID v4 string
                required: true
              - name: signature
                type: string
                required: true
              - name: signature_expiry_sec
                type: integer
                required: true
              - name: signer
                type: string
                required: true
              - name: status
                type: string
                enumValues:
                  - open
                  - filled
                  - cancelled
                  - expired
                required: true
              - name: subaccount_id
                type: integer
                required: true
              - name: tx_hash
                type: &ref_1
                  - string
                  - 'null'
                required: false
              - name: tx_status
                type: anyOf
                required: false
        headers: []
        jsonPayloadSchema:
          type: object
          required:
            - creation_timestamp
            - direction
            - extra_fee
            - fee
            - fill_pct
            - is_transfer
            - label
            - last_update_timestamp
            - legs
            - legs_hash
            - liquidity_role
            - max_fee
            - mmp
            - nonce
            - quote_id
            - rfq_id
            - signature
            - signature_expiry_sec
            - signer
            - status
            - subaccount_id
          properties:
            cancel_reason:
              anyOf:
                - type: string
                  enum:
                    - ''
                    - user_request
                    - insufficient_margin
                    - signed_max_fee_too_low
                    - mmp_trigger
                    - cancel_on_disconnect
                    - session_key_deregistered
                    - subaccount_withdrawn
                    - rfq_no_longer_open
                    - compliance
                  x-parser-schema-id: RFQCancelReason
                - type: 'null'
                  x-parser-schema-id: <anonymous-schema-123>
              x-parser-schema-id: <anonymous-schema-122>
            creation_timestamp:
              type: integer
              format: int64
              x-parser-schema-id: <anonymous-schema-124>
            direction: &ref_0
              type: string
              enum:
                - buy
                - sell
              x-parser-schema-id: Direction
            extra_fee:
              description: >-
                Non-negative decimal string of the human value (e.g. `"1.5"`),
                up to 12 fractional digits; a string or JSON number is accepted
              type: string
              format: decimal
              x-parser-schema-id: <anonymous-schema-125>
            fee:
              description: >-
                Non-negative decimal string of the human value (e.g. `"1.5"`),
                up to 12 fractional digits; a string or JSON number is accepted
              type: string
              format: decimal
              x-parser-schema-id: <anonymous-schema-126>
            fill_pct:
              description: >-
                Non-negative decimal string of the human value (e.g. `"1.5"`),
                up to 12 fractional digits; a string or JSON number is accepted
              type: string
              format: decimal
              x-parser-schema-id: <anonymous-schema-127>
            is_transfer:
              type: boolean
              x-parser-schema-id: <anonymous-schema-128>
            label:
              type: string
              x-parser-schema-id: <anonymous-schema-129>
            last_update_timestamp:
              type: integer
              format: int64
              x-parser-schema-id: <anonymous-schema-130>
            legs:
              type: array
              items:
                type: object
                required:
                  - amount
                  - direction
                  - instrument_name
                  - price
                properties:
                  amount:
                    description: >-
                      Non-negative decimal string of the human value (e.g.
                      `"1.5"`), up to 12 fractional digits; a string or JSON
                      number is accepted
                    type: string
                    format: decimal
                    x-parser-schema-id: <anonymous-schema-65>
                  direction: *ref_0
                  instrument_name:
                    type: string
                    x-parser-schema-id: <anonymous-schema-66>
                  price:
                    description: >-
                      Non-negative decimal string of the human value (e.g.
                      `"1.5"`), up to 12 fractional digits; a string or JSON
                      number is accepted
                    type: string
                    format: decimal
                    x-parser-schema-id: <anonymous-schema-67>
                x-parser-schema-id: PricedLegParamsAndResponse
              x-parser-schema-id: <anonymous-schema-131>
            legs_hash:
              type: string
              x-parser-schema-id: <anonymous-schema-132>
            liquidity_role:
              type: string
              enum:
                - maker
                - taker
              x-parser-schema-id: LiquidityRole
            max_fee:
              description: >-
                Non-negative decimal string of the human value (e.g. `"1.5"`),
                up to 12 fractional digits; a string or JSON number is accepted
              type: string
              format: decimal
              x-parser-schema-id: <anonymous-schema-133>
            mmp:
              type: boolean
              x-parser-schema-id: <anonymous-schema-134>
            nonce:
              type: string
              x-parser-schema-id: <anonymous-schema-135>
            quote_id:
              description: UUID v4 string
              type: string
              format: uuid
              x-parser-schema-id: <anonymous-schema-136>
            rfq_id:
              description: UUID v4 string
              type: string
              format: uuid
              x-parser-schema-id: <anonymous-schema-137>
            signature:
              type: string
              x-parser-schema-id: <anonymous-schema-138>
            signature_expiry_sec:
              type: integer
              format: int64
              x-parser-schema-id: <anonymous-schema-139>
            signer:
              type: string
              x-parser-schema-id: <anonymous-schema-140>
            status:
              type: string
              enum:
                - open
                - filled
                - cancelled
                - expired
              x-parser-schema-id: RFQStatus
            subaccount_id:
              type: integer
              format: int64
              x-parser-schema-id: <anonymous-schema-141>
            tx_hash:
              type: *ref_1
              x-parser-schema-id: <anonymous-schema-142>
            tx_status:
              anyOf:
                - oneOf:
                    - type: string
                      enum:
                        - requested
                        - pending
                        - settled
                        - reverted
                        - ignored
                        - timed_out
                      x-parser-schema-id: <anonymous-schema-144>
                    - description: >-
                        Applied off-chain; not yet included in an on-chain
                        settlement batch.
                      type: string
                      enum:
                        - applied
                      x-parser-schema-id: <anonymous-schema-145>
                    - description: Included in a settlement batch and executing.
                      type: string
                      enum:
                        - in_batch
                      x-parser-schema-id: <anonymous-schema-146>
                    - description: Settlement proof in progress.
                      type: string
                      enum:
                        - proving
                      x-parser-schema-id: <anonymous-schema-147>
                    - description: >-
                        Settlement transaction broadcast on-chain; awaiting
                        confirmation.
                      type: string
                      enum:
                        - submitted
                      x-parser-schema-id: <anonymous-schema-148>
                  x-parser-schema-id: TxStatus
                - type: 'null'
                  x-parser-schema-id: <anonymous-schema-149>
              x-parser-schema-id: <anonymous-schema-143>
          x-parser-schema-id: QuotePublishResult
        title: Subaccount quotes notification
        description: Pushed as a JSON array; each element has the fields below.
        example: |-
          {
            "cancel_reason": "<string>",
            "creation_timestamp": 123,
            "direction": "<string>",
            "extra_fee": "<string>",
            "fee": "<string>",
            "fill_pct": "<string>",
            "is_transfer": true,
            "label": "<string>",
            "last_update_timestamp": 123,
            "legs": {
              "amount": "<string>",
              "direction": "<string>",
              "instrument_name": "<string>",
              "price": "<string>"
            },
            "legs_hash": "<string>",
            "liquidity_role": "<string>",
            "max_fee": "<string>",
            "mmp": true,
            "nonce": "<string>",
            "quote_id": "<string>",
            "rfq_id": "<string>",
            "signature": "<string>",
            "signature_expiry_sec": 123,
            "signer": "<string>",
            "status": "<string>",
            "subaccount_id": 123
          }
        bindings: []
        extensions:
          - id: x-parser-unique-object-id
            value: subaccountQuotesNotification
    bindings: []
    extensions: &ref_6
      - id: x-parser-unique-object-id
        value: subaccountQuotes
  - &ref_7
    id: send_subscribe_subaccountQuotes
    title: Send_subscribe_subaccount quotes
    type: receive
    messages:
      - &ref_9
        id: subscribeRequest
        payload:
          - name: subscribeRequest
            description: >-
              Send to subscribe: list this channel's address (with the {param}
              segments filled, e.g. orderbook.ETH-PERP.10.20) in
              params.channels.
            type: object
            properties:
              - name: headers
                type: &ref_2
                  - object
                  - 'null'
                description: Non-standard; used by `auth/login`.
                required: false
              - name: id
                type: anyOf
                required: true
              - name: method
                type: string
                description: subscribe
                required: true
              - name: params
                type: object
                description: >-
                  Params for `subscribe`. `channels` is the required list of
                  channel names to subscribe to.
                required: true
                properties:
                  - name: channels
                    type: array
                    required: true
                    properties:
                      - name: item
                        type: string
                        required: false
        headers: []
        jsonPayloadSchema:
          type: object
          required:
            - id
            - method
            - params
          properties:
            headers:
              description: Non-standard; used by `auth/login`.
              type: *ref_2
              additionalProperties: true
              x-parser-schema-id: <anonymous-schema-16>
            id: &ref_4
              anyOf:
                - type: string
                  x-parser-schema-id: <anonymous-schema-17>
                - type: number
                  x-parser-schema-id: <anonymous-schema-18>
                - type: 'null'
                  x-parser-schema-id: <anonymous-schema-19>
              x-parser-schema-id: JsonRpcId
            method:
              type: string
              const: subscribe
              x-parser-schema-id: <anonymous-schema-20>
            params:
              description: >-
                Params for `subscribe`. `channels` is the required list of
                channel names to subscribe to.
              type: object
              required:
                - channels
              properties:
                channels:
                  type: array
                  items:
                    type: string
                    x-parser-schema-id: <anonymous-schema-22>
                  x-parser-schema-id: <anonymous-schema-21>
              x-parser-schema-id: SubscribeParams
          x-parser-schema-id: <anonymous-schema-15>
        title: Subscribe request
        description: >-
          Send to subscribe: list this channel's address (with the {param}
          segments filled, e.g. orderbook.ETH-PERP.10.20) in params.channels.
        example: |-
          {
            "id": 1,
            "method": "subscribe",
            "params": {
              "channels": [
                "orderbook.ETH-PERP.10.20"
              ]
            }
          }
        bindings: []
        extensions:
          - id: x-parser-unique-object-id
            value: subscribeRequest
      - &ref_10
        id: unsubscribeRequest
        payload:
          - name: unsubscribeRequest
            description: >-
              Send to unsubscribe: list the channel addresses to drop in
              params.channels, or omit it to unsubscribe from everything.
            type: object
            properties:
              - name: headers
                type: &ref_3
                  - object
                  - 'null'
                description: Non-standard; used by `auth/login`.
                required: false
              - name: id
                type: anyOf
                required: true
              - name: method
                type: string
                description: unsubscribe
                required: true
              - name: params
                type: object
                description: >-
                  Params for `unsubscribe`. `channels` is optional.


                  When omitted (or null) the connection unsubscribes from all
                  channels.
                required: true
                properties:
                  - name: channels
                    type: &ref_5
                      - array
                      - 'null'
                    required: false
        headers: []
        jsonPayloadSchema:
          type: object
          required:
            - id
            - method
            - params
          properties:
            headers:
              description: Non-standard; used by `auth/login`.
              type: *ref_3
              additionalProperties: true
              x-parser-schema-id: <anonymous-schema-24>
            id: *ref_4
            method:
              type: string
              const: unsubscribe
              x-parser-schema-id: <anonymous-schema-25>
            params:
              description: >-
                Params for `unsubscribe`. `channels` is optional.


                When omitted (or null) the connection unsubscribes from all
                channels.
              type: object
              properties:
                channels:
                  default: null
                  type: *ref_5
                  items:
                    type: string
                    x-parser-schema-id: <anonymous-schema-27>
                  x-parser-schema-id: <anonymous-schema-26>
              x-parser-schema-id: UnsubscribeParams
          x-parser-schema-id: <anonymous-schema-23>
        title: Unsubscribe request
        description: >-
          Send to unsubscribe: list the channel addresses to drop in
          params.channels, or omit it to unsubscribe from everything.
        example: |-
          {
            "method": "<string>",
            "params": {}
          }
        bindings: []
        extensions:
          - id: x-parser-unique-object-id
            value: unsubscribeRequest
    bindings: []
    extensions: *ref_6
sendOperations:
  - *ref_7
receiveOperations:
  - *ref_8
sendMessages:
  - *ref_9
  - *ref_10
receiveMessages:
  - *ref_11
extensions:
  - id: x-parser-unique-object-id
    value: subaccountQuotes
securitySchemes: []

````

## Related topics

- [Subaccount best quotes](/api-reference/channels/subaccountbestquotes.md)
- [List a subaccount's quotes with history](/api-reference/rfq/list-a-subaccounts-quotes-with-history.md)
- [Cancel multiple maker quotes by filter](/api-reference/rfq/cancel-multiple-maker-quotes-by-filter.md)
