股票行情API:串接美股、港股與A股

以同一套股票API整理美股、港股與A股資料:行情看板使用即時報價,研究與回測查詢歷史K線,買賣盤與逐筆成交用來觀察委託報價和成交變化。TickDB提供REST查詢與WebSocket推送;實際標的、歷史範圍與使用權限,以目前方案和資料可用性為準。

三大股票市場,25,000+ 標的

市場標的合計
25,285
A 股
7,570
美股
14,371
港股
3,344

資料更新:

覆蓋 A 股、美股和港股。三地市場品類合計超過 25,000 個標的,統計可能包含 ETF、債券等非普通股產品,不能視為純股票數量或免費可存取數量。

A 股

600519.SH · 000001.SZ · 920186.BJ

滬深北股票行情,買賣各五檔盤口;結合交易時段與交易日曆觀察集合競價和連續交易。

A股即時行情API

美股

AAPL.US · TSLA.US · MSFT.US

覆蓋 NYSE、Nasdaq 等美國市場,提供最優買賣報價。盤前、盤後及夜盤資料按具體標的和權限提供。

美股行情API

港股

700.HK · 9988.HK · 3690.HK

港交所股票行情,買賣各十檔盤口;透過報價、盤口和逐筆成交觀察開市前時段及盤中變化。

港股行情API

股票API提供哪些資料?依使用需求選擇

小螢幕可左右滑動查看完整表格。

你要完成什麼使用什麼資料如何串接先確認什麼
顯示股價、維護觀察清單行情快照與報價更新REST查詢或WebSocket推送標的涵蓋範圍、報價時間與權限
研究歷史走勢、計算指標與回測歷史K線與復權(還原權息)資料REST查詢歷史範圍、週期、還原方式及缺漏紀錄
觀察買賣報價與價差買賣盤REST查詢或WebSocket推送各市場支援的檔位與帳戶權限
追蹤成交變化逐筆成交REST查詢或WebSocket推送可查詢/訂閱範圍與帳戶權限

股票 API 接入範例:REST、Python 與 WebSocket

以下為文件介面範例,不是實測行情。先確認標的和權限,在伺服器端透過環境變數保存 API Key。Python 範例需安裝 requests,WebSocket 範例需安裝 websockets。

行情快照
curl --fail-with-body -H "X-API-Key: $TICKDB_API_KEY" \
  "https://api.tickdb.ai/v1/market/ticker?symbols=AAPL.US,700.HK,600519.SH&type=stock"
Python 股票歷史數據
import os
import requests

response = requests.get(
    "https://api.tickdb.ai/v1/market/kline",
    headers={"X-API-Key": os.environ["TICKDB_API_KEY"]},
    params={
        "symbol": "600519.SH", "type": "stock",
        "interval": "1d", "limit": 100, "adjust": "forward",
    },
    timeout=15,
)
response.raise_for_status()
result = response.json()
if result["code"] != 0:
    raise RuntimeError(result.get("message", "API error"))
print(result["data"])
WebSocket 股票行情推送
import asyncio
import json
import os
from urllib.parse import urlencode
import websockets

async def main():
    query = urlencode({"api_key": os.environ["TICKDB_API_KEY"]})
    async with websockets.connect(
        "wss://api.tickdb.ai/v1/realtime?" + query
    ) as ws:
        await ws.send(json.dumps({
            "cmd": "subscribe",
            "data": {
                "channel": "ticker", "type": "stock",
                "symbols": ["AAPL.US", "700.HK", "600519.SH"],
            },
        }))
        async for message in ws:
            print(json.loads(message))

asyncio.run(main())

方案與資料權限

試用範圍與付費權限不同。請先確認目標標的、歷史範圍、訂閱額度,以及買賣盤和逐筆成交權限。對外展示或再散布資料時,需另行確認合約與授權範圍。

免費版為精選品種的 7 天試用,可體驗報價與允許的 K 線查詢;不能用 start_time/end_time 指定歷史範圍。盤口、成交及指定歷史範圍需要相應權限,具體標的與額度以目前套餐為準。

查看方案與資料權限

典型使用場景

量化研究與選股

結合股票目錄、行情快照和歷史 K 線建立觀察池,計算動量與波動率等指標,按市場權限擴展掃描範圍。

策略回測

使用歷史股票價格與復權資料驗證策略,記錄缺失資料、交易日及查詢時點,避免將目前目錄當作歷史成分股名單。

交易所行情系統

為行情展示、價格參考及跨市場監控提供資料。此處提供行情能力,不含訂單撮合或下單;對外展示與再分發範圍需按合約和授權確認。

行情看板與觀察清單

以行情快照顯示股價,透過報價更新維護跨市場觀察清單;同時顯示報價時間,依標的涵蓋範圍與帳戶權限選擇資料。

常見問題

股票 API 支援哪些市場?

覆蓋 A 股、美股和港股。三地市場品類合計超過 25,000 個標的,統計可能包含 ETF、債券等非普通股產品,不能視為純股票數量或免費可存取數量。

如何透過 Python 取得股票行情?

使用 Python requests 攜帶 X-API-Key 請求 /v1/market/ticker,並傳入 AAPL.US、700.HK、600519.SH 等代碼。持續更新可訂閱 WebSocket ticker;範例標的是否可存取取決於帳戶權限。

REST 和 WebSocket 股票 API 如何選擇?

REST 適合按需查詢行情快照和歷史 K 線;WebSocket 適合持續接收價格、盤口和成交更新。訂閱額度、頻道和資料範圍按方案確定,全市場推送需對應市場方案權限。

如何查詢歷史 K 線?

K 線支援 1m、3m、5m、15m、30m、1h、2h、4h、1d、1w、1M 週期;小寫 m 是分鐘,大寫 M 是月。start_time/end_time 使用毫秒,預設回傳 100 條、最多 1000 條。最後一根可能仍在形成,歷史範圍受權限和資料可用性限制。

股票 K 線支援哪些復權方式?

A 股、港股與美股均支援 adjust=none(預設不復權)、forward(前復權)和 backward(後復權)。歸檔或回測應記錄查詢時間與復權方式;復權歷史價格可能隨公司行動或資料更新調整。

是否提供免費股票 API 試用?

免費版為精選品種的 7 天試用,可體驗報價與允許的 K 線查詢;不能用 start_time/end_time 指定歷史範圍。盤口、成交及指定歷史範圍需要相應權限,具體標的與額度以目前套餐為準。

股票 API 是否提供下單或撮合功能?

為行情展示、價格參考及跨市場監控提供資料。此處提供行情能力,不含訂單撮合或下單;對外展示與再分發範圍需按合約和授權確認。

立即開始接入即時行情數據

註冊即可獲得免費 API Key,WebSocket 即時推送,幾分鐘內完成接入