跳到主要內容

获取标的实时行情

该接口用于获取标的的实时行情 (支持所有类型标的）。

SDK Links

Python
longport.openapi.QuoteContext.quote
Rust
longport::quote::QuoteContext#quote
Go
QuoteContext.Quote
Node.js
QuoteContext#quote
信息

业务指令：11

Request​

Parameters​

NameTypeRequiredDescription
symbolstring[]是标的代码列表，使用 ticker.region 格式，例如：[700.HK]

校验规则：
每次请求支持传入的标的数量上限是 500 个

Protobuf​

message MultiSecurityRequest {
  repeated string symbol = 1;
}

Request Example​

# 获取标的实时行情
# https://open.longportapp.com/docs/quote/pull/quote
# 运行前请访问“开发者中心”确保账户有正确的行情权限。
# 如没有开通行情权限，可以通过“LongPort”手机客户端，并进入“我的 - 我的行情 - 行情商城”购买开通行情权限。
from longport.openapi import QuoteContext, Config

config = Config.from_env()
ctx = QuoteContext(config)

resp = ctx.quote(["700.HK", "AAPL.US", "TSLA.US", "NFLX.US"])
print(resp)

Response​

Response Properties​

NameTypeDescription
secu_quoteobject[]标的实时行情数据列表
∟ symbolstring标的代码
∟ last_donestring最新价
∟ prev_closestring昨收价
∟ openstring开盘价
∟ highstring最高价
∟ lowstring最低价
∟ timestampint64最新成交的时间戳
∟ volumeint64成交量
∟ turnoverstring成交额
∟ trade_statusint32标的交易状态，详见 TradeStatus
∟ pre_market_quoteobject美股盘前交易行情
∟∟ last_donestring最新价
∟∟ timestampint64最新成交的时间戳
∟∟ volumeint64成交量
∟∟ turnoverstring成交额
∟∟ highstring最高价
∟∟ lowstring最低价
∟∟ prev_closestring上一个交易阶段的收盘价
∟ post_market_quoteobject美股盘后交易行情
∟∟ last_donestring最新价
∟∟ timestampint64最新成交的时间戳
∟∟ volumeint64成交量
∟∟ turnoverstring成交额
∟∟ highstring最高价
∟∟ lowstring最低价
∟∟ prev_closestring上一个交易阶段的收盘价
∟ overnight_quoteobject美股夜盘交易行情

注意：需开启 enable_overnight 参数，否则会返回 null
∟∟ last_donestring最新价
∟∟ timestampint64最新成交的时间戳
∟∟ volumeint64成交量
∟∟ turnoverstring成交额
∟∟ highstring最高价
∟∟ lowstring最低价
∟∟ prev_closestring上一个交易阶段的收盘价

注意​

overnight_quote 参数细节​

只有当我们在配置的时候开启了 enable_overnight 参数，才会返回 overnight_quote 字段。

config = Config(
    app_key="your_app_key",
    app_secret="your_app_secret",
    access_token="your_access_token",
    enable_overnight=True)

或者设置环境变量 LONGPORT_ENABLE_OVERNIGHT 为 true。

Protobuf​

message SecurityQuoteResponse {
  repeated SecurityQuote secu_quote = 1;
}

message SecurityQuote {
  string symbol = 1;
  string last_done = 2;
  string prev_close = 3;
  string open = 4;
  string high = 5;
  string low = 6;
  int64 timestamp = 7;
  int64 volume = 8;
  string turnover = 9;
  TradeStatus trade_status = 10;
  PrePostQuote pre_market_quote = 11;
  PrePostQuote post_market_quote = 12;
}

message PrePostQuote {
  string last_done = 1;
  int64 timestamp = 2;
  int64 volume = 3;
  string turnover = 4;
  string high = 5;
  string low = 6;
  string prev_close = 7;
}

Response JSON Example​

{
  "secu_quote": [
    {
      "symbol": "700.HK",
      "last_done": "338.000",
      "prev_close": "334.800",
      "open": "340.600",
      "high": "340.600",
      "low": "333.000",
      "timestamp": 1651115955,
      "volume": 7310881,
      "turnover": "2461463161.000"
    },
    {
      "symbol": "AAPL.US",
      "last_done": "156.570",
      "prev_close": "156.800",
      "open": "155.910",
      "high": "159.790",
      "low": "155.380",
      "timestamp": 1651089600,
      "volume": 88063191,
      "turnover": "13865092584.000",
      "pre_market_quote": {
        "last_done": "155.880",
        "timestamp": 1651066201,
        "volume": 1575504,
        "turnover": "246653442.000",
        "high": "158.400",
        "low": "155.100",
        "prev_close": "156.800"
      },
      "post_market_quote": {
        "last_done": "158.770",
        "timestamp": 1651103995,
        "volume": 6188441,
        "turnover": "970874184.759",
        "high": "159.400",
        "low": "156.400",
        "prev_close": "156.570"
      }
    }
  ]
}

接口限制​

警告
  • 港股 BMP 行情，超过 20 支的港股标的将响应延迟行情。

错误码​

协议错误码业务错误码描述排查建议
3301600无效的请求请求参数有误或解包失败
3301606限流降低请求频次
7301602服务端内部错误请重试或联系技术人员处理
7301607接口限制请求的标的数量超限，请减少单次请求标的数量