美股市场涨跌榜 · REST 接口

美股涨跌幅榜。给出美股涨幅或跌幅最大的 20 个标的：涨幅榜按相对前收盘涨幅最大排序，跌幅榜反之。为保证参考意义，仅纳入成交量不低于 10000 的标的。快照数据每日美东时间 3:30 清空并随交易所上报逐步回填。

GET /v2/snapshot/locale/us/markets/stocks/{direction}

上游时效说明

延迟 15 分钟或实时

上游历史范围

该接口不适用

适用场景

涨跌幅榜识别、交易策略、市场情绪分析、组合调整。

接入地址与凭据以实际开通时下发为准。下面是上游字段定义与响应示例，文档收录不等于本站已开放全部能力。

查询参数

参数	类型	必填	说明
`direction`	string	Yes	快照结果的返回方向。
`include_otc`	boolean	No	是否在响应中包含场外（OTC）证券。默认为 false，即不含 OTC 证券。

响应字段

字段	类型	说明
`status`	string	本次请求响应的状态。
`tickers`	array[object]	指定标的的快照数据数组。
`tickers[].day`	object	该标的最新日线。
`tickers[].fmv`	number	Massive 的公允市场价值由其专有算法计算，提供可交易证券的实时估计公允价。上游仅向 Business 套餐提供；本站能否提供该数据，以实际开通清单为准。
`tickers[].lastQuote`	object	该标的最新报价。仅当当前套餐包含报价数据时才会返回。
`tickers[].lastTrade`	object	该标的最新一笔成交。仅当当前套餐包含成交数据时才会返回。
`tickers[].min`	object	该标的最新分钟线。
`tickers[].prevDay`	object	该标的前一日 K 线。
`tickers[].ticker`	string	该标的在交易所使用的交易代码。
`tickers[].todaysChange`	number	相对前一日的变动值。
`tickers[].todaysChangePerc`	number	相对前一日的涨跌幅。
`tickers[].updated`	integer	最后更新时间戳。

响应示例

{
  "status": "OK",
  "tickers": [
    {
      "day": {
        "c": 14.2284,
        "dv": "133963.0",
        "h": 15.09,
        "l": 14.2,
        "o": 14.33,
        "v": 133963,
        "vw": 14.5311
      },
      "lastQuote": {
        "P": 14.44,
        "S": 11,
        "p": 14.2,
        "s": 25,
        "t": 1605195929997325600
      },
      "lastTrade": {
        "c": [
          63
        ],
        "ds": "536.0",
        "i": "79372124707124",
        "p": 14.2284,
        "s": 536,
        "t": 1605195848258266000,
        "x": 4
      },
      "min": {
        "av": 133963,
        "c": 14.2284,
        "dav": "133963.0",
        "dv": "6108.0",
        "h": 14.325,
        "l": 14.2,
        "n": 5,
        "o": 14.28,
        "t": 1684428600000,
        "v": 6108,
        "vw": 14.2426
      },
      "prevDay": {
        "c": 0.73,
        "h": 0.799,
        "l": 0.73,
        "o": 0.75,
        "v": 1568097,
        "vw": 0.7721
      },
      "ticker": "PDS",
      "todaysChange": 13.498,
      "todaysChangePerc": 1849.096,
      "updated": 1605195848258266000
    }
  ]
}

原文：Massive 文档 ↗

美股 市场涨跌榜 · REST 接口

适用场景

查询参数

响应字段

响应示例

美股市场涨跌榜 · REST 接口