行情 API 概覽
行情接口提供實時及歷史市場數據,覆蓋港股、美股、A 股、新加坡、日本、澳洲、加拿大、馬來西亞、韓國等市場。
接口分類
- 實時行情 — 行情快照、實時報價、買賣盤、當前 K 線、分時數據、逐筆成交。
- 基本數據 — 股票基本資訊、交易日曆、復權因子、所屬板塊、歷史 K 線、市場狀態。
- 資金 — 日內與歷史資金流向、資金分佈。
- 板塊 — 板塊列表、板塊成分股。
- 衍生品 — 關聯期貨、期權到期日、期權鏈、期貨合約資訊、期權波動率與行權概率。
- 全市場篩選 — 股票篩選、窩輪篩選、期權篩選,支持多維度條件過濾。
- IPO — 港股、美股、A 股、馬來西亞、日本、新加坡新股列表。
- 個性化 — 自選股列表、自選股分組、修改自選股。
- F10 深度數據 — 財務數據、研究報告、估值、公司行為、股東持股、公司簡介與高管。
- 賣空數據 — 每日賣空成交、空頭持倉。
標的代碼格式
所有行情接口使用統一的標的代碼格式:<MARKET>.<CODE>
| 市場 | 前綴 | 示例 |
|---|---|---|
| 港股 | HK | HK.00700、HK.09988 |
| 美股 | US | US.AAPL、US.TSLA |
| 上證 | SH | SH.600519 |
| 深證 | SZ | SZ.000001 |
| 新加坡 | SG | SG.D05 |
| 日本 | JP | JP.9984 |
| 澳洲 | AU | AU.BHP |
| 加拿大 | CA | CA.SHOP |
| 馬來西亞 | MY | MY.1155 |
| 韓國 | KR | KR.005930 |
分頁約定
所有涉及列表分頁的接口遵循統一約定。
入參:
| 參數 | 類型 | 說明 |
|---|---|---|
next_key | string | 翻頁游標,首頁留空 ""。把上一頁響應的 pagination.next_key 原樣回傳即可取下一頁。 |
limit | int | 每頁條數(各接口有各自預設值與上限)。 |
出參: 分頁信息統一放在響應頂層的 pagination 對象:
| 字段 | 類型 | 說明 |
|---|---|---|
has_more | bool | 是否還有下一頁。以 has_more=false 作為停止翻頁的唯一信號。 |
next_key | string | 下一頁游標;無更多頁時為 "-1"。 |
total | int | 滿足條件的總條數(可選,僅在後端能提供總數的接口返回)。 |
游標 next_key 對調用方不透明,請勿自行解析或構造。
例外: 少數按日期區間拉取的接口(get_capital_flow_history、request_history_kline)以 pagination.has_more 指示是否還有更早數據,調用方通過調整日期區間向更早翻頁,不使用 next_key 游標。
參考
- 命名詞典 — 枚舉值對照表,包含所有行情接口使用的枚舉定義。