Skip to content
Longport WhaleLongport Whale
Market Data

Get Option Details

Query detailed market data for a single option contract, including last price, bid/ask book, implied volatility, historical volatility, strike price, expiration date, open interest, etc., for use on the option details page.

GEThttps://api.lbkrs.com/v2/quote/option/detail

Parameters

counter_idstringqueryRequired

Option contract id

Responses

HTTP 200The request succeeded. The response body contains the result of the “Get option details” operation.
Standard response envelopecodemessagedata
dataobjectdata structure
trade_statusinteger

Trading status：

  • 0 - No market data (pending listing)
  • 101 - Liquidation state
  • 102 - Opening auction
  • 105 - Trading
  • 106 - Midday halt
  • 107 - Closing auction
  • 108 - Closed
  • 110 - Dark pool awaiting open
  • 111 - Dark pool trading
  • 112 - Dark pool closed
  • 120 - Fixed-price trade
  • 121 - Half-day market closed
  • 122 - Not opened
  • 201 - US pre-market
  • 202 - US trading
  • 203 - US post-market
  • 204 - US closed
  • 205 - US halted
  • 206 - US liquidation (including pre-market)
  • 207 - US night session
  • 1001 - Delisted
  • 1002 - Preparing for listing
  • 1003 - Code change
  • 1004 - Suspended
  • 1005 - Awaiting open
  • 1006 - Trading paused for split/consolidation
  • 1007 - Expired/not listed
  • 1008 - No price
  • 1009 - Not listed
  • 1010 - Terminated trading
  • 1011 - Waiting to list
Values
0
101
102
105
106
107
108
110
111
112
120
121
122
201
202
203
204
205
206
207
1001
1002
1003
1004
1005
1006
1007
1008
1009
1010
1011
timestampstring

Timestamp

last_donestring

Last price

openstring

Open price

highstring

High price

lowstring

Low price

prev_closestring

Previous close

amountstring

Volume

balancestring

Turnover

day_to_expirestring

Days to expiration (excluding holidays/weekends)

strike_pricestring

Strike price

expire_datestring

Expiration date

open_intereststring

Open interest

contract_multiplierstring

Contract multiplier

contract_typestring

Option type

contract_sizestring

Contract size

implied_volatilitystring

Implied volatility

bid_depthsarray<object>

Bid depth

Child attributes
price_levelinteger

Order book tier (level index)

countstring

Order book queued volume (currently unused)

volumestring

Order book buy/sell volume

pricestring

Order book price

ask_depthsarray<object>

Ask depth

Child attributes
price_levelinteger

Order book tier (level index)

countstring

Order book queued volume (currently unused)

volumestring

Order book buy/sell volume

pricestring

Order book price

tplinteger

Equity/security template：

  • 0 - Unknown
  • 1 - Stock
  • 2 - ETF
  • 3 - DLC
  • 4 - Index
  • 5 - LB industry sector
  • 6 - LB concept sector
  • 11 - Filed (submitted)
  • 12 - Pending listing
  • 13 - Dark pool today
  • 14 - IPO today
  • 15 - LB custom security
  • 16 - Security without market data
  • 17 - Sector without market data
  • 20 - Option
  • 31 - Warrant
  • 32 - Bull/Bear certificate
  • 33 - Structured note
  • 34 - US-linked security template
  • 35 - Virtual asset
Values
0
1
2
3
4
5
6
11
12
13
14
15
16
17
20
31
32
33
34
35
stock_namestring

Option name

directionstring

Direction：

  • C - Call
  • P - Put
underlying_counter_idstring

Counter_id of the underlying stock

historical_volatilitystring

Historical volatility

dividend_to_expirestring

Cumulative dividend amount before expiration

sub_statusinteger

Sub-status

sub_marketstring

Sub-market

tagsarray<string>

Tags

counter_idstring

Option contract id

exchangestring

Exchange

channel_infoobject

Channel messages, key is the channel identifier

stock_derivativesarray<string>

Derivatives supported by the underlying stock

currencystring

Currency

standard_attrstring

Standard attribute：

  • S - Standard option
  • N - Non-standard option (adjusted options generated after corporate actions such as stock splits/mergers; Broker App labels as Old)
status_descobject

Trading status description information

Child attributes
status_descstring

Status description text

append_market_timeboolean

Requires additional market time

is_holidayboolean

Is closed for holidays

extend_quoteobject

Extended session market data

Child attributes
last_donestring

Last price

prev_closestring

Previous close

highstring

High price

lowstring

Low price

amountstring

Volume

balancestring

Turnover

timestampstring

Timestamp

ivstring

Implied volatility

trade_sessioninteger

Trading session

exercise_settlementstring

Exercise settlement window：

  • AM - Morning settlement
  • PM - Afternoon settlement
  • "" - Not applicable
asset_typestring

Asset type

Whale Docs