跳到主要內容

獲取標的基礎信息

該接口用於獲取標的的基礎信息。

SDK Links

Python
longport.openapi.QuoteContext.static_info
Rust
longport::quote::QuoteContext#static_info
Go
QuoteContext.StaticInfo
Node.js
QuoteContext#staticInfo
信息

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/static
# 運行前請訪問“開發者中心“確保賬戶有正確的行情權限。
# 如沒有開通行情權限,可以通過“LongPort”手機客戶端,並進入“我的 - 我的行情 - 行情商城”購買開通行情權限。
from longport.openapi import QuoteContext, Config

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

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

Response

Response Properties

NameTypeDescription
secu_static_infoobject[]標的基礎數據列表
∟ symbolstring標的代碼
∟ name_cnstring中文簡體標的名稱
∟ name_enstring英文標的名稱
∟ name_hkstring中文繁體標的名稱
∟ exchangestring標的所屬交易所
∟ currencystring交易幣種

可選值:
CNY
USD
SGD
HKD
∟ lot_sizeint32每手股數
∟ total_sharesint64總股本
∟ circulating_sharesint64流通股本
∟ hk_sharesint64港股股本 (僅港股)
∟ epsstring每股盈利
∟ eps_ttmstring每股盈利 (TTM)
∟ bpsstring每股淨資產
∟ dividend_yieldstring股息
∟ stock_derivativesint32[]如果標的是正股,可提供的衍生品行情類型

可選值:
1 - 期權
2 - 輪證
∟ boardstring標的所屬板塊,詳見 Board

Protobuf

message SecurityStaticInfoResponse {
repeated StaticInfo secu_static_info = 1;
}

message StaticInfo {
string symbol = 1;
string name_cn = 2;
string name_en = 3;
string name_hk = 4;
string listing_date = 5;
string exchange = 6;
string currency = 7;
int32 lot_size = 8;
int64 total_shares = 9;
int64 circulating_shares = 10;
int64 hk_shares = 11;
string eps = 12;
string eps_ttm = 13;
string bps = 14;
string dividend_yield = 15;
repeated int32 stock_derivatives = 16;
string board = 17;
}

Response JSON Example

{
"secu_static_info": [
{
"symbol": "700.HK",
"name_cn": "腾讯控股",
"name_en": "TENCENT",
"name_hk": "騰訊控股",
"exchange": "SEHK",
"currency": "HKD",
"lot_size": 100,
"total_shares": 9612464038,
"circulating_shares": 9612464038,
"hk_shares": 9612464038,
"eps": "28.4394",
"eps_ttm": "28.4394",
"bps": "103.40413",
"dividend_yield": "1.6",
"stock_derivatives": [2],
"board": "HKEquity"
},
{
"symbol": "AAPL.US",
"name_cn": "苹果",
"name_en": "Apple Inc.",
"exchange": "NASD",
"currency": "USD",
"lot_size": 1,
"total_shares": 1631944100,
"circulating_shares": 16302661350,
"eps": "5.669",
"eps_ttm": "6.0771",
"bps": "4.40197",
"dividend_yield": "0.85",
"stock_derivatives": [1],
"board": "USMain"
}
]
}

錯誤碼

協議錯誤碼業務錯誤碼描述排查建議
3301600無效的請求請求參數有誤或解包失敗
3301606限流降低請求頻次
7301602服務端內部錯誤請重試或聯繫技術人員處理
7301607接口限制請求的標的數量超限,請減少單次請求標的數量