Get Option Details · Whale Docs

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

010110210510610710811011111212012112220120220320420520620710011002100310041005100610071008100910101011

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

012345611121314151617203132333435

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

Request

let request = WhaleCoreHTTPRequest(
    method: .get,
    path: "/v2/quote/option/detail"
)
request.query = [
    "counter_id": "OP/US/AAPL260724C110000"
]

let response = try await WhaleCoreService.requestService.send(request)
print(response.bodyString)

Response Example

{
  "code": 0,
  "message": "success",
  "data": {
    "trade_status": 204,
    "timestamp": "1784836800",
    "last_done": "208.95",
    "open": "",
    "high": "",
    "low": "",
    "prev_close": "208.95",
    "amount": "0",
    "balance": "",
    "day_to_expire": "1",
    "strike_price": "110",
    "expire_date": "20260724",
    "open_interest": "1",
    "contract_multiplier": "100",
    "contract_type": "A",
    "contract_size": "100",
    "implied_volatility": "3.323",
    "bid_depths": [
      {
        "price_level": 1,
        "count": "0",
        "volume": "6",
        "price": "209.55"
      }
    ],
    "ask_depths": [
      {
        "price_level": 1,
        "count": "0",
        "volume": "17",
        "price": "213.35"
      }
    ],
    "tpl": 20,
    "stock_name": "AAPL 260724 110 Call",
    "direction": "C",
    "underlying_counter_id": "ST/US/AAPL",
    "historical_volatility": "0.3730",
    "dividend_to_expire": "0",
    "sub_status": 10800,
    "sub_market": "USOP",
    "tags": [
      "Web|USOP|Global|LV1"
    ],
    "counter_id": "OP/US/AAPL260724C110000",
    "exchange": "OPRA",
    "channel_info": {},
    "stock_derivatives": [
      "OP"
    ],
    "currency": "USD",
    "standard_attr": "S",
    "status_desc": {
      "status_desc": "Closed 07.23 16:00:00 EDT",
      "append_market_time": false,
      "is_holiday": false
    },
    "extend_quote": null,
    "exercise_settlement": "",
    "asset_type": ""
  }
}