美股及墨西哥股票數據接口文檔

概述

StockTV 提供全面的美國及墨西哥股票市場數據接口，覆蓋紐約證券交易所（NYSE）、納斯達克（NASDAQ）、墨西哥證券交易所（BMV）等主要交易所。支持實時行情、技術分析、公司信息等多種功能。

交易所信息

美國市場

NYSE (紐約證券交易所): 交易所ID 1
NASDAQ (納斯達克): 交易所ID 2
交易時間: 美東時間 09:30-16:00
貨幣: 美元 (USD)

墨西哥市場

墨西哥證券交易所 (BMV): 交易所ID 53
BIVA (墨西哥 Institutional Stock Exchange): 交易所ID 144
交易時間: 墨西哥時間 08:30-15:00
貨幣: 墨西哥比索 (MXN)

核心功能接口

1. 實時行情數據

獲取美股列表

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

獲取墨西哥股票列表

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

參數說明:

countryId: 國家ID (美國=1, 墨西哥=4)
exchangeId: 交易所ID (可選)
pageSize: 每頁數量
page: 頁碼

美股響應示例:

{
  "code": 200,
  "message": "操作成功",
  "data": {
    "records": [
      {
        "id": 1001,
        "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,
        "countryNameTranslated": "United States",
        "flag": "US",
        "fundamentalMarketCap": 2860000000000,
        "fundamentalRevenue": "383.29B",
        "time": 1716448222,
        "technicalDay": "buy",
        "performanceDay": 0.69,
        "performanceWeek": 2.15,
        "performanceMonth": 5.32
      }
    ],
    "total": 8000,
    "current": 1,
    "pages": 160
  }
}

墨西哥股票響應示例:

{
  "code": 200,
  "message": "操作成功",
  "data": {
    "records": [
      {
        "id": 2001,
        "symbol": "WALMEX",
        "name": "Wal-Mart de Mexico SAB de CV",
        "last": 68.45,
        "chg": 0.35,
        "chgPct": 0.51,
        "high": 68.80,
        "low": 67.90,
        "volume": 1250000,
        "open": true,
        "exchangeId": 53,
        "countryNameTranslated": "Mexico",
        "flag": "MX",
        "fundamentalMarketCap": 65000000000,
        "fundamentalRevenue": "25.4B",
        "time": 1716448222,
        "technicalDay": "neutral",
        "performanceDay": 0.51,
        "performanceWeek": 1.85,
        "performanceMonth": 4.67
      }
    ],
    "total": 150,
    "current": 1,
    "pages": 3
  }
}

2. 主要指數數據

獲取美股主要指數

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

獲取墨西哥主要指數

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

包含的主要指數:

美國: S&P 500, Dow Jones Industrial Average, NASDAQ Composite, Russell 2000
墨西哥: S&P/BMV IPC, FTSE BIVA

指數數據示例:

{
  "code": 200,
  "message": "操作成功",
  "data": [
    {
      "id": 101,
      "name": "S&P 500",
      "symbol": "SPX",
      "last": 5234.18,
      "chg": 45.32,
      "chgPct": 0.87,
      "high": 5241.65,
      "low": 5189.43,
      "isOpen": true,
      "flag": "US",
      "time": 1716458537
    },
    {
      "id": 401,
      "name": "S&P/BMV IPC",
      "symbol": "MXX",
      "last": 55230.45,
      "chg": 245.32,
      "chgPct": 0.45,
      "high": 55350.65,
      "low": 54980.43,
      "isOpen": true,
      "flag": "MX",
      "time": 1716458537
    }
  ]
}

3. 個股查詢功能

查詢特定股票

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

批量查詢多個股票

GET /stock/stocksByPids?key=您的API_KEY&pids=1001,2001,1002,2002

熱門美股代碼:

AAPL: Apple Inc
MSFT: Microsoft Corporation
GOOGL: Alphabet Inc (Google)
AMZN: Amazon.com Inc
TSLA: Tesla Inc
META: Meta Platforms Inc
NVDA: NVIDIA Corporation
JPM: JPMorgan Chase & Co

熱門墨西哥股票代碼:

WALMEX: Wal-Mart de Mexico
AMXL: America Movil
GFNORTE: Grupo Financiero Banorte
CEMEX: Cemex SAB de CV
FEMSA: Fomento Economico Mexicano
GMEXICO: Grupo Mexico
TLEVISA: Grupo Televisa

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

獲取股票K線數據

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

時間間隔參數:

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

K線數據格式:

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

5. 漲跌排行榜

獲取美股排行榜

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

獲取墨西哥股票排行榜

GET /stock/updownList?countryId=4&type=1&key=您的API_KEY

排行榜類型:

type=1: 漲幅榜
type=2: 跌幅榜
type=3: 成交額榜
type=4: 成交量榜

6. 公司基本信息

獲取美國上市公司信息

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

獲取墨西哥上市公司信息

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

7. 技術指標數據

包含的技術指標:

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

技術指標值:

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

8. 基本面數據

包含的基本面指標:

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

9. WebSocket 實時數據

連接WebSocket

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

實時數據格式

{
  "pid": "1001",
  "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
}

市場特色

美股市場特點

主要交易所

NYSE: 傳統藍籌股集中地
NASDAQ: 科技股和創新公司集中地

交易機制

T+2結算制度
盤前交易 (04:00-09:30 ET)
盤后交易 (16:00-20:00 ET)
漲跌幅無限制（但有熔斷機制）

主要板塊

科技板塊: FAANG股票 (Facebook, Apple, Amazon, Netflix, Google)
金融板塊: 銀行、保險、投資公司
醫療保健: 制藥、生物科技
消費品: 零售、消費品公司
工業: 制造業、航空航天

墨西哥市場特點

主要交易所

BMV (Bolsa Mexicana de Valores): 主要交易所
BIVA (Bolsa Institucional de Valores): 新興交易所

市場特色

拉丁美洲第二大股票市場
以比索計價交易
受美國經濟影響較大
大宗商品相關股票占比較高

主要行業

電信業: America Movil主導
零售業: Walmart de Mexico
金融業: 銀行和金融機構
材料業: 水泥、礦業公司
工業: 制造業公司

使用示例

獲取S&P 500成分股

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

獲取墨西哥IPC指數成分股

GET /stock/stocks?countryId=4&pageSize=35&key=您的API_KEY

跨市場比較查詢

GET /stock/stocksByPids?key=您的API_KEY&pids=1001,2001,1002,2002,1003,2003

分交易所獲取股票

GET /stock/stocks?countryId=1&exchangeId=2&pageSize=100&key=您的API_KEY

獲取實時指數數據

GET /stock/indicesById?id=101&key=您的API_KEY

行業分類查詢

獲取特定行業股票

GET /stock/queryStocks?industry=Technology&countryId=1&key=您的API_KEY

獲取金融板塊股票

GET /stock/queryStocks?sector=Financials&countryId=4&key=您的API_KEY

數據更新頻率

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

錯誤處理

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

常見錯誤代碼:

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

最佳實踐

美股數據使用建議

批量查詢: 使用stocksByPids接口批量獲取FAANG等科技股數據
盤前盤后: 注意交易時間，可獲取盤前盤后數據
行業分析: 利用行業分類進行板塊輪動分析
實時監控: 對高波動性股票使用WebSocket實時監控

墨西哥數據使用建議

貨幣轉換: 注意比索與美元的匯率轉換
本地化信息: 關注墨西哥本地經濟數據和政策
大宗商品關聯: 注意大宗商品價格對墨西哥股票的影響
美國市場聯動: 關注美股對墨西哥市場的傳導效應

跨市場策略

比較分析: 比較同類行業在不同市場的表現
匯率風險: 注意匯率波動對投資回報的影響
時區考慮: 考慮不同交易時間的重疊和影響
風險分散: 利用兩個市場的低相關性進行風險分散

注意事項

美股注意事項

交易時間: 注意美東時間與本地時區的差異
財報季節: 關注季度財報發布對股價的影響
美聯儲政策: 關注利率政策對市場的影響
期權到期日: 注意月度期權到期對市場波動的影響

墨西哥市場注意事項

政治風險: 關注墨西哥國內政治環境變化
匯率波動: 比索匯率波動對投資收益的影響
美國經濟: 美國經濟數據對墨西哥市場的傳導
大宗商品: 原油等大宗商品價格對相關股票的影響

技術實現注意事項

API限制: 注意API調用頻率限制
數據格式: 價格和交易量的數值格式化
錯誤處理: 實現完善的錯誤處理和重試機制
數據緩存: 對靜態數據實施適當的緩存策略

本文檔基于 StockTV API 生成，具體接口參數以最新官方文檔為準。美股和墨西哥股票數據實時更新，提供全面的市場覆蓋和深度的財務數據。

posted @ 2025-10-22 16:46 CryptoRzz 閱讀(22) 評論(0) 收藏舉報

刷新頁面返回頂部

CryptoRzz

美股及墨西哥股票數據接口文檔

概述

交易所信息

美國市場

墨西哥市場

核心功能接口

1. 實時行情數據

獲取美股列表

獲取墨西哥股票列表

2. 主要指數數據

獲取美股主要指數

獲取墨西哥主要指數

3. 個股查詢功能

查詢特定股票

批量查詢多個股票

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

獲取股票K線數據

5. 漲跌排行榜

獲取美股排行榜

獲取墨西哥股票排行榜

6. 公司基本信息

獲取美國上市公司信息

獲取墨西哥上市公司信息

7. 技術指標數據

8. 基本面數據

9. WebSocket 實時數據

連接WebSocket

實時數據格式

市場特色

美股市場特點

主要交易所

交易機制

主要板塊

墨西哥市場特點

主要交易所

市場特色

主要行業

使用示例

獲取S&P 500成分股

獲取墨西哥IPC指數成分股

跨市場比較查詢

分交易所獲取股票

獲取實時指數數據

行業分類查詢

獲取特定行業股票

獲取金融板塊股票

數據更新頻率

錯誤處理

最佳實踐

美股數據使用建議

墨西哥數據使用建議

跨市場策略

注意事項

美股注意事項

墨西哥市場注意事項

技術實現注意事項

公告