Place Order

post

https://openapi.tigerfintech.com/api/v1/orders

Place Common Order

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

accountId

string

required

idempotencyKey

string

required

symbol

string

required

Stock/futures symbol，examples：AAPL, 00700, SG9999005961.SGD

orderType

string

enum

required

Order type. MKT=Market, LMT=Limit, STP=Stop, STP_LMT=Stop-Limit, TRAIL=Trailing Stop, VWAP=VWAP, TWAP=TWAP, AM=HK Opening/Closing Auction, AL=HK Auction Limit, ICEBERG=Iceberg order.

action

string

enum

required

Order side.

Allowed:

secType

string

enum

required

Security type. STK=Stock, OPT=Option, WAR=Warrant, IOPT=Inline warrant/CBBC, CASH=Forex spot, FUT=Futures, FOP=Futures option, FUND=Fund, FOREX=Forex derivative, MLEG=Multi-leg, CC=Crypto/Digital assets.

quantity

integer

number of shares of stock or lots of futures/options

quantityScale

integer

scale of quantity. if real quantity is 0.1, can set quantity=1 and quantityScale=10

strike

string

options, warrants, strike price,example: 100.0

expiry

string

options, warrants,expiration time, format: yyyyMMdd

right

string

enum

options, warrants right.

Allowed:

timeInForce

string

enum

Time in force，can be "DAY", "GTC"(good til cancel), "GTD"(good til date), Default value:DAY, FUND Order will always set to GTC.

Allowed:

price

number

Limit price, required when orderType is LMT, STP_LMT, optional when VWAP, TWAP (if the limit price is filled in, the order will be filled according to the limit price)

cashAmount

number

Fund Order Required. The Amount of the order.

stopLossPrice

number

Order Stop Price Required when orderType is STP/STP_LMT

commission

number

Fund Order Required. The order commission.

outsideRth

boolean

Whether to allow pre and after hours trading, false allows only intraday trading, true allows pre and after hours trading, default value is true. Hong Kong stocks set to true means pre-market bidding.

source

string

upfrontProportion

number

upfront fee proportion. if 1%, pass 0.01

isInternalFee

boolean

is internal fee, default False

userMark

string

user remark info

attachType

string

enum

Attached order type. Only supported for STK/OPT/FUT; main order must be LMT, MKT, STP_LMT, or STP.

Allowed:

profitTakerIdempotencyKey

string

required when 'attachType' is 'PROFIT' or 'BRACKETS'

profitTakerPrice

number

take profit order's limit price, required when 'attachType' is 'PROFIT' or 'BRACKETS'

profitTakerTif

string

enum

Time in force，Default value:DAY

Allowed:

profitTakerRth

boolean

take profit order's 'outsideRth', Default value:true

stopLossOrderType

string

enum

Stop loss order type, required when attachType is LOSS or BRACKETS.

Allowed:

stopLossIdempotencyKey

string

required when 'attachType' is 'LOSS' or 'BRACKETS'

stopLossTriggerPrice

number

stop loss order's trigger price, required when 'attachType' is 'LOSS' or 'BRACKETS'

stopLossLimitPrice

number

stop loss order's limit price'

stopLossTif

string

enum

Time in force，Default value:DAY

Allowed:

stopLossRth

boolean

stop loss order's 'outsideRth', Default value:true

trailType

string

enum

Trail type of TRAIL order.

Allowed:

trailAmount

number

Trailing stop condition value, when trailType is PERCENT.
for example, set 25.15%, then trailAmount should be 25.15

expireTime

number

Expire time of GTD order

comboType

string

enum

Option combo type

contracts

array of objects

Contracts list, only required when comboType was set. example: [
{
"symbol": "TSLA",
"secType": "OPT",
"expiry": "20240621",
"strike": 170,
"right": "CALL",
"action": "BUY",
"ratio": 1
},
{
"symbol": "TSLA",
"secType": "OPT",
"expiry": "20240621",
"strike": 175,
"right": "CALL",
"action": "SELL",
"ratio": 1
}
]

contracts

wapStartTime

int64

(TWAP and VWAP specific) Effective start time (13-digit timestamp). like: 1726135200000

wapEndTime

int64

(TWAP and VWAP specific) Effective end time (13-digit timestamp)

participationRate

double

0.01 to 0.5

(VWAP-specific) participation rate. valid value: 0.01 ~ 0.5

displaySize

integer

(ICEBERG-specific) The displayed quantity for an iceberg order. Must be less than totalQuantity. The order book will only show this many shares at a time.

minDisplaySize

integer

(ICEBERG-specific) Minimum display size for an iceberg order. When the remaining quantity falls below displaySize, this value is used instead.

checkIntervals

integer

(ICEBERG-specific) Time interval in seconds between each price check/refresh cycle for the iceberg order.

tradingSessionType

string

enum

Trading session type. Controls whether the order participates in extended-hours sessions. PRE_RTH_POST: pre-market + regular + post-market; RTH: regular trading hours only; OVERNIGHT: overnight session; FULL: all sessions; HK_AUC: HK auction session; HK_CTS: HK continuous trading; HK_AUC_CTS: HK auction + continuous.

Allowed:

Headers

Authorization

string

required

The token obtained from the /oauth2/v1/token endpoint

X-TIGR-UID

string

required

The Tiger user who initiated the request, usually is the advisor

Response

200OK