在構建全球化資產配置工具或交易系統時，數據的實時性、準確性以及覆蓋面是核心競爭力。本文將介紹如何通過 StockTV API 快速接入全球多個主流市場的股票及期貨數據，重點講解如何利用 countryId 實現多國切換，並集成特色的 IPO 追蹤功能。

一、 核心架構與接入準備

StockTV 採用標準的 RESTful 架構，並提供 WebSocket 協議支持高頻行情推送。

• API 基礎路徑：https://api.stocktv.top
• 認證方式：所有請求需在 URL 參數中攜帶 key=YOUR_KEY。
• 數據格式：統一的 JSON 格式，方便前端與後端快速解析。

二、 關鍵參數：通過 countryId 路由全球市場

StockTV 的最大特點是“一套代碼，全球接入”。通過修改 countryId 參數，您可以無縫切換不同國家的市場數據：

三、 核心功能模塊實現

1. 實時行情：股票列表與指數

獲取特定國家的所有股票最新成交價、漲跌幅及成交量。

• 接口：/stock/stocks

• 代碼示例 (Python)：

  import requests
  # 以印度市場 (countryId=14) 為例
  url = "https://api.stocktv.top/stock/stocks?countryId=14&key=YOUR_KEY"
  data = requests.get(url).json()
  # 核心字段：last (最新價), chgPct (漲跌幅), volume (成交量)
  

2. 獨家功能：IPO 新股日曆

對於打新投資者或基本面分析工具，IPO 數據是極具價值的。StockTV 提供了完整的 IPO 日曆。

• 接口：/stock/getIpo
• 功能説明：
• type=1：未上市新股（預警/申購期）。
• type=2：已上市新股（上市首日表現）。
• 字段亮點：ipoListing (上市日期)、ipoPrice (發行價)、company (公司背景)。

3. K 線數據：專業圖表支持

支持分時、日線、周線等多種週期（PT1M, PT1H, P1D 等），滿足 TradingView 等圖表的渲染需求。

• 接口：/stock/kline 或 /futures/kline
• 輸出：標準 OHLC（開盤、最高、最低、收盤）及成交量。

四、 黃金、白銀及全球期貨對接

除了股票，避險資產（貴金屬）和能源期貨也是金融平台的標配。

• 重點品種：倫敦金 (XAU)、倫敦銀 (XAG)、原油 (WTI/Brent)。
• 實時接口：/futures/market
• 優勢：提供買一/賣一價 (Bid/Ask)，適合展示高精度的差價合約行情。

五、 技術優勢與開發者支持

1. 極簡接入：無需針對每個國家編寫複雜的解析邏輯，字段高度統一。
2. 低延遲推送：支持 WebSocket (WS) 接入，實現毫秒級的盤面跳動。
3. 深度調研：提供 /stock/companies 接口，涵蓋公司所屬行業、板塊及詳細業務描述，助力基本面分析。

六、 獲取測試授權

如果您正在開發量化系統、行情 App 或金融資訊站，可以聯繫技術團隊獲取免費測試 Key

結語：全球資產配置的時代，高效的數據源就是開發者的“倍增器”。通過對接 StockTV API，僅需簡單的 countryId 參數調整，即可讓您的應用具備橫跨亞、美、拉美三大洲的實時金融追蹤能力。立即動手，開啓您的全球行情開發之旅！