美股及墨西哥股票数据接口文档

概述

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 阅读(11) 评论(0) 收藏举报

刷新页面返回顶部

CryptoRzz

美股及墨西哥股票数据接口文档

概述

交易所信息

美国市场

墨西哥市场

核心功能接口

1. 实时行情数据

获取美股列表

获取墨西哥股票列表

2. 主要指数数据

获取美股主要指数

获取墨西哥主要指数

3. 个股查询功能

查询特定股票

批量查询多个股票

4. K线数据（技术分析）

获取股票K线数据

5. 涨跌排行榜

获取美股排行榜

获取墨西哥股票排行榜

6. 公司基本信息

获取美国上市公司信息

获取墨西哥上市公司信息

7. 技术指标数据

8. 基本面数据

9. WebSocket 实时数据

连接WebSocket

实时数据格式

市场特色

美股市场特点

主要交易所

交易机制

主要板块

墨西哥市场特点

主要交易所

市场特色

主要行业

使用示例

获取S&P 500成分股

获取墨西哥IPC指数成分股

跨市场比较查询

分交易所获取股票

获取实时指数数据

行业分类查询

获取特定行业股票

获取金融板块股票

数据更新频率

错误处理

最佳实践

美股数据使用建议

墨西哥数据使用建议

跨市场策略

注意事项

美股注意事项

墨西哥市场注意事项

技术实现注意事项

公告