行情

盤口

WS請求 · cmd 14

該接口用於獲取標的的盤口數據。

message SecurityRequest {
  string symbol = 1;
}

message SecurityDepthResponse {
  string symbol = 1;
  repeated Depth ask = 2;
  repeated Depth bid = 3;
}
行情權限要求免費
  • 美股:預設免費贈送 US LV1 一檔買賣盤報價(含盤前、盤中、盤後、夜盤全時段)。
  • 港股:預設贈送 LV1 一檔買賣盤報價;十檔買賣盤需購買「LV2 高級行情 - Plus (OpenAPI)」行情卡。
  • 美股期權:預設無權限,需購買「OPRA 美股期權行情 (OpenAPI)」行情卡。

請求參數

名稱類型必填說明
symbolstring必填標的代碼,使用 ticker.region 格式,例如:700.HK

響應欄位

名稱類型必填說明
symbolstring可選標的代碼
askobject[]可選賣盤
└ positionint32可選檔位
└ pricestring可選價格
└ volumeint64可選掛單量
└ order_numint64可選訂單數量
bidobject[]可選買盤
└ positionint32可選檔位
└ pricestring可選價格
└ volumeint64可選掛單量
└ order_numint64可選訂單數量

響應 JSON 示例

{
  "symbol": "700.HK",
  "ask": [
    {
      "position": 1,
      "price": "335.000",
      "volume": 500,
      "order_num": 1
    }
  ],
  "bid": [
    {
      "position": 1,
      "price": "334.800",
      "volume": 69400,
      "order_num": 13
    }
  ]
}