Quotes
旧版行情推送接口，仅推送行情数据，不支持市场深度。
新接入建议使用 /v1/ws/stream。
AsyncAPI
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: []