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

# Quotes

> 旧版行情推送接口，仅推送行情数据，不支持市场深度。
新接入建议使用 `/v1/ws/stream`。




## AsyncAPI

````yaml zh-Hans/api-reference/websocket.yaml quotes
id: quotes
title: Quotes
description: |
  旧版行情推送接口，仅推送行情数据，不支持市场深度。
  新接入建议使用 `/v1/ws/stream`。
servers:
  - id: production
    protocol: wss
    host: api.tickflow.org
    bindings: []
    variables: []
address: /v1/ws/quotes
parameters: []
bindings: []
operations:
  - &ref_1
    id: legacySendSubscribe
    title: Legacy send subscribe
    description: 客户端发送订阅请求（旧版）
    type: receive
    messages:
      - &ref_6
        id: subscribeRequest
        contentType: application/json
        payload:
          - name: 订阅标的
            description: 订阅一组标的的实时行情推送（无 channel 字段）
            type: object
            properties:
              - name: op
                type: string
                description: 操作类型
                enumValues:
                  - subscribe
                required: true
              - name: symbols
                type: array
                description: 要订阅的标的代码列表
                required: true
                properties:
                  - name: item
                    type: string
                    required: false
        headers: []
        jsonPayloadSchema:
          type: object
          additionalProperties: false
          properties:
            op:
              type: string
              enum:
                - subscribe
              description: 操作类型
              x-parser-schema-id: <anonymous-schema-50>
            symbols:
              type: array
              items:
                type: string
                x-parser-schema-id: <anonymous-schema-52>
              description: 要订阅的标的代码列表
              x-parser-schema-id: <anonymous-schema-51>
          required:
            - op
            - symbols
          examples:
            - op: subscribe
              symbols:
                - 600000.SH
                - 000001.SZ
          x-parser-schema-id: <anonymous-schema-49>
        title: 订阅标的
        description: 订阅一组标的的实时行情推送（无 channel 字段）
        example: |-
          {
            "op": "subscribe",
            "symbols": [
              "600000.SH",
              "000001.SZ"
            ]
          }
        bindings: []
        extensions:
          - id: x-parser-unique-object-id
            value: subscribeRequest
    bindings: []
    extensions: &ref_0
      - id: x-parser-unique-object-id
        value: quotes
  - &ref_2
    id: legacySendUnsubscribe
    title: Legacy send unsubscribe
    description: 客户端发送退订请求（旧版）
    type: receive
    messages:
      - &ref_7
        id: unsubscribeRequest
        contentType: application/json
        payload:
          - name: 退订标的
            description: 退订一组标的
            type: object
            properties:
              - name: op
                type: string
                description: 操作类型
                enumValues:
                  - unsubscribe
                required: true
              - name: symbols
                type: array
                description: 要退订的标的代码列表
                required: true
                properties:
                  - name: item
                    type: string
                    required: false
        headers: []
        jsonPayloadSchema:
          type: object
          additionalProperties: false
          properties:
            op:
              type: string
              enum:
                - unsubscribe
              description: 操作类型
              x-parser-schema-id: <anonymous-schema-54>
            symbols:
              type: array
              items:
                type: string
                x-parser-schema-id: <anonymous-schema-56>
              description: 要退订的标的代码列表
              x-parser-schema-id: <anonymous-schema-55>
          required:
            - op
            - symbols
          examples:
            - op: unsubscribe
              symbols:
                - 600000.SH
          x-parser-schema-id: <anonymous-schema-53>
        title: 退订标的
        description: 退订一组标的
        example: |-
          {
            "op": "unsubscribe",
            "symbols": [
              "600000.SH"
            ]
          }
        bindings: []
        extensions:
          - id: x-parser-unique-object-id
            value: unsubscribeRequest
    bindings: []
    extensions: *ref_0
  - &ref_3
    id: legacyReceiveSubscribed
    title: Legacy receive subscribed
    description: 服务端返回订阅状态（旧版）
    type: send
    messages:
      - &ref_8
        id: subscribedResponse
        contentType: application/json
        payload:
          - name: 订阅状态
            description: subscribe / unsubscribe 操作后返回当前完整订阅列表
            type: object
            properties:
              - name: op
                type: string
                description: 消息类型
                enumValues:
                  - subscribed
                required: true
              - name: symbols
                type: array
                description: 当前已订阅的全部标的
                required: true
                properties:
                  - name: item
                    type: string
                    required: false
              - name: total
                type: integer
                description: 当前已订阅标的总数
                required: true
        headers: []
        jsonPayloadSchema:
          type: object
          additionalProperties: false
          properties:
            op:
              type: string
              enum:
                - subscribed
              description: 消息类型
              x-parser-schema-id: <anonymous-schema-58>
            symbols:
              type: array
              items:
                type: string
                x-parser-schema-id: <anonymous-schema-60>
              description: 当前已订阅的全部标的
              x-parser-schema-id: <anonymous-schema-59>
            total:
              type: integer
              description: 当前已订阅标的总数
              x-parser-schema-id: <anonymous-schema-61>
          required:
            - op
            - symbols
            - total
          examples:
            - op: subscribed
              symbols:
                - 600000.SH
                - 000001.SZ
              total: 2
          x-parser-schema-id: <anonymous-schema-57>
        title: 订阅状态
        description: subscribe / unsubscribe 操作后返回当前完整订阅列表
        example: |-
          {
            "op": "subscribed",
            "symbols": [
              "600000.SH",
              "000001.SZ"
            ],
            "total": 2
          }
        bindings: []
        extensions:
          - id: x-parser-unique-object-id
            value: subscribedResponse
    bindings: []
    extensions: *ref_0
  - &ref_4
    id: legacyReceiveQuotes
    title: Legacy receive quotes
    description: 服务端推送实时行情（旧版）
    type: send
    messages:
      - &ref_9
        id: quotesData
        contentType: application/json
        payload:
          - name: 行情推送
            description: 实时行情数据，仅包含已订阅且有更新的标的
            type: object
            properties:
              - name: op
                type: string
                description: 消息类型
                enumValues:
                  - quotes
                required: true
              - name: data
                type: array
                description: 行情快照列表
                required: true
                properties:
                  - name: symbol
                    type: string
                    description: 标的代码
                    required: true
                  - name: region
                    type: string
                    description: 市场区域
                    enumValues:
                      - CN
                      - US
                      - HK
                    required: true
                  - name: last_price
                    type: number
                    description: 最新价
                    required: true
                  - name: prev_close
                    type: number
                    description: 昨收价
                    required: true
                  - name: open
                    type: number
                    description: 开盘价
                    required: true
                  - name: high
                    type: number
                    description: 最高价
                    required: true
                  - name: low
                    type: number
                    description: 最低价
                    required: true
                  - name: volume
                    type: integer
                    description: 成交量
                    required: true
                  - name: amount
                    type: number
                    description: 成交额
                    required: true
                  - name: timestamp
                    type: integer
                    description: 行情时间戳（毫秒）
                    required: true
                  - name: session
                    type: string
                    description: 交易时段（可选）
                    required: false
                  - name: ext
                    type: object
                    description: 扩展数据（名称、涨跌幅等，可选）
                    required: false
        headers: []
        jsonPayloadSchema:
          type: object
          additionalProperties: false
          properties:
            op:
              type: string
              enum:
                - quotes
              description: 消息类型
              x-parser-schema-id: <anonymous-schema-63>
            data:
              type: array
              items:
                type: object
                additionalProperties: true
                description: 单条行情快照
                properties:
                  symbol:
                    type: string
                    example: 600000.SH
                    description: 标的代码
                    x-parser-schema-id: <anonymous-schema-20>
                  region:
                    type: string
                    enum:
                      - CN
                      - US
                      - HK
                    example: CN
                    description: 市场区域
                    x-parser-schema-id: <anonymous-schema-21>
                  last_price:
                    type: number
                    example: 9.72
                    description: 最新价
                    x-parser-schema-id: <anonymous-schema-22>
                  prev_close:
                    type: number
                    example: 9.78
                    description: 昨收价
                    x-parser-schema-id: <anonymous-schema-23>
                  open:
                    type: number
                    example: 9.78
                    description: 开盘价
                    x-parser-schema-id: <anonymous-schema-24>
                  high:
                    type: number
                    example: 9.78
                    description: 最高价
                    x-parser-schema-id: <anonymous-schema-25>
                  low:
                    type: number
                    example: 9.68
                    description: 最低价
                    x-parser-schema-id: <anonymous-schema-26>
                  volume:
                    type: integer
                    example: 426585
                    description: 成交量
                    x-parser-schema-id: <anonymous-schema-27>
                  amount:
                    type: number
                    example: 422430500
                    description: 成交额
                    x-parser-schema-id: <anonymous-schema-28>
                  timestamp:
                    type: integer
                    example: 1776754802000
                    description: 行情时间戳（毫秒）
                    x-parser-schema-id: <anonymous-schema-29>
                  session:
                    type: string
                    example: trading
                    description: 交易时段（可选）
                    x-parser-schema-id: <anonymous-schema-30>
                  ext:
                    type: object
                    description: 扩展数据（名称、涨跌幅等，可选）
                    x-parser-schema-id: <anonymous-schema-31>
                required:
                  - symbol
                  - region
                  - last_price
                  - prev_close
                  - open
                  - high
                  - low
                  - volume
                  - amount
                  - timestamp
                x-parser-schema-id: Quote
              description: 行情快照列表
              x-parser-schema-id: <anonymous-schema-64>
          required:
            - op
            - data
          x-parser-schema-id: <anonymous-schema-62>
        title: 行情推送
        description: 实时行情数据，仅包含已订阅且有更新的标的
        example: No examples found
        bindings: []
        extensions:
          - id: x-parser-unique-object-id
            value: quotesData
    bindings: []
    extensions: *ref_0
  - &ref_5
    id: legacyReceiveError
    title: Legacy receive error
    description: 服务端返回错误（旧版）
    type: send
    messages:
      - &ref_10
        id: errorResponse
        contentType: application/json
        payload:
          - name: 错误消息
            description: 操作失败时返回的错误信息
            type: object
            properties:
              - name: op
                type: string
                description: 消息类型
                enumValues:
                  - error
                required: true
              - name: message
                type: string
                description: 错误详情
                required: true
        headers: []
        jsonPayloadSchema:
          type: object
          additionalProperties: false
          properties:
            op:
              type: string
              enum:
                - error
              description: 消息类型
              x-parser-schema-id: <anonymous-schema-66>
            message:
              type: string
              description: 错误详情
              x-parser-schema-id: <anonymous-schema-67>
          required:
            - op
            - message
          x-parser-schema-id: <anonymous-schema-65>
        title: 错误消息
        description: 操作失败时返回的错误信息
        example: |-
          {
            "op": "<string>",
            "message": "<string>"
          }
        bindings: []
        extensions:
          - id: x-parser-unique-object-id
            value: errorResponse
    bindings: []
    extensions: *ref_0
sendOperations:
  - *ref_1
  - *ref_2
receiveOperations:
  - *ref_3
  - *ref_4
  - *ref_5
sendMessages:
  - *ref_6
  - *ref_7
receiveMessages:
  - *ref_8
  - *ref_9
  - *ref_10
extensions:
  - id: x-parser-unique-object-id
    value: quotes
securitySchemes:
  - id: apiKey
    name: api_key
    type: httpApiKey
    in: query
    extensions: []

````