歐美（美股、加拿大股票、墨西哥股票）股票數據接口文檔

概述

StockTV 提供全面的歐美股票市場數據接口，覆蓋美國、加拿大、墨西哥等主要歐美市場。支持實時行情、技術分析、公司信息等多種功能。

國家與交易所對應關系

美國市場

NYSE (紐約證券交易所): 交易所ID 1
NASDAQ (納斯達克): 交易所ID 2

加拿大市場

Toronto (多倫多交易所): 交易所ID 51
TSXV (多倫多創業板): 交易所ID 108
CSE (加拿大證券交易所): 交易所ID 109

墨西哥市場

Mexico (墨西哥交易所): 交易所ID 53
BIVA (墨西哥 Institutional Stock Exchange): 交易所ID 144

核心功能接口

1. 實時行情數據

獲取美國股票列表

GET /stock/stocks?countryId=5&pageSize=50&page=1&key=您的API_KEY

獲取加拿大股票列表

GET /stock/stocks?countryId=6&pageSize=50&page=1&key=您的API_KEY

獲取墨西哥股票列表

GET /stock/stocks?countryId=7&pageSize=50&page=1&key=您的API_KEY

參數說明:

countryId: 國家ID (美國=5, 加拿大=6, 墨西哥=7)
exchangeId: 交易所ID (可選)
pageSize: 每頁數量
page: 頁碼

響應示例 (美股):

{
  "code": 200,
  "message": "操作成功",
  "data": {
    "records": [
      {
        "id": 12345,
        "symbol": "AAPL",
        "name": "Apple Inc",
        "last": 182.63,
        "chg": 1.25,
        "chgPct": 0.69,
        "high": 183.45,
        "low": 181.20,
        "volume": 28563420,
        "open": true,
        "exchangeId": 2,
        "fundamentalMarketCap": 2860000000000,
        "fundamentalRevenue": "383.29B",
        "time": 1716448222
      }
    ],
    "total": 8000,
    "current": 1,
    "pages": 160
  }
}

2. 主要指數數據

獲取歐美主要指數

GET /stock/indices?countryId=1&key=您的API_KEY

包含指數:

美國: S&P 500, Dow Jones, NASDAQ Composite, Russell 2000
加拿大: S&P/TSX Composite
墨西哥: S&P/BMV IPC

指數數據示例:

{
  "id": 1001,
  "name": "S&P 500",
  "symbol": "SPX",
  "last": 5234.18,
  "chg": 45.32,
  "chgPct": 0.87,
  "high": 5241.65,
  "low": 5189.43,
  "isOpen": true,
  "time": 1716458537
}

3. 個股查詢功能

查詢特定股票

GET /stock/queryStocks?symbol=AAPL&key=您的API_KEY

批量查詢多個股票

GET /stock/stocksByPids?key=您的API_KEY&pids=12345,67890,54321

支持查詢方式:

id: 股票PID
symbol: 股票代碼 (AAPL, TSLA, MSFT等)
name: 股票名稱
url: 詳情頁鏈接

4. K線數據（技術分析）

獲取股票K線數據

GET /stock/kline?pid=12345&interval=PT1H&key=您的API_KEY

時間間隔參數:

PT5M - 5分鐘
PT15M - 15分鐘
PT1H - 1小時
PT5H - 5小時
P1D - 1天
P1W - 1周
P1M - 1月

K線數據格式:

{
  "time": 1719818400000,
  "open": 182.15,
  "high": 182.80,
  "low": 181.95,
  "close": 182.63,
  "volume": 125000,
  "vo": 22828750
}

5. 公司基本信息

獲取歐美公司信息

GET /stock/companies?countryId=1&pageSize=20&page=1&key=您的API_KEY

公司信息包含:

公司名稱和描述
所屬行業和板塊
員工人數
市值和收入數據

6. 技術指標數據

包含的技術指標:

technicalDay: 日線技術指標
technicalHour: 小時線技術指標
technicalWeek: 周線技術指標
technicalMonth: 月線技術指標

技術指標值:

strong_buy: 強烈買入
buy: 買入
neutral: 中性
sell: 賣出
strong_sell: 強烈賣出

7. 基本面數據

包含的基本面指標:

fundamentalBeta: Beta值
fundamentalMarketCap: 市值
fundamentalRevenue: 收入
fundamentalRatio: 基本面比率
performanceDay: 當日表現
performanceWeek: 周表現
performanceMonth: 月表現
performanceYtd: 年初至今表現

8. WebSocket 實時數據

連接WebSocket

const wsUri = "wss://ws-api.stocktv.top/connect?key=您的API_KEY";
const websocket = new WebSocket(wsUri);

實時數據格式

{
  "pid": "12345",
  "last_numeric": "182.63",
  "bid": "182.60",
  "ask": "182.65",
  "high": "183.45",
  "low": "181.20",
  "last_close": "181.38",
  "pc": "1.25",
  "pcp": "0.69",
  "turnover_numeric": "28563420",
  "time": "16:00:05",
  "timestamp": "1717728251",
  "type": 1
}

特色功能

1. 多交易所支持

同時支持NYSE、NASDAQ等主要交易所
實時同步交易所數據
支持盤前盤后交易數據

2. 技術分析數據

多種時間周期的K線數據
實時技術指標計算
專業的技術分析信號

3. 基本面數據

實時市值和財務數據
公司基本信息
行業分類數據

4. 高性能實時數據

秒級數據更新
低延遲WebSocket連接
批量數據查詢支持

使用示例

獲取蘋果公司(AAPL)實時數據

GET /stock/queryStocks?symbol=AAPL&key=您的API_KEY

獲取S&P 500指數成分股

GET /stock/stocks?countryId=1&pageSize=500&key=您的API_KEY

實時監控多個科技股

GET /stock/stocksByPids?key=您的API_KEY&pids=12345,67890,54321,98765

數據更新頻率

實時行情: 秒級更新
K線數據: 按選擇間隔實時更新
指數數據: 實時更新
公司信息: 每日更新
基本面數據: 實時更新

錯誤處理

{
  "code": 400,
  "message": "參數錯誤",
  "data": null
}

常見錯誤代碼:

200: 操作成功
400: 參數錯誤
401: API Key無效
404: 數據不存在
500: 服務器內部錯誤

最佳實踐

批量查詢: 使用stocksByPids接口批量獲取數據，減少API調用次數
WebSocket連接: 對于實時性要求高的場景，使用WebSocket連接
緩存策略: 對公司信息等變化不頻繁的數據實施緩存
錯誤重試: 實現適當的錯誤重試機制

posted @ 2025-10-13 15:05 CryptoRzz 閱讀(32) 評論(0) 收藏舉報

刷新頁面返回頂部

CryptoRzz