---
slug: overview
title: 概述
sidebar_position: 1
---

Streaming 通过 WebSocket 订阅的方式提供实时行情数据。无需轮询，只需订阅指定标的和数据类型，服务端会在行情变动时主动推送更新到你的连接。

## 工作原理

1. **建立连接** — 通过 SDK 或[二进制通信协议](../../socket/protocol/overview)连接到 Longbridge WebSocket 服务。
2. **订阅** — 调用[订阅](./subscribe)接口，指定需要接收推送的标的和数据类型（报价、盘口、逐笔、经纪队列）。
3. **接收推送** — 行情发生变动时，服务端实时推送数据到你的连接。
4. **取消订阅** — 调用[取消订阅](./unsubscribe)停止接收特定标的或数据类型的推送。

## 订阅类型

| 类型 | 说明 |
|------|------|
| `Quote` | 实时买卖价及成交价 |
| `Depth` | Level 2 买卖盘口 |
| `Brokers` | 经纪队列数据 |
| `Trade` | 实时逐笔成交 |

## 订阅 vs. 直接查询

订阅适合需要实时增量更新的场景。如需一次性或按需查询，可使用以下拉取接口：

| 数据 | 拉取接口 |
|------|----------|
| 报价 | [实时报价](../stocks/quote) |
| 盘口 | [盘口](../stocks/depth) |
| 经纪队列 | [经纪队列](../stocks/brokers) |
| 逐笔明细 | [逐笔明细](../stocks/trade) |
| 分时数据 | [分时数据](../stocks/intraday) |
| K 线 | [K 线](../stocks/candlestick) |

## 注意事项

- 订阅状态与当前连接绑定，断线后自动清除。
- 可通过[获取订阅信息](./subsciption)随时查询当前活跃的订阅列表。
- 可订阅的数据类型取决于你的行情权限，详见[行情权限等级](../overview#行情权限等级)。