美股 (US) 与 墨西哥 (Mexico) 股票数据接口集成指南

1. 接入概述 (General)

本接口用于获取美国（NYSE, NASDAQ, AMEX）及墨西哥（BMV, BIVA）证券市场的实时行情、历史 K 线及指数数据。

• API Base URL: https://api.stocktv.top
  
• WebSocket URL: wss://ws-api.stocktv.top/connect
  
• 鉴权方式: 所有请求均需携带 URL 参数 key=您的API密钥
  

1.1 关键市场 ID (Country ID)

在调用相关接口时，请务必区分以下 countryId：
市场名称Country ID交易所示例美国 (USA)5NYSE (1), NASDAQ (2), AMEX墨西哥 (Mexico)7Mexico (53), BIVA (144)2. 核心数据接口

2.1 获取股票列表 (Stock List)

用于查询指定市场的股票清单，获取股票的名称、代码 (Symbol) 和 系统 ID (PID)。

注意：id (PID) 是后续查询 K 线和订阅 WebSocket 的唯一标识符。

• 接口地址: /stock/stocks
  
• 请求方式: GET
  
• 请求参数:
  

参数名类型必填说明keyString是您的 API KeycountryIdInt是5 (美股) 或 7 (墨西哥)pageSizeInt否每页数量 (默认 10)pageInt否页码 (默认 1)

• 请求示例 (获取美股列表):
  1. GET https://api.stocktv.top/stock/stocks?countryId=5&pageSize=20&page=1&key=YOUR_KEY

  复制代码
• 响应示例:
  1. {
  2.   "code": 200,
  3.   "data": {
  4.     "records": [
  5.       {
  6.         "id": 8888,          // [关键] PID，用于K线接口
  7.         "name": "Apple Inc", // 股票名称
  8.         "symbol": "AAPL",    // 股票代码
  9.         "exchangeId": 2,     // 交易所ID (2=NASDAQ)
  10.         "last": 180.5,       // 最新价
  11.         "chgPct": 1.25,      // 涨跌幅%
  12.         "countryNameTranslated": "United States"
  13.       }
  14.     ]
  15.   }
  16. }

  复制代码

2.2 获取 K 线数据 (Candlestick Data)

获取指定股票的历史行情数据，支持多种时间周期。

• 接口地址: /stock/kline
  
• 请求方式: GET
  
• 请求参数:
  

参数名类型必填说明keyString是您的 API KeypidInt是股票系统 ID (通过 2.1 接口获取)intervalString是K线周期 (ISO 8601格式)

• 周期 (Interval) 说明:
  
  
  
  • PT1M (1分钟), PT5M (5分钟), PT15M (15分钟), PT30M (30分钟), PT1H (1小时)
    
  • P1D (日线), P1W (周线), P1M (月线)
    
  
  
• 请求示例 (获取墨西哥某股票日线):
  1. GET https://api.stocktv.top/stock/kline?pid=12345&interval=P1D&key=YOUR_KEY

  复制代码
• 响应示例:
  1. {
  2.   "code": 200,
  3.   "data": [
  4.     {
  5.       "time": 1719818400000, // 时间戳 (毫秒)
  6.       "open": 150.0,
  7.       "high": 155.0,
  8.       "low": 149.0,
  9.       "close": 153.0,
  10.       "volume": 200000
  11.     }
  12.   ]
  13. }

  复制代码

2.3 获取大盘指数 (Indices)

获取美股（如纳斯达克、标普500）或墨西哥（如 S&/BMV IPC）的指数行情。

• 接口地址: /stock/indices
  
• 请求方式: GET
  
• 请求参数: countryId (5=美国, 7=墨西哥)
  
• 请求示例:
  1. GET https://api.stocktv.top/stock/indices?countryId=7&key=YOUR_KEY

  复制代码

3. WebSocket 实时推送

通过 WebSocket 长连接接收实时报价更新。

• 连接地址: wss://ws-api.stocktv.top/connect?key=YOUR_KEY
  
• 心跳机制: 连接建立后，建议定期发送心跳包以保持连接。
  
• 推送数据结构:
  1. {
  2.     "pid": "8888",         // 对应 Rest API 中的 id
  3.     "last_numeric": 181.2, // 最新价
  4.     "pcp": "0.39",         // 涨跌幅%
  5.     "timestamp": "1717728251",
  6.     "bid": "181.1",        // 买价
  7.     "ask": "181.3",        // 卖价
  8.     "type": 1              // 1=股票, 2=指数
  9. }

  复制代码

4. 接入代码示例 (JavaScript)

以下代码展示了如何根据 countryId 封装获取美股和墨西哥股票的逻辑。

1. const API_KEY = 'YOUR_API_KEY';
2. const BASE_URL = 'https://api.stocktv.top';
4. // 配置 ID
5. const MARKETS = {
6.     USA: 5,
7.     MEXICO: 7
8. };
10. /**
11. * 获取指定市场的股票列表
12. * @param {number} countryId - 5 for USA, 7 for Mexico
13. */
14. async function getMarketStocks(countryId) {
15.     const url = `${BASE_URL}/stock/stocks?countryId=${countryId}&pageSize=10&page=1&key=${API_KEY}`;
16.     try {
17.         const response = await fetch(url);
18.         const result = await response.json();
19.         
20.         if (result.code === 200) {
21.             console.log(`市场 (ID:${countryId}) 股票列表:`, result.data.records);
22.             // 示例：获取第一个股票的 PID 用于查 K 线
23.             if(result.data.records.length > 0) {
24.                 const firstStock = result.data.records[0];
25.                 console.log(`示例股票: ${firstStock.name}, PID: ${firstStock.id}`);
26.             }
27.         }
28.     } catch (error) {
29.         console.error('API 请求失败:', error);
30.     }
31. }
33. // 1. 获取美股数据
34. getMarketStocks(MARKETS.USA);
36. // 2. 获取墨西哥股票数据
37. getMarketStocks(MARKETS.MEXICO);

复制代码

来源：程序园用户自行投稿发布，如果侵权，请联系站长删除
免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！

用心讨论，共获提升！