Code Reference

AccountBalance

Account balance

buy_power: Decimal instance-attribute

Buy power

cash_infos: List[CashInfo] instance-attribute

Cash details

currency: str instance-attribute

Currency

init_margin: Decimal instance-attribute

Initial margin

maintenance_margin: Decimal instance-attribute

Maintenance margin

margin_call: Decimal instance-attribute

Margin call

max_finance_amount: Decimal instance-attribute

Maximum financing amount

net_assets: Decimal instance-attribute

Net assets

remaining_finance_amount: Decimal instance-attribute

Remaining financing amount

risk_level: int instance-attribute

Risk control level

total_cash: Decimal instance-attribute

Total cash

AdjustType

Candlestick adjustment type

ForwardAdjust

Bases: AdjustType

Adjust forward

NoAdjust

Bases: AdjustType

Actual

Brokers

Brokers

broker_ids: List[int] instance-attribute

Broker IDs

position: int instance-attribute

Position

CalcIndex

Calc index

Amplitude

Bases: CalcIndex

Amplitude

BalancePoint

Bases: CalcIndex

Breakeven point

CallPrice

Bases: CalcIndex

Call price

CapitalFlow

Bases: CalcIndex

Capital flow

ChangeRate

Bases: CalcIndex

Change rate

ChangeValue

Bases: CalcIndex

Change value

ConversionRatio

Bases: CalcIndex

Conversion ratio

Delta

Bases: CalcIndex

Delta

DividendRatioTtm

Bases: CalcIndex

Dividend ratio (TTM)

EffectiveLeverage

Bases: CalcIndex

Effective leverage

ExpiryDate

Bases: CalcIndex

Expiry date

FiveDayChangeRate

Bases: CalcIndex

Five days change ratio

FiveMinutesChangeRate

Bases: CalcIndex

Five minutes change ratio

Gamma

Bases: CalcIndex

Gamma

HalfYearChangeRate

Bases: CalcIndex

Half year change ratio

ImpliedVolatility

Bases: CalcIndex

Implied volatility

ItmOtm

Bases: CalcIndex

In/out of the bound

LastDone

Bases: CalcIndex

Latest price

LeverageRatio

Bases: CalcIndex

Leverage ratio

LowerStrikePrice

Bases: CalcIndex

Lower bound price

OpenInterest

Bases: CalcIndex

Open interest

OutstandingQty

Bases: CalcIndex

Outstanding quantity

OutstandingRatio

Bases: CalcIndex

Outstanding ratio

PbRatio

Bases: CalcIndex

PB

PeTtmRatio

Bases: CalcIndex

PE (TTM)

Premium

Bases: CalcIndex

Premium

Rho

Bases: CalcIndex

Rho

StrikePrice

Bases: CalcIndex

Strike price

TenDayChangeRate

Bases: CalcIndex

Ten days change ratio

Theta

Bases: CalcIndex

Theta

ToCallPrice

Bases: CalcIndex

Price interval from the call price

TotalMarketValue

Bases: CalcIndex

Total market value

Turnover

Bases: CalcIndex

Turnover

TurnoverRate

Bases: CalcIndex

Turnover rate

UpperStrikePrice

Bases: CalcIndex

Upper bound price

Vega

Bases: CalcIndex

Vega

Volume

Bases: CalcIndex

Volume

VolumeRatio

Bases: CalcIndex

Volume ratio

WarrantDelta

Bases: CalcIndex

Warrant delta

YtdChangeRate

Bases: CalcIndex

Year-to-date change ratio

Candlestick

Candlestick

close: Decimal instance-attribute

Close price

high: Decimal instance-attribute

High price

low: Decimal instance-attribute

Low price

open: Decimal instance-attribute

Open price

timestamp: datetime instance-attribute

Timestamp

turnover: Decimal instance-attribute

Turnover

volume: int instance-attribute

Volume

CapitalDistribution

Capital distribution

large: Decimal instance-attribute

Large order

medium: Decimal instance-attribute

Medium order

small: Decimal instance-attribute

Small order

CapitalDistributionResponse

Capital distribution response

capital_in: CapitalDistribution instance-attribute

Inflow capital data

capital_out: CapitalDistribution instance-attribute

Outflow capital data

timestamp: datetime instance-attribute

Time

CapitalFlowLine

Capital flow line

inflow: Decimal instance-attribute

Inflow capital data

timestamp: datetime instance-attribute

Time

CashFlow

Cash flow

balance: Decimal instance-attribute

Cash amount

business_time: datetime instance-attribute

Business time

business_type: Type[BalanceType] instance-attribute

Balance type

currency: str instance-attribute

Cash currency

description: str instance-attribute

Cash flow description

direction: Type[CashFlowDirection] instance-attribute

Outflow direction

symbol: Optional[str] instance-attribute

Associated Stock code information

transaction_flow_name: str instance-attribute

Cash flow name

CashFlowDirection

Cash flow direction

In

Bases: CashFlowDirection

In

Out

Bases: CashFlowDirection

Out

Unknown

Bases: CashFlowDirection

Unknown

CashInfo

CashInfo

available_cash: Decimal instance-attribute

Available cash

currency: str instance-attribute

Currency

frozen_cash: Decimal instance-attribute

Frozen cash

settling_cash: Decimal instance-attribute

Cash to be settled

withdraw_cash: Decimal instance-attribute

Withdraw cash

ChargeCategoryCode

Charge category code

Broker

Bases: ChargeCategoryCode

Broker

Third

Bases: ChargeCategoryCode

Third

Unknown

Bases: ChargeCategoryCode

Unknown

CommissionFreeStatus

Commission-free Status

Calculated

Bases: CommissionFreeStatus

Commission-free amount to be calculated

None_

Bases: CommissionFreeStatus

None

Pending

Bases: CommissionFreeStatus

Pending commission-free

Ready

Bases: CommissionFreeStatus

Commission-free applied

Unknown

Bases: CommissionFreeStatus

Unknown

Config

Configuration options for LongPort sdk

Parameters:

Name Type Description Default
app_key str

App Key

required
app_secret str

App Secret

required
access_token str

Access Token

required
http_url Optional[str]

HTTP API url

None
quote_ws_url Optional[str]

Websocket url for quote API

None
trade_ws_url Optional[str]

Websocket url for trade API

None
language Optional[Type[Language]]

Language identifier

None
enable_overnight bool

Enable overnight quote

False
push_candlestick_mode Type[PushCandlestickMode]

Push candlestick mode

Realtime
enable_print_quote_packages

Enable printing the opened quote packages when connected to the server

required

from_env() classmethod

Create a new Config from the given environment variables

It first gets the environment variables from the .env file in the current directory.

Variables

  • LONGPORT_APP_KEY - App key
  • LONGPORT_APP_SECRET - App secret
  • LONGPORT_ACCESS_TOKEN - Access token
  • LONGPORT_HTTP_URL - HTTP endpoint url
  • LONGPORT_QUOTE_WS_URL - Quote websocket endpoint url
  • LONGPORT_TRADE_WS_URL - Trade websocket endpoint url
  • LONGPORT_ENABLE_OVERNIGHT - Enable overnight quote, true or false (Default: false)

refresh_access_token(expired_at=None)

Gets a new access_token

Parameters:

Name Type Description Default
expired_at Optional[datetime]

The expiration time of the access token, defaults to 90 days.

None

Returns:

Type Description
str

Access token

DeductionStatus

Deduction status

Done

Bases: DeductionStatus

Settled and distributed

NoData

Bases: DeductionStatus

Settled with no data

None_

Bases: DeductionStatus

None

Pending

Bases: DeductionStatus

Settled and pending distribution

Unknown

Bases: DeductionStatus

Unknown

Depth

Depth

order_num: int instance-attribute

Number of orders

position: int instance-attribute

Position

price: Optional[Decimal] instance-attribute

Price

volume: int instance-attribute

Volume

DerivativeType

Derivative type

Option

Bases: DerivativeType

US stock options

Warrant

Bases: DerivativeType

HK warrants

EstimateMaxPurchaseQuantityResponse

Response for estimate maximum purchase quantity

cash_max_qty: Decimal instance-attribute

Cash available quantity

margin_max_qty: Decimal instance-attribute

Margin available quantity

Execution

Execution

order_id: str instance-attribute

Order ID

price: Decimal instance-attribute

Executed price

quantity: Decimal instance-attribute

Executed quantity

symbol: str instance-attribute

Security code

trade_done_at: datetime instance-attribute

Trade done time

trade_id: str instance-attribute

Execution ID

FilterWarrantExpiryDate

Filter warrant expiry date type

Between_3_6

Bases: FilterWarrantExpiryDate

3 - 6 months

Between_6_12

Bases: FilterWarrantExpiryDate

6 - 12 months

GT_12

Bases: FilterWarrantExpiryDate

Greater than 12 months

LT_3

Bases: FilterWarrantExpiryDate

Less than 3 months

FilterWarrantInOutBoundsType

Filter warrant in/out of the bounds type

In

Bases: FilterWarrantInOutBoundsType

In bounds

Out

Bases: FilterWarrantInOutBoundsType

Out bounds

FundPosition

Fund position

cost_net_asset_value: Decimal instance-attribute

Net cost

currency: str instance-attribute

Currency

current_net_asset_value: Decimal instance-attribute

Current equity

holding_units: Decimal instance-attribute

Holding units

net_asset_value_day: datetime instance-attribute

Current equity PyDecimal

symbol: str instance-attribute

Fund ISIN code

symbol_name: str instance-attribute

Fund name

FundPositionChannel

Fund position channel

account_channel: str instance-attribute

Account type

positions: List[FundPosition] instance-attribute

Fund positions

FundPositionsResponse

Fund positions response

channels: List[FundPositionChannel] instance-attribute

Channels

HttpClient

A HTTP client for longPort open api

Parameters:

Name Type Description Default
http_url str

HTTP API url

required
app_key str

App Key

required
app_secret str

App Secret

required
access_token str

Access Token

required

from_env() classmethod

Create a new HttpClient from the given environment variables

It first gets the environment variables from the .env file in the current directory.

Variables

  • LONGPORT_HTTP_URL - HTTP endpoint url
  • LONGPORT_APP_KEY - App key
  • LONGPORT_APP_SECRET - App secret
  • LONGPORT_ACCESS_TOKEN - Access token

request(method, path, headers=None, body=None)

Performs a HTTP reqest

Examples:

::

from longport.openapi import HttpClient

client = HttpClient(http_url, app_key,
                    app_secret, access_token);

# get
resp = client.request("get", "/foo/bar");
print(resp)

# post
client.request("get", "/foo/bar", { "foo": 1, "bar": 2 });

IntradayLine

Intraday line

avg_price: Decimal instance-attribute

Average price

price: Decimal instance-attribute

Close price of the minute

timestamp: datetime instance-attribute

Start time of the minute

turnover: Decimal instance-attribute

Turnover

volume: int instance-attribute

Volume

IssuerInfo

Issuer info

issuer_id: int instance-attribute

Issuer ID

name_cn: str instance-attribute

Issuer name (zh-CN)

name_en: str instance-attribute

Issuer name (en)

name_hk: str instance-attribute

Issuer name (zh-HK)

Language

Language identifier

EN

Bases: Language

en

ZH_CN

Bases: Language

zh-CN

ZH_HK

Bases: Language

zh-HK

MarginRatio

Margin ratio

fm_factor: Decimal instance-attribute

Forced close-out margin ratio

im_factor: Decimal instance-attribute

Initial margin ratio

mm_factor: Decimal instance-attribute

Maintain the initial margin ratio

Market

Market

CN

Bases: Market

CN market

HK

Bases: Market

HK market

SG

Bases: Market

SG market

US

Bases: Market

US market

Unknown

Bases: Market

Unknown

MarketTradingSession

Market trading session

market: Type[Market] instance-attribute

Market

trade_sessions: List[TradingSessionInfo] instance-attribute

Trading session

OpenApiException

Bases: Exception

OpenAPI exception

code: Optional[int] instance-attribute

Error code

message: str instance-attribute

Error message

OptionDirection

Option direction

Call

Bases: OptionDirection

Call

Put

Bases: OptionDirection

Put

Unknown

Bases: OptionDirection

Unknown

OptionQuote

Quote of option

contract_multiplier: Decimal instance-attribute

Contract multiplier

contract_size: Decimal instance-attribute

Contract size

contract_type: Type[OptionType] instance-attribute

Option type

direction: Type[OptionDirection] instance-attribute

Option direction

expiry_date: date instance-attribute

Exprity date

high: Decimal instance-attribute

High

historical_volatility: Decimal instance-attribute

Underlying security historical volatility of the option

implied_volatility: Decimal instance-attribute

Implied volatility

last_done: Decimal instance-attribute

Latest price

low: Decimal instance-attribute

Low

open: Decimal instance-attribute

Open

open_interest: int instance-attribute

Number of open positions

prev_close: Decimal instance-attribute

Yesterday's close

strike_price: Decimal instance-attribute

Strike price

symbol: str instance-attribute

Security code

timestamp: datetime instance-attribute

Time of latest price

trade_status: Type[TradeStatus] instance-attribute

Security trading status

turnover: Decimal instance-attribute

Turnover

underlying_symbol: str instance-attribute

Underlying security symbol of the option

volume: int instance-attribute

Volume

OptionType

Option type

American

Bases: OptionType

American

Europe

Bases: OptionType

Europe

Unknown

Bases: OptionType

Unknown

Order

Order

currency: str instance-attribute

Currency

executed_price: Optional[Decimal] instance-attribute

Executed price

executed_quantity: Decimal instance-attribute

Executed quantity

expire_date: Optional[date] instance-attribute

Long term order expire date

last_done: Optional[Decimal] instance-attribute

Last done

limit_offset: Optional[Decimal] instance-attribute

TSLPAMT / TSLPPCT order limit offset amount

msg: str instance-attribute

Rejected Message or remark

order_id: str instance-attribute

Order ID

order_type: Type[OrderType] instance-attribute

Order type

outside_rth: Optional[Type[OutsideRTH]] instance-attribute

Enable or disable outside regular trading hours

price: Optional[Decimal] instance-attribute

Submitted price

quantity: Decimal instance-attribute

Submitted quantity

remark: str instance-attribute

Remark

side: Type[OrderSide] instance-attribute

Order side

status: Type[OrderStatus] instance-attribute

Order status

stock_name: str instance-attribute

Stock name

submitted_at: datetime instance-attribute

Submitted time

symbol: str instance-attribute

Security code

tag: Type[OrderTag] instance-attribute

Order tag

time_in_force: Type[TimeInForceType] instance-attribute

Time in force type

trailing_amount: Optional[Decimal] instance-attribute

TSMAMT / TSLPAMT order trailing amount

trailing_percent: Optional[Decimal] instance-attribute

TSMPCT / TSLPPCT order trailing percent

trigger_at: Optional[datetime] instance-attribute

Conditional order trigger time

trigger_price: Optional[Decimal] instance-attribute

LIT / MIT Order Trigger Price

trigger_status: Optional[Type[TriggerStatus]] instance-attribute

Conditional order trigger status

updated_at: Optional[datetime] instance-attribute

Last updated time

OrderChargeDetail

Order charge detail

currency: str instance-attribute

Settlement currency

items: List[OrderChargeItem] instance-attribute

Order charge items

total_amount: Decimal instance-attribute

Total charges amount

OrderChargeFee

Order charge fee

amount: Decimal instance-attribute

Charge amount

code: str instance-attribute

Charge code

currency: str instance-attribute

Charge currency

name: str instance-attribute

Charge name

OrderChargeItem

Order charge item

code: Type[ChargeCategoryCode] instance-attribute

Charge category code

fees: List[OrderChargeFee] instance-attribute

Charge details

name: str instance-attribute

Charge category name

OrderDetail

Order detail

charge_detail: OrderChargeDetail instance-attribute

Order charges

currency: str instance-attribute

Currency

deductions_amount: Optional[Decimal] instance-attribute

Deduction amount

deductions_currency: Optional[str] instance-attribute

Deduction currency

deductions_status: Type[DeductionStatus] instance-attribute

Deduction status

executed_price: Optional[Decimal] instance-attribute

Executed price

executed_quantity: Decimal instance-attribute

Executed quantity

expire_date: Optional[date] instance-attribute

Long term order expire date

free_amount: Optional[Decimal] instance-attribute

Commission-free amount

free_currency: Optional[str] instance-attribute

Commission-free currency

free_status: Type[CommissionFreeStatus] instance-attribute

Commission-free Status

history: List[OrderHistoryDetail] instance-attribute

Order history details

last_done: Optional[Decimal] instance-attribute

Last done

limit_offset: Optional[Decimal] instance-attribute

TSLPAMT / TSLPPCT order limit offset amount

msg: str instance-attribute

Rejected Message or remark

order_id: str instance-attribute

Order ID

order_type: Type[OrderType] instance-attribute

Order type

outside_rth: Optional[Type[OutsideRTH]] instance-attribute

Enable or disable outside regular trading hours

platform_deducted_amount: Optional[Decimal] instance-attribute

Platform deduction amount

platform_deducted_currency: Optional[str] instance-attribute

Platform deduction currency

platform_deducted_status: Type[DeductionStatus] instance-attribute

Platform fee deduction status

price: Optional[Decimal] instance-attribute

Submitted price

quantity: Decimal instance-attribute

Submitted quantity

remark: str instance-attribute

Remark

side: Type[OrderSide] instance-attribute

Order side

status: Type[OrderStatus] instance-attribute

Order status

stock_name: str instance-attribute

Stock name

submitted_at: datetime instance-attribute

Submitted time

symbol: str instance-attribute

Security code

tag: Type[OrderTag] instance-attribute

Order tag

time_in_force: Type[TimeInForceType] instance-attribute

Time in force type

trailing_amount: Optional[Decimal] instance-attribute

TSMAMT / TSLPAMT order trailing amount

trailing_percent: Optional[Decimal] instance-attribute

TSMPCT / TSLPPCT order trailing percent

trigger_at: Optional[datetime] instance-attribute

Conditional order trigger time

trigger_price: Optional[Decimal] instance-attribute

LIT / MIT Order Trigger Price

trigger_status: Optional[Type[TriggerStatus]] instance-attribute

Conditional order trigger status

updated_at: Optional[datetime] instance-attribute

Last updated time

OrderHistoryDetail

Order history detail

msg: str instance-attribute

Execution or error message

price: Decimal instance-attribute

Executed price for executed orders, submitted price for expired, canceled, rejected orders, etc.

quantity: Decimal instance-attribute

Executed quantity for executed orders, remaining quantity for expired, canceled, rejected orders, etc.

status: Type[OrderStatus] instance-attribute

Order status

time: datetime instance-attribute

Occurrence time

OrderSide

Order side

Buy

Bases: OrderSide

Buy

Sell

Bases: OrderSide

Sell

Unknown

Bases: OrderSide

Unknown

OrderStatus

Order status

Canceled

Bases: OrderStatus

Canceled

Expired

Bases: OrderStatus

ExpiredStatus

Filled

Bases: OrderStatus

Filled

New

Bases: OrderStatus

New

NotReported

Bases: OrderStatus

Not reported

PartialFilled

Bases: OrderStatus

Partial Filled

PartialWithdrawal

Bases: OrderStatus

PartialWithdrawal

PendingCancel

Bases: OrderStatus

Pending Cancel

PendingReplace

Bases: OrderStatus

Pending Replace

ProtectedNotReported

Bases: OrderStatus

Not reported (Protected Order)

Rejected

Bases: OrderStatus

Rejected

Replaced

Bases: OrderStatus

Replaced

ReplacedNotReported

Bases: OrderStatus

Not reported (Replaced Order)

Unknown

Bases: OrderStatus

Unknown

VarietiesNotReported

Bases: OrderStatus

Not reported (Conditional Order)

WaitToCancel

Bases: OrderStatus

Wait To Cancel

WaitToNew

Bases: OrderStatus

Wait To New

WaitToReplace

Bases: OrderStatus

Wait To Replace

OrderTag

Order tag

AllocatedSub

Bases: OrderTag

Trade Allocation

Creditor

Bases: OrderTag

Option Exercise Long

Debtor

Bases: OrderTag

Option Exercise Short

Grey

Bases: OrderTag

Grey Order

LongTerm

Bases: OrderTag

Long term Order

MarginCall

Bases: OrderTag

Force Selling

NonExercise

Bases: OrderTag

Wavier Of Option Exercise

Normal

Bases: OrderTag

Normal Order

Offline

Bases: OrderTag

OTC

Unknown

Bases: OrderTag

Unknown

OrderType

Order type

ALO

Bases: OrderType

At-auction Limit Order

AO

Bases: OrderType

At-auction Order

ELO

Bases: OrderType

Enhanced Limit Order

LIT

Bases: OrderType

Limit If Touched

LO

Bases: OrderType

Limit Order

MIT

Bases: OrderType

Market If Touched

MO

Bases: OrderType

Market Order

ODD

Bases: OrderType

Odd Lots

SLO

Bases: OrderType

Special Limit Order

TSLPAMT

Bases: OrderType

Trailing Limit If Touched (Trailing Amount)

TSLPPCT

Bases: OrderType

Trailing Limit If Touched (Trailing Percent)

TSMAMT

Bases: OrderType

Trailing Market If Touched (Trailing Amount)

TSMPCT

Bases: OrderType

Trailing Market If Touched (Trailing Percent)

Unknown

Bases: OrderType

Unknown

OutsideRTH

Enable or disable outside regular trading hours

AnyTime

Bases: OutsideRTH

Any time

Overnight

Bases: OutsideRTH

Overnight

RTHOnly

Bases: OutsideRTH

Regular trading hour only

Unknown

Bases: OutsideRTH

Unknown

ParticipantInfo

Participant info

broker_ids: List[int] instance-attribute

Broker IDs

name_cn: str instance-attribute

Participant name (zh-CN)

name_en: str instance-attribute

Participant name (en)

name_hk: str instance-attribute

Participant name (zh-HK)

Period

Candlestick period

Day

Bases: Period

One Day

Min_1

Bases: Period

One Minute

Min_15

Bases: Period

Fifteen Minutes

Min_30

Bases: Period

Thirty Minutes

Min_5

Bases: Period

Five Minutes

Min_60

Bases: Period

Sixty Minutes

Month

Bases: Period

One Month

Unknown

Bases: Period

Unknown

Week

Bases: Period

One Week

Year

Bases: Period

One Year

PrePostQuote

Quote of US pre/post market

high: Decimal instance-attribute

High

last_done: Decimal instance-attribute

Latest price

low: Decimal instance-attribute

Low

prev_close: Decimal instance-attribute

Close of the last trade session

timestamp: datetime instance-attribute

Time of latest price

turnover: Decimal instance-attribute

Turnover

volume: int instance-attribute

Volume

PushBrokers

Brokers message

ask_brokers: List[Brokers] instance-attribute

Ask brokers

bid_brokers: List[Brokers] instance-attribute

Bid brokers

PushCandlestick

Candlestick updated event

candlestick: Candlestick instance-attribute

Candlestick

period: Period instance-attribute

Period type

PushCandlestickMode

Push candlestick mode

Confirmed

Bases: PushCandlestickMode

Confirmed

Realtime

Bases: PushCandlestickMode

Real-time

PushDepth

Depth message

asks: List[Depth] instance-attribute

Ask depth

bids: List[Depth] instance-attribute

Bid depth

PushOrderChanged

Order changed message

account_no: str instance-attribute

Account no

currency: str instance-attribute

Currency

executed_price: Optional[Decimal] instance-attribute

Executed price

executed_quantity: Decimal instance-attribute

Executed quantity

last_price: Optional[Decimal] instance-attribute

Last price

last_share: Optional[Decimal] instance-attribute

Last share

limit_offset: Optional[Decimal] instance-attribute

Limit offset amount

msg: str instance-attribute

Rejected message or remark

order_id: str instance-attribute

Order ID

order_type: Type[OrderType] instance-attribute

Order type

remark: str instance-attribute

Remark message

side: Type[OrderSide] instance-attribute

Order side

status: Type[OrderStatus] instance-attribute

Order status

stock_name: str instance-attribute

Stock name

submitted_at: datetime instance-attribute

Submitted time

submitted_price: Decimal instance-attribute

Submitted price

submitted_quantity: Decimal instance-attribute

Submitted quantity

symbol: str instance-attribute

Order symbol

tag: Type[OrderTag] instance-attribute

Order tag

trailing_amount: Optional[Decimal] instance-attribute

Trailing amount

trailing_percent: Optional[Decimal] instance-attribute

Trailing percent

trigger_at: Optional[datetime] instance-attribute

Conditional order trigger time

trigger_price: Optional[Decimal] instance-attribute

Order trigger price

trigger_status: Optional[Type[TriggerStatus]] instance-attribute

Conditional order trigger status

updated_at: datetime instance-attribute

Last updated time

PushQuote

Quote message

high: Decimal instance-attribute

High

last_done: Decimal instance-attribute

Latest price

low: Decimal instance-attribute

Low

open: Decimal instance-attribute

Open

timestamp: datetime instance-attribute

Time of latest price

trade_session: Type[TradeSession] instance-attribute

Trade session

trade_status: Type[TradeStatus] instance-attribute

Security trading status

turnover: Decimal instance-attribute

Turnover

volume: int instance-attribute

Volume

PushTrades

Trades message

trades: List[Trade] instance-attribute

Trades data

QuoteContext

Quote context

Parameters:

Name Type Description Default
config Config

Configuration object

required

brokers(symbol)

Get security brokers

Parameters:

Name Type Description Default
symbol str

Security code

required

Returns:

Type Description
SecurityBrokers

Security brokers

Examples:

::

from longport.openapi import QuoteContext, Config

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

resp = ctx.brokers("700.HK")
print(resp)

calc_indexes(symbols, indexes)

Get calc indexes

Parameters:

Name Type Description Default
symbols List[str]

Security codes

required
indexes List[Type[CalcIndex]]

Calc indexes

required

Returns:

Type Description
List[SecurityCalcIndex]

Calc indexes of the symbols

Examples:

::

from longport.openapi import QuoteContext, Config, CalcIndex

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

resp = ctx.calc_indexes(["700.HK", "APPL.US"], [CalcIndex.LastDone, CalcIndex.ChangeRate])
print(resp)

candlesticks(symbol, period, count, adjust_type)

Get security candlesticks

Parameters:

Name Type Description Default
symbol str

Security code

required
period Type[Period]

Candlestick period

required
count int

Count of cancdlestick (Maximum is 1000)

required
adjust_type Type[AdjustType]

Adjustment type

required

Returns:

Type Description
List[Candlestick]

Candlesticks

Examples:

::

from longport.openapi import QuoteContext, Config, Period, AdjustType

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

resp = ctx.candlesticks(
    "700.HK", Period.Day, 10, AdjustType.NoAdjust)
print(resp)

capital_distribution(symbol)

Get capital distribution

Parameters:

Name Type Description Default
symbol str

Security code

required

Returns:

Type Description
CapitalDistributionResponse

Capital distribution

Examples:

::

from longport.openapi import QuoteContext, Config

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

resp = ctx.capital_distribution("700.HK")
print(resp)

capital_flow(symbol)

Get capital flow intraday

Parameters:

Name Type Description Default
symbol str

Security code

required

Returns:

Type Description
List[CapitalFlowLine]

Capital flow list

Examples:

::

from longport.openapi import QuoteContext, Config

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

resp = ctx.capital_flow("700.HK")
print(resp)

create_watchlist_group(name, securities=None)

Create watchlist group

Parameters:

Name Type Description Default
name str

Group name

required
securities Optional[List[str]]

Securities

None

Returns:

Type Description
int

Group ID

Examples:

::

from longport.openapi import QuoteContext, Config

config = Config.from_env()
ctx = QuoteContext(config)
group_id = ctx.create_watchlist_group(name = "Watchlist1", securities = ["700.HK", "AAPL.US"])
print(group_id)

delete_watchlist_group(id, purge=False)

Delete watchlist group

Parameters:

Name Type Description Default
id int

Group ID

required
purge bool

Move securities in this group to the default group

False

Examples:

::

from longport.openapi import QuoteContext, Config

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

depth(symbol)

Get security depth

Parameters:

Name Type Description Default
symbol str

Security code

required

Returns:

Type Description
SecurityDepth

Security depth

Examples:

::

from longport.openapi import QuoteContext, Config

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

resp = ctx.depth("700.HK")
print(resp)

history_candlesticks_by_date(symbol, period, adjust_type, start, end)

Get security history candlesticks by date

Parameters:

Name Type Description Default
symbol str

Security code

required
period Type[Period]

Period type

required
adjust_type Type[AdjustType]

Adjust type

required
start Optional[date]

Start date

required
end Optional[date]

End date

required

history_candlesticks_by_offset(symbol, period, adjust_type, forward, count, time=None)

Get security history candlesticks by offset

Parameters:

Name Type Description Default
symbol str

Security code

required
period Type[Period]

Period type

required
adjust_type Type[AdjustType]

Adjust type

required
forward bool

If True, query the latest from the specified time

required
count int

Count of candlesticks

required
time Optional[datetime]

Datetime

None

intraday(symbol)

Get security intraday lines

Parameters:

Name Type Description Default
symbol str

Security code

required

Returns:

Type Description
List[IntradayLine]

Intraday lines

Examples:

::

from longport.openapi import QuoteContext, Config

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

resp = ctx.intraday("700.HK")
print(resp)

member_id()

Returns the member ID

option_chain_expiry_date_list(symbol)

Get option chain expiry date list

Parameters:

Name Type Description Default
symbol str

Security code

required

Returns:

Type Description
List[date]

Option chain expiry date list

Examples:

::

from longport.openapi import QuoteContext, Config

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

resp = ctx.option_chain_expiry_date_list("AAPL.US")
print(resp)

option_chain_info_by_date(symbol, expiry_date)

Get option chain info by date

Parameters:

Name Type Description Default
symbol str

Security code

required
expiry_date date

Expiry date

required

Returns:

Type Description
List[StrikePriceInfo]

Option chain info

Examples:

::

from datetime import date
from longport.openapi import QuoteContext, Config

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

resp = ctx.option_chain_info_by_date(
    "AAPL.US", date(2023, 1, 20))
print(resp)

option_quote(symbols)

Get quote of option securities

Parameters:

Name Type Description Default
symbols List[str]

Security codes

required

Returns:

Type Description
List[OptionQuote]

Option quote list

Examples:

::

from longport.openapi import QuoteContext, Config

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

resp = ctx.option_quote(["AAPL230317P160000.US"])
print(resp)

participants()

Get participants

Returns:

Type Description
List[ParticipantInfo]

Participants

Examples:

::

from longport.openapi import QuoteContext, Config

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

resp = ctx.participants()
print(resp)

quote(symbols)

Get quote of securities

Parameters:

Name Type Description Default
symbols List[str]

Security codes

required

Returns:

Type Description
List[SecurityQuote]

Security quote list

Examples:

::

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)

quote_level()

Returns the quote level

quote_package_details()

Returns the quote package details

realtime_brokers(symbol)

Get real-time brokers

Get real-time brokers of the subscribed symbols, it always returns the data in the local storage.

Parameters:

Name Type Description Default
symbol str

Security code

required

Returns:

Type Description
SecurityBrokers

Security brokers

Examples:

::

from time import sleep
from longport.openapi import QuoteContext, Config, SubType

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

ctx.subscribe(["700.HK", "AAPL.US"], [
              SubType.Brokers], is_first_push = True)
sleep(5)
resp = ctx.realtime_brokers("700.HK")
print(resp)

realtime_candlesticks(symbol, period, count)

Get real-time candlesticks

Get Get real-time candlesticks of the subscribed symbols, it always returns the data in the local storage.

Parameters:

Name Type Description Default
symbol str

Security code

required
period Type[Period]

Period type

required
count int

Count of candlesticks

required

Returns:

Type Description
List[Candlestick]

Security candlesticks

Examples:

::

from time import sleep
from longport.openapi import QuoteContext, Config, Period

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

ctx.subscribe_candlesticks("AAPL.US", Period.Min_1)
sleep(5)
resp = ctx.realtime_candlesticks("AAPL.US", Period.Min_1, 10)
print(resp)

realtime_depth(symbol)

Get real-time depth

Get real-time depth of the subscribed symbols, it always returns the data in the local storage.

Parameters:

Name Type Description Default
symbol str

Security code

required

Returns:

Type Description
SecurityDepth

Security depth

Examples:

::

from time import sleep
from longport.openapi import QuoteContext, Config, SubType

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

ctx.subscribe(["700.HK", "AAPL.US"], [
              SubType.Depth], is_first_push = True)
sleep(5)
resp = ctx.realtime_depth("700.HK")
print(resp)

realtime_quote(symbols)

Get real-time quote

Get real-time quotes of the subscribed symbols, it always returns the data in the local storage.

Parameters:

Name Type Description Default
symbols List[str]

Security codes

required

Returns:

Type Description
List[RealtimeQuote]

Quote list

Examples:

::

from time import sleep
from longport.openapi import QuoteContext, Config, SubType

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

ctx.subscribe(["700.HK", "AAPL.US"], [
              SubType.Quote], is_first_push = True)
sleep(5)
resp = ctx.realtime_quote(["700.HK", "AAPL.US"])
print(resp)

realtime_trades(symbol, count)

Get real-time trades

Get real-time trades of the subscribed symbols, it always returns the data in the local storage.

Parameters:

Name Type Description Default
symbol str

Security code

required
count int

Count of trades

required

Returns:

Type Description
List[Trade]

Security trades

Examples:

::

from time import sleep
from longport.openapi import QuoteContext, Config, SubType

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

ctx.subscribe(["700.HK", "AAPL.US"], [
              SubType.Trade], is_first_push = False)
sleep(5)
resp = ctx.realtime_trades("700.HK", 10)
print(resp)

security_list(market, category)

Get security list

Parameters:

Name Type Description Default
market Type[Market]

Market

required
category Type[SecurityListCategory]

Security list category

required

Returns:

Type Description
List[Security]

Security list

Examples:

::

from longport.openapi import QuoteContext, Config, Market, SecurityListCategory

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

resp = ctx.security_list(Market.HK, SecurityListCategory.Overnight)
print(resp)

set_on_brokers(callback)

Set brokers callback, after receiving the brokers data push, it will call back to this function.

set_on_candlestick(callback)

Set candlestick callback, after receiving the candlestick updated event, it will call back to this function.

set_on_depth(callback)

Set depth callback, after receiving the depth data push, it will call back to this function.

set_on_quote(callback)

Set quote callback, after receiving the quote data push, it will call back to this function.

set_on_trades(callback)

Set trades callback, after receiving the trades data push, it will call back to this function.

static_info(symbols)

Get basic information of securities

Parameters:

Name Type Description Default
symbols List[str]

Security codes

required

Returns:

Type Description
List[SecurityStaticInfo]

Security info list

Examples:

::

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)

subscribe(symbols, sub_types, is_first_push=False)

Subscribe

Parameters:

Name Type Description Default
symbols List[str]

Security codes

required
sub_types List[Type[SubType]]

Subscribe types

required
is_first_push bool

Whether to perform a data push immediately after subscribing. (trade not supported)

False

Examples:

::

from time import sleep
from longport.openapi import QuoteContext, Config, SubType, PushQuote

def on_quote(symbol: str, event: PushQuote):
    print(symbol, event)

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

ctx.subscribe(["700.HK", "AAPL.US"], [
              SubType.Quote], is_first_push = True)
sleep(30)

subscribe_candlesticks(symbol, period)

Subscribe security candlesticks

Parameters:

Name Type Description Default
symbol str

Security code

required
period Type[Period]

Period type

required

Examples:

::

from longport.openapi import QuoteContext, Config, PushCandlestick
config = Config.from_env()
ctx = QuoteContext(config)

def on_candlestick(symbol: str, event: PushCandlestick):
    print(symbol, event)

ctx.set_on_candlestick(on_candlestick)
ctx.subscribe_candlesticks("700.HK", Period.Min_1)
sleep(30)

subscriptions()

Get subscription information

Examples:

::

from longport.openapi import QuoteContext, Config, SubType
config = Config.from_env()
ctx = QuoteContext(config)

ctx.subscribe(["700.HK", "AAPL.US"], [SubType.Quote])
resp = ctx.subscriptions()
print(resp)

trades(symbol, count)

Get security trades

Parameters:

Name Type Description Default
symbol str

Security code

required
count int

Count of trades (Maximum is 1000)

required

Returns:

Type Description
List[Trade]

Trades

Examples:

::

from longport.openapi import QuoteContext, Config

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

resp = ctx.trades("700.HK", 10)
print(resp)

trading_days(market, begin, end)

Get trading session of the day

The interval must be less than one month, and only the most recent year is supported.

Parameters:

Name Type Description Default
market Type[Market]

Market

required
begin date

Begin date

required
end date

End date

required

Returns:

Type Description
MarketTradingDays

Trading days

Examples:

::

from datetime import date
from longport.openapi import QuoteContext, Config, Market

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

resp = ctx.trading_days(
    Market.HK, date(2022, 1, 1), date(2022, 2, 1))
print(resp)

trading_session()

Get trading session of the day

Returns:

Type Description
List[MarketTradingSession]

Trading session of the day

Examples:

::

from longport.openapi import QuoteContext, Config

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

resp = ctx.trading_session()
print(resp)

unsubscribe(symbols, sub_types)

Unsubscribe

Parameters:

Name Type Description Default
symbols List[str]

Security codes

required
sub_types List[Type[SubType]]

Subscribe types

required

Examples:

::

from longport.openapi import QuoteContext, Config, SubType
config = Config.from_env()
ctx = QuoteContext(config)

ctx.subscribe(["700.HK", "AAPL.US"], [SubType.Quote])
ctx.unsubscribe(["AAPL.US"], [SubType.Quote])

unsubscribe_candlesticks(symbol, period)

Subscribe security candlesticks

Parameters:

Name Type Description Default
symbol str

Security code

required
period Type[Period]

Period type

required

update_watchlist_group(id, name=None, securities=None, mode=None)

Update watchlist group

Parameters:

Name Type Description Default
id int

Group ID

required
name Optional[str]

Group name

None
securities Optional[List[str]]

Securities

None

Examples:

::

from longport.openapi import QuoteContext, Config, SecuritiesUpdateMode

config = Config.from_env()
ctx = QuoteContext(config)
ctx.update_watchlist_group(10086, name = "Watchlist2", securities = ["700.HK", "AAPL.US"], SecuritiesUpdateMode.Replace)

warrant_issuers()

Get warrant issuers

Returns:

Type Description
List[IssuerInfo]

Warrant issuers

Examples:

::

from longport.openapi import QuoteContext, Config

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

resp = ctx.warrant_issuers()
print(resp)

warrant_list(symbol, sort_by, sort_order, warrant_type=None, issuer=None, expiry_date=None, price_type=None, status=None)

Get warrant list

Parameters:

Name Type Description Default
symbol str

Security code

required
sort_by Type[WarrantSortBy]

Sort by field

required
sort_order Type[SortOrderType]

Sort order

required
warrant_type Optional[List[Type[WarrantType]]]

Filter by warrant type

None
issuer Optional[List[int]]

Filter by issuer

None
expiry_date Optional[List[Type[FilterWarrantExpiryDate]]]

Filter by expiry date

None
price_type Optional[List[Type[FilterWarrantInOutBoundsType]]]

Filter by price type

None
status Optional[List[Type[WarrantStatus]]]

Filter by status

None

Returns:

Type Description
List[WarrantInfo]

Warrant list

Examples:

::

from longport.openapi import QuoteContext, Config, WarrantSortBy, SortOrderType

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

resp = ctx.warrant_list("700.HK", WarrantSortBy.LastDone, SortOrderType.Ascending)
print(resp)

warrant_quote(symbols)

Get quote of warrant securities

Parameters:

Name Type Description Default
symbols List[str]

Security codes

required

Returns:

Type Description
List[WarrantQuote]

Warrant quote list

Examples:

::

from longport.openapi import QuoteContext, Config

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

resp = ctx.warrant_quote(["21125.HK"])
print(resp)

watchlist()

Get watch list

Returns:

Type Description
List[WatchlistGroup]

Watch list groups

Examples:

::

from longport.openapi import QuoteContext, Config

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

resp = ctx.watchlist()
print(resp)

QuotePackageDetail

Quote package detail

description: str instance-attribute

Description

end_at: datetime instance-attribute

End time

key: str instance-attribute

Key

name: str instance-attribute

Name

start_at: datetime instance-attribute

Start time

RealtimeQuote

Real-time quote

high: Decimal instance-attribute

High

last_done: Decimal instance-attribute

Latest price

low: Decimal instance-attribute

Low

open: Decimal instance-attribute

Open

symbol: str instance-attribute

Security code

timestamp: datetime instance-attribute

Time of latest price

trade_status: Type[TradeStatus] instance-attribute

Security trading status

turnover: Decimal instance-attribute

Turnover

volume: int instance-attribute

Volume

SecuritiesUpdateMode

Securities update mode

Add

Bases: SecuritiesUpdateMode

Add securities

Remove

Bases: SecuritiesUpdateMode

Remove securities

Replace

Bases: SecuritiesUpdateMode

Replace securities

Security

Security

name_cn: str instance-attribute

Security name (zh-CN)

name_en: str instance-attribute

Security name (en)

name_hk: str instance-attribute

Security name (zh-HK)

symbol: str instance-attribute

Security code

SecurityBoard

Security board

CNIX

Bases: SecurityBoard

CN Index

CNSector

Bases: SecurityBoard

CN Industry Board

HKEquity

Bases: SecurityBoard

Hong Kong Equity Securities

HKHS

Bases: SecurityBoard

Hang Seng Index

HKPreIPO

Bases: SecurityBoard

HK PreIPO Security

HKSector

Bases: SecurityBoard

HK Industry Board

HKWarrant

Bases: SecurityBoard

HK Warrant

SGMain

Bases: SecurityBoard

SG Main Board

SGSector

Bases: SecurityBoard

SG Industry Board

SHMainConnect

Bases: SecurityBoard

SH Main Board(Connect)

SHMainNonConnect

Bases: SecurityBoard

SH Main Board(Non Connect)

SHSTAR

Bases: SecurityBoard

SH Science and Technology Innovation Board

STI

Bases: SecurityBoard

Singapore Straits Index

SZGEMConnect

Bases: SecurityBoard

SZ Gem Board(Connect)

SZGEMNonConnect

Bases: SecurityBoard

SZ Gem Board(Non Connect)

SZMainConnect

Bases: SecurityBoard

SZ Main Board(Connect)

SZMainNonConnect

Bases: SecurityBoard

SZ Main Board(Non Connect)

USDJI

Bases: SecurityBoard

Dow Jones Industrial Average

USMain

Bases: SecurityBoard

US Pink Board

USNSDQ

Bases: SecurityBoard

Nasdsaq Index

USOption

Bases: SecurityBoard

US Option

USOptionS

Bases: SecurityBoard

US Sepecial Option

USPink

Bases: SecurityBoard

US Pink Board

USSector

Bases: SecurityBoard

US Industry Board

Unknown

Bases: SecurityBoard

Unknown

SecurityBrokers

Security brokers

ask_brokers: List[Brokers] instance-attribute

Ask brokers

bid_brokers: List[Brokers] instance-attribute

Bid brokers

SecurityCalcIndex

Security calc index response

amplitude: Optional[Decimal] instance-attribute

Amplitude

balance_point: Optional[Decimal] instance-attribute

Breakeven point

call_price: Optional[Decimal] instance-attribute

Call price

capital_flow: Optional[Decimal] instance-attribute

Capital flow

change_rate: Optional[Decimal] instance-attribute

Change ratio

change_value: Optional[Decimal] instance-attribute

Change value

conversion_ratio: Optional[Decimal] instance-attribute

Conversion ratio

delta: Optional[Decimal] instance-attribute

Delta

dividend_ratio_ttm: Optional[Decimal] instance-attribute

Dividend ratio (TTM)

effective_leverage: Optional[Decimal] instance-attribute

Effective leverage

expiry_date: Optional[date] instance-attribute

Expiry date

five_day_change_rate: Optional[Decimal] instance-attribute

Five days change ratio

five_minutes_change_rate: Optional[Decimal] instance-attribute

Five minutes change ratio

gamma: Optional[Decimal] instance-attribute

Gamma

half_year_change_rate: Optional[Decimal] instance-attribute

Half year change ratio

implied_volatility: Optional[Decimal] instance-attribute

Implied volatility

itm_otm: Optional[Decimal] instance-attribute

In/out of the bound

last_done: Optional[Decimal] instance-attribute

Latest price

leverage_ratio: Optional[Decimal] instance-attribute

Leverage ratio

lower_strike_price: Optional[Decimal] instance-attribute

Lower bound price

open_interest: Optional[int] instance-attribute

Open interest

outstanding_qty: Optional[int] instance-attribute

Outstanding quantity

outstanding_ratio: Optional[Decimal] instance-attribute

Outstanding ratio

pb_ratio: Optional[Decimal] instance-attribute

PB

pe_ttm_ratio: Optional[Decimal] instance-attribute

PE (TTM)

premium: Optional[Decimal] instance-attribute

Premium

rho: Optional[Decimal] instance-attribute

Rho

strike_price: Optional[Decimal] instance-attribute

Strike price

symbol: str instance-attribute

Security symbol

ten_day_change_rate: Optional[Decimal] instance-attribute

Ten days change ratio

theta: Optional[Decimal] instance-attribute

Theta

to_call_price: Optional[Decimal] instance-attribute

Price interval from the call price

total_market_value: Optional[Decimal] instance-attribute

Total market value

turnover: Optional[Decimal] instance-attribute

Turnover

turnover_rate: Optional[Decimal] instance-attribute

turnover_rate

upper_strike_price: Optional[Decimal] instance-attribute

Upper bound price

vega: Optional[Decimal] instance-attribute

Vega

volume: Optional[int] instance-attribute

Volume

volume_ratio: Optional[Decimal] instance-attribute

Volume ratio

warrant_delta: Optional[Decimal] instance-attribute

Warrant delta

ytd_change_rate: Optional[Decimal] instance-attribute

Year-to-date change ratio

SecurityDepth

Security depth

asks: List[Depth] instance-attribute

Ask depth

bids: List[Depth] instance-attribute

Bid depth

SecurityListCategory

Security list category

Overnight

Bases: SecurityListCategory

Overnight

SecurityQuote

Quote of securitity

high: Decimal instance-attribute

High

last_done: Decimal instance-attribute

Latest price

low: Decimal instance-attribute

Low

open: Decimal instance-attribute

Open

overnight_quote: Optional[PrePostQuote] instance-attribute

Quote of US overnight market

post_market_quote: Optional[PrePostQuote] instance-attribute

Quote of US post market

pre_market_quote: Optional[PrePostQuote] instance-attribute

Quote of US pre market

prev_close: Decimal instance-attribute

Yesterday's close

symbol: str instance-attribute

Security code

timestamp: datetime instance-attribute

Time of latest price

trade_status: Type[TradeStatus] instance-attribute

Security trading status

turnover: Decimal instance-attribute

Turnover

volume: int instance-attribute

Volume

SecurityStaticInfo

The basic information of securities

board: Type[SecurityBoard] instance-attribute

Board

bps: Decimal instance-attribute

Net assets per share

circulating_shares: int instance-attribute

Circulating shares

currency: str instance-attribute

Trading currency

dividend_yield: Decimal instance-attribute

Dividend yield

eps: Decimal instance-attribute

Earnings per share

eps_ttm: Decimal instance-attribute

Earnings per share (TTM)

exchange: str instance-attribute

Exchange which the security belongs to

hk_shares: int instance-attribute

HK shares (only HK stocks)

lot_size: int instance-attribute

Lot size

name_cn: str instance-attribute

Security name (zh-CN)

name_en: str instance-attribute

Security name (en)

name_hk: str instance-attribute

Security name (zh-HK)

stock_derivatives: List[Type[DerivativeType]] instance-attribute

Types of supported derivatives

symbol: str instance-attribute

Security code

total_shares: int instance-attribute

Total shares

SortOrderType

Sort order type

Ascending

Bases: SortOrderType

Ascending

Descending

Bases: SortOrderType

Descending

StockPosition

Stock position

available_quantity: Decimal instance-attribute

Available quantity

cost_price: Decimal instance-attribute

Cost Price(According to the client's choice of average purchase or diluted cost)

currency: str instance-attribute

Currency

init_quantity: Optional[Decimal] instance-attribute

Initial position before market opening

market: Market instance-attribute

Market

quantity: Decimal instance-attribute

The number of holdings

symbol: str instance-attribute

Stock code

symbol_name: str instance-attribute

Stock name

StockPositionChannel

Stock position channel

account_channel: str instance-attribute

Account type

positions: List[StockPosition] instance-attribute

Stock positions

StockPositionsResponse

Stock positions response

channels: List[StockPositionChannel] instance-attribute

Channels

StrikePriceInfo

Strike price info

call_symbol: str instance-attribute

Security code of call option

price: Decimal instance-attribute

Strike price

put_symbol: str instance-attribute

Security code of put option

standard: bool instance-attribute

Is standard

SubType

Subscription flags

Brokers

Bases: SubType

Broker

Depth

Bases: SubType

Depth

Quote

Bases: SubType

Quote

Trade

Bases: SubType

Trade

SubmitOrderResponse

Response for submit order request

order_id: str instance-attribute

Order id

Subscription

Subscription

candlesticks: List[Type[Period]] instance-attribute

Candlesticks

sub_types: List[Type[SubType]] instance-attribute

Subscription types

symbol: str instance-attribute

Security code

TimeInForceType

Time in force type

Day

Bases: TimeInForceType

Day Order

GoodTilCanceled

Bases: TimeInForceType

Good Til Canceled Order

GoodTilDate

Bases: TimeInForceType

Good Til Date Order

Unknown

Bases: TimeInForceType

Unknown

TopicType

Topic type

Private

Bases: TopicType

Private notification for trade

Trade

Trade

direction: Type[TradeDirection] instance-attribute

Trade direction

price: Decimal instance-attribute

Price

timestamp: datetime instance-attribute

Time of trading

trade_session: Type[TradeSession] instance-attribute

Trade session

trade_type: str instance-attribute

Trade type

HK

  • * - Overseas trade
  • D - Odd-lot trade
  • M - Non-direct off-exchange trade
  • P - Late trade (Off-exchange previous day)
  • U - Auction trade
  • X - Direct off-exchange trade
  • Y - Automatch internalized
  • <empty string> - Automatch normal

US

  • <empty string> - Regular sale
  • A - Acquisition
  • B - Bunched trade
  • D - Distribution
  • F - Intermarket sweep
  • G - Bunched sold trades
  • H - Price variation trade
  • I - Odd lot trade
  • K - Rule 155 trde(NYSE MKT)
  • M - Market center close price
  • P - Prior reference price
  • Q - Market center open price
  • S - Split trade
  • V - Contingent trade
  • W - Average price trade
  • X - Cross trade
  • 1 - Stopped stock(Regular trade)

volume: int instance-attribute

Volume

TradeContext

Trade context

Parameters:

Name Type Description Default
config Config

Configuration object

required

account_balance(currency=None)

Get account balance

Parameters:

Name Type Description Default
currency Optional[str]

Currency

None

Returns:

Type Description
List[AccountBalance]

Account list

Examples:

::

from longport.openapi import TradeContext, Config

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

resp = ctx.account_balance()
print(resp)

cancel_order(order_id)

Cancel order

Parameters:

Name Type Description Default
order_id str

Order ID

required

Examples:

::

from longport.openapi import TradeContext, Config

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

ctx.cancel_order("709043056541253632")

cash_flow(start_at, end_at, business_type=None, symbol=None, page=None, size=None)

Get cash flow

Parameters:

Name Type Description Default
start_at datetime

Start time

required
end_at datetime

End time

required
business_type Optional[Type[BalanceType]]

Balance type

None
symbol Optional[str]

Target security code

None
page Optional[int]

Start page (Default: 1)

None
size Optional[int]

Page size (Default: 50)

None

Returns:

Type Description
List[CashFlow]

Cash flow list

Examples:

::

from datetime import datetime
from longport.openapi import TradeContext, Config

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

resp = ctx.cash_flow(
    start_at = datetime(2022, 5, 9),
    end_at = datetime(2022, 5, 12),
)
print(resp)

estimate_max_purchase_quantity(symbol, order_type, side, price=None, currency=None, order_id=None, fractional_shares=False)

Estimating the maximum purchase quantity for Hong Kong and US stocks, warrants, and options

Parameters:

Name Type Description Default
symbol str

Security symbol

required
order_type Type[OrderType]

Order type

required
side Type[OrderSide]

Order side

required
price Optional[Decimal]

Estimated order price,

None
currency Optional[str]

Settlement currency

None
order_id Optional[str]

Order ID, required when estimating the maximum purchase quantity for a modified order

None
fractional_shares bool

Get the maximum fractional share buying power

False

Returns:

Type Description
EstimateMaxPurchaseQuantityResponse

Response

Examples:

::

from longport.openapi import TradeContext, Config, OrderType, OrderSide

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

resp = ctx.estimate_max_purchase_quantity(
    symbol = "700.HK",
    order_type = OrderType.LO,
    side = OrderSide.Buy,
)
print(resp)

fund_positions(symbols=None)

Get fund positions

Parameters:

Name Type Description Default
symbols Optional[List[str]]

Filter by fund codes

None

Returns:

Type Description
FundPositionsResponse

Fund positions

Examples:

::

from longport.openapi import TradeContext, Config

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

resp = ctx.fund_positions()
print(resp)

history_executions(symbol=None, start_at=None, end_at=None)

Get history executions

Parameters:

Name Type Description Default
symbol Optional[str]

Filter by security code, example: 700.HK, AAPL.US

None
start_at Optional[datetime]

Start time

None
end_at Optional[datetime]

End time

None

Returns:

Type Description
List[Execution]

Execution list

Examples:

::

from datetime import datetime
from longport.openapi import TradeContext, Config

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

resp = ctx.history_executions(
    symbol = "700.HK",
    start_at = datetime(2022, 5, 9),
    end_at = datetime(2022, 5, 12),
)
print(resp)

history_orders(symbol=None, status=None, side=None, market=None, start_at=None, end_at=None)

Get history orders

Parameters:

Name Type Description Default
symbol Optional[str]

Filter by security code

None
status Optional[List[Type[OrderStatus]]]

Filter by order status

None
side Optional[Type[OrderSide]]

Filter by order side

None
market Optional[Type[Market]]

Filter by market type

None
start_at Optional[datetime]

Start time

None
end_at Optional[datetime]

End time

None

Returns:

Type Description
List[Order]

Order list

Examples:

::

from datetime import datetime
from longport.openapi import TradeContext, Config, OrderStatus, OrderSide, Market

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

resp = ctx.history_orders(
    symbol = "700.HK",
    status = [OrderStatus.Filled, OrderStatus.New],
    side = OrderSide.Buy,
    market = Market.HK,
    start_at = datetime(2022, 5, 9),
    end_at = datetime(2022, 5, 12),
)
print(resp)

margin_ratio(symbol)

Get margin ratio

Parameters:

Name Type Description Default
symbol str

Security symbol

required

Returns:

Type Description
MarginRatio

Margin ratio

Examples:

::

from longport.openapi import TradeContext, Config

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

resp = ctx.margin_ratio("700.HK")
print(resp)

order_detail(order_id)

Get order detail

Parameters:

Name Type Description Default
order id

Order id

required

Returns:

Type Description
OrderDetail

Order detail

Examples:

::

from longport.openapi import TradeContext, Config

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

resp = ctx.order_detail("701276261045858304")
print(resp)

replace_order(order_id, quantity, price=None, trigger_price=None, limit_offset=None, trailing_amount=None, trailing_percent=None, remark=None)

Replace order

Parameters:

Name Type Description Default
quantity Decimal

Replaced quantity

required
price Optional[Decimal]

Replaced price

None
trigger_price Optional[Decimal]

Trigger price (LIT / MIT Order Required)

None
limit_offset Optional[Decimal]

Limit offset amount (TSLPAMT / TSLPPCT Required)

None
trailing_amount Optional[Decimal]

Trailing amount (TSLPAMT / TSMAMT Required)

None
trailing_percent Optional[Decimal]

Trailing percent (TSLPPCT / TSMAPCT Required)

None
remark Optional[str]

Remark (Maximum 64 characters)

None

Examples:

::

from decimal import Decimal
from longport.openapi import TradeContext, Config

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

ctx.replace_order(
    order_id = "709043056541253632",
    quantity = Decimal(100),
    price = Decimal(100),
)

set_on_order_changed(callback)

Set order changed callback, after receiving the order changed event, it will call back to this function.

stock_positions(symbols=None)

Get stock positions

Parameters:

Name Type Description Default
symbols Optional[List[str]]

Filter by stock codes

None

Returns:

Type Description
StockPositionsResponse

Stock positions

Examples:

::

from longport.openapi import TradeContext, Config

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

resp = ctx.stock_positions()
print(resp)

submit_order(symbol, order_type, side, submitted_quantity, time_in_force, submitted_price=None, trigger_price=None, limit_offset=None, trailing_amount=None, trailing_percent=None, expire_date=None, outside_rth=None, remark=None)

Submit order

Parameters:

Name Type Description Default
symbol str

Security code

required
order_type Type[OrderType]

Order type

required
side Type[OrderSide]

Order Side

required
submitted_quantity Decimal

Submitted quantity

required
time_in_force Type[TimeInForceType]

Time in force type

required
submitted_price Optional[Decimal]

Submitted price

None
trigger_price Optional[Decimal]

Trigger price (LIT / MIT Required)

None
limit_offset Optional[Decimal]

Limit offset amount (TSLPAMT / TSLPPCT Required)

None
trailing_amount Optional[Decimal]

Trailing amount (TSLPAMT / TSMAMT Required)

None
trailing_percent Optional[Decimal]

Trailing percent (TSLPPCT / TSMAPCT Required)

None
expire_date Optional[date]

Long term order expire date (Required when time_in_force is GoodTilDate)

None
outside_rth Optional[Type[OutsideRTH]]

Enable or disable outside regular trading hours

None
remark Optional[str]

Remark (Maximum 64 characters)

None

Returns:

Type Description
SubmitOrderResponse

Response

Examples:

::

from decimal import Decimal
from longport.openapi import TradeContext, Config, OrderSide, OrderType, TimeInForceType

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

resp = ctx.submit_order(
    side = OrderSide.Buy,
    symbol = "700.HK",
    order_type = OrderType.LO,
    submitted_price = Decimal(50),
    submitted_quantity = Decimal(200),
    time_in_force = TimeInForceType.Day,
    remark = "Hello from Python SDK",
)
print(resp)

subscribe(topics)

Subscribe

Parameters:

Name Type Description Default
topics List[Type[TopicType]]

Topic list

required

Examples:

::

from time import sleep
from decimal import Decimal
from longport.openapi import TradeContext, Config, OrderSide, OrderType, TimeInForceType, PushOrderChanged, TopicType


def on_order_changed(event: PushOrderChanged):
    print(event)


config = Config.from_env()
ctx = TradeContext(config)
ctx.set_on_order_changed(on_order_changed)
ctx.subscribe([TopicType.Private])

resp = ctx.submit_order(
    side = OrderSide.Buy,
    symbol = "700.HK",
    order_type = OrderType.LO,
    submitted_price = Decimal(50),
    submitted_quantity = Decimal(200),
    time_in_force = TimeInForceType.Day,
    remark = "Hello from Python SDK",
)
print(resp)
sleep(5)  # waiting for push event

today_executions(symbol=None, order_id=None)

Get today executions

Parameters:

Name Type Description Default
symbol Optional[str]

Filter by security code

None
order_id Optional[str]

Filter by Order ID

None

Returns:

Type Description
List[Execution]

Execution list

Examples:

::

from longport.openapi import TradeContext, Config

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

resp = ctx.today_executions(symbol = "700.HK")
print(resp)

today_orders(symbol=None, status=None, side=None, market=None, order_id=None)

Get today orders

Parameters:

Name Type Description Default
symbol Optional[str]

Filter by security code

None
status Optional[List[Type[OrderStatus]]]

Filter by order status

None
side Optional[Type[OrderSide]]

Filter by order side

None
market Optional[Type[Market]]

Filter by market type

None
order_id Optional[str]

Filter by order id

None

Returns:

Type Description
List[Order]

Order list

Examples:

::

from longport.openapi import TradeContext, Config, OrderStatus, OrderSide, Market

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

resp = ctx.today_orders(
    symbol = "700.HK",
    status = [OrderStatus.Filled, OrderStatus.New],
    side = OrderSide.Buy,
    market = Market.HK,
)
print(resp)

unsubscribe(topics)

Unsubscribe

Parameters:

Name Type Description Default
topics List[Type[TopicType]]

Topic list

required

TradeDirection

Trade direction

Down

Bases: TradeDirection

Down

Neutral

Bases: TradeDirection

Neutral

Up

Bases: TradeDirection

Up

TradeSession

Trade session

Normal

Bases: TradeSession

Trading

Post

Bases: TradeSession

Post-Trading

Pre

Bases: TradeSession

Pre-Trading

TradeStatus

Security Status

CodeMoved

Bases: TradeStatus

Code Moved

Delisted

Bases: TradeStatus

Delisted

Expired

Bases: TradeStatus

Expired

Fuse

Bases: TradeStatus

Fuse

Halted

Bases: TradeStatus

Suspension

Normal

Bases: TradeStatus

Normal

PrepareList

Bases: TradeStatus

Prepare List

SplitStockHalts

Bases: TradeStatus

Split Stock Halts

Suspend

Bases: TradeStatus

Suspend

ToBeOpened

Bases: TradeStatus

To Be Opened

WarrantPrepareList

Bases: TradeStatus

Warrant To BeListed

TradingSessionInfo

The information of trading session

begin_time: time instance-attribute

Being trading time

end_time: time instance-attribute

End trading time

trade_session: Type[TradeSession] instance-attribute

Trading sessions

TriggerStatus

Trigger status

Active

Bases: TriggerStatus

Active

Deactive

Bases: TriggerStatus

Deactive

Released

Bases: TriggerStatus

Released

Unknown

Bases: TriggerStatus

Unknown

WarrantInfo

Warrant info

balance_point: Optional[Decimal] instance-attribute

Breakeven point

call_price: Optional[Decimal] instance-attribute

Call price

change_rate: Decimal instance-attribute

Quote change rate

change_value: Decimal instance-attribute

Quote change

conversion_ratio: Optional[Decimal] instance-attribute

Conversion ratio

delta: Optional[Decimal] instance-attribute

Greek value delta

effective_leverage: Optional[Decimal] instance-attribute

Effective leverage

expiry_date: date instance-attribute

Expiry date

implied_volatility: Optional[Decimal] instance-attribute

Implied volatility

itm_otm: Optional[Decimal] instance-attribute

In/out of the bound

last_done: Decimal instance-attribute

Latest price

leverage_ratio: Decimal instance-attribute

Leverage ratio

lower_strike_price: Optional[Decimal] instance-attribute

Lower strike price

name: str instance-attribute

Security name

outstanding_qty: int instance-attribute

Outstanding quantity

outstanding_ratio: Decimal instance-attribute

Outstanding ratio

premium: Decimal instance-attribute

Premium

status: Type[WarrantStatus] instance-attribute

Status

strike_price: Optional[Decimal] instance-attribute

Strike price

symbol: str instance-attribute

Security code

to_call_price: Optional[Decimal] instance-attribute

Price interval from the call price

turnover: Decimal instance-attribute

Turnover

upper_strike_price: Optional[Decimal] instance-attribute

Upper strike price

volume: int instance-attribute

Volume

warrant_type: Type[WarrantType] instance-attribute

Warrant type

WarrantQuote

Quote of warrant

call_price: Decimal instance-attribute

Call price

category: Type[WarrantType] instance-attribute

Warrant type

conversion_ratio: Decimal instance-attribute

Conversion ratio

expiry_date: date instance-attribute

Exprity date

high: Decimal instance-attribute

High

implied_volatility: Decimal instance-attribute

Implied volatility

last_done: Decimal instance-attribute

Latest price

last_trade_date: date instance-attribute

Last tradalbe date

low: Decimal instance-attribute

Low

lower_strike_price: Decimal instance-attribute

Lower bound price

open: Decimal instance-attribute

Open

outstanding_quantity: int instance-attribute

Outstanding quantity

outstanding_ratio: Decimal instance-attribute

Outstanding ratio

prev_close: Decimal instance-attribute

Yesterday's close

strike_price: Decimal instance-attribute

Strike price

symbol: str instance-attribute

Security code

timestamp: datetime instance-attribute

Time of latest price

trade_status: Type[TradeStatus] instance-attribute

Security trading status

turnover: Decimal instance-attribute

Turnover

underlying_symbol: str instance-attribute

Underlying security symbol of the warrant

upper_strike_price: Decimal instance-attribute

Upper bound price

volume: int instance-attribute

Volume

WarrantSortBy

Warrant sort by

BalancePoint

Bases: WarrantSortBy

Breakeven point

CallPrice

Bases: WarrantSortBy

Call price

ChangeRate

Bases: WarrantSortBy

Change rate

ChangeValue

Bases: WarrantSortBy

Change value

ConversionRatio

Bases: WarrantSortBy

Conversion ratio

Delta

Bases: WarrantSortBy

Greek value delta

EffectiveLeverage

Bases: WarrantSortBy

Effective leverage

ExpiryDate

Bases: WarrantSortBy

Expiry date

ImpliedVolatility

Bases: WarrantSortBy

Implied volatility

ItmOtm

Bases: WarrantSortBy

In/out of the bound

LastDone

Bases: WarrantSortBy

LastDone

LeverageRatio

Bases: WarrantSortBy

Leverage ratio

LowerStrikePrice

Bases: WarrantSortBy

Lower strike price

OutstandingQuantity

Bases: WarrantSortBy

Outstanding quantity

OutstandingRatio

Bases: WarrantSortBy

Outstanding ratio

Premium

Bases: WarrantSortBy

Premium

Status

Bases: WarrantSortBy

Status

StrikePrice

Bases: WarrantSortBy

Strike price

ToCallPrice

Bases: WarrantSortBy

Price interval from the call price

Turnover

Bases: WarrantSortBy

Turnover

UpperStrikePrice

Bases: WarrantSortBy

Upper strike price

Volume

Bases: WarrantSortBy

Volume

WarrantStatus

Warrant status

Normal

Bases: WarrantStatus

Normal

PrepareList

Bases: WarrantStatus

Prepare List

Suspend

Bases: WarrantStatus

Suspend

WarrantType

Warrant type

Bear

Bases: WarrantType

Bear

Bull

Bases: WarrantType

Bull

Call

Bases: WarrantType

Call

Inline

Bases: WarrantType

Inline

Put

Bases: WarrantType

Put

Unknown

Bases: WarrantType

Unknown

WatchlistGroup

id: int instance-attribute

Group id

name: str instance-attribute

Group name

securities: List[WatchlistSecurity] instance-attribute

Securities

WatchlistSecurity

Watchlist security

market: Market instance-attribute

Market

name: str instance-attribute

Security name

symbol: str instance-attribute

Security symbol

watched_at: datetime instance-attribute

Watched time

watched_price: Optional[Decimal] instance-attribute

Watched price