Contracts and Orders

Example context

import { createClientConfig, TradeClient } from '@tigeropenapi/tigeropen';

const config = createClientConfig();
const tradeClient = TradeClient.fromConfig(config, config.account, config.secretKey);

`fromConfig`

Signature

static fromConfig(config: ClientConfig, account: string, secretKey?: string): TradeClient

Purpose

Creates a client from ClientConfig.

Parameters, defaults, and constraints

Parameter	Type	Required	SDK default	Constraints
`config`	`ClientConfig`	Yes	None	None.
`config.tigerId`	`string`	Yes	None	None.
`config.privateKey`	`string`	Yes	None	None.
`config.account`	`string`	Yes	None	None.
`config.secretKey`	`string \| undefined`	No	None	Institution secret key for trade authentication (institution accounts only)
`config.license`	`string \| undefined`	No	None	None.
`config.language`	`string`	Yes	None	None.
`config.timezone`	`string \| undefined`	No	None	None.
`config.timeout`	`number`	Yes	None	None.
`config.token`	`string \| undefined`	No	None	None.
`config.tokenRefreshDuration`	`number \| undefined`	No	None	None.
`config.tokenCheckInterval`	`number \| undefined`	No	None	Background token check interval in milliseconds; active only when tokenRefreshDuration > 0; default 5 minutes
`config.tokenLoader`	Optional function returning a string or a string Promise	No	None	Custom token loader replacing default file loading; see `ClientConfig` in the signature above for the exact type
`config.tokenWriter`	`((token: string) => void) \| undefined`	No	None	Optional callback after writing a refreshed token
`config.serverUrl`	`string`	Yes	None	None.
`config.quoteServerUrl`	`string`	Yes	None	Quote server URL for quote-specific requests; falls back to serverUrl
`config.deviceId`	`string`	Yes	None	Device identifier (auto-detected MAC address)
`config.tigerPublicKey`	`string`	Yes	None	None.
`account`	`string`	Yes	None	None.
`secretKey`	`string`	No	None	None.

Returns

TradeClient

Type-checked example

const result = await TradeClient.fromConfig(config, config.account, config.secretKey);
console.log(result);

Response example

"TradeClient instance (not an API response payload)"

`getContract`

Signature

async getContract(symbol: string, secType: string): Promise<Contract[]>

Purpose

Gets contract.

Parameters, defaults, and constraints

Parameter	Type	Required	SDK default	Constraints
`symbol`	`string`	Yes	None	None.
`secType`	`string`	Yes	None	None.

Returns

Promise<Contract[]>

Field	Type	Description
contractId	number	Contract ID
symbol	string	Symbol code
secType	string	Security type
currency	string	Currency
exchange	string	Exchange
primaryExchange	string	Primary exchange
localSymbol	string	Local symbol
tradingClass	string	Trading class
expiry	string	Expiration date
strike	number	Strike price
right	string	Option right (CALL/PUT)
multiplier	number	Contract multiplier
identifier	string	Identifier
name	string	Name
market	string	Market
tradeable	boolean	Whether tradeable
conid	number	Contract sequence number
status	number	Trading status
marginable	boolean	Whether marginable
shortable	boolean	Whether shortable
closeOnly	boolean	Whether close-only
isEtf	boolean	Whether ETF
supportOvernightTrading	boolean	Whether supports overnight trading
supportFractionalShare	boolean	Whether supports fractional shares
shortMargin	number	Short margin
shortInitialMargin	number	Short initial margin
shortMaintenanceMargin	number	Short maintenance margin
longInitialMargin	number	Long initial margin
longMaintenanceMargin	number	Long maintenance margin
tickSizes	TickSize[]	Tick sizes list
lotSize	number	Lot size

Type-checked example

const result = await tradeClient.getContract('AAPL', 'STK');
console.log(result);

Response example

[
  {
    "contractId": 0,
    "symbol": "string",
    "secType": "string",
    "currency": "string",
    "exchange": "string",
    "primaryExchange": "string",
    "localSymbol": "string",
    "tradingClass": "string",
    "expiry": "string",
    "strike": 0,
    "right": "string",
    "multiplier": 0,
    "identifier": "string",
    "name": "string",
    "market": "string",
    "tradeable": true,
    "conid": 0,
    "status": 0,
    "marginable": true,
    "shortable": true,
    "closeOnly": true,
    "isEtf": true,
    "supportOvernightTrading": true,
    "supportFractionalShare": true,
    "shortMargin": 0,
    "shortInitialMargin": 0,
    "shortMaintenanceMargin": 0,
    "longInitialMargin": 0,
    "longMaintenanceMargin": 0,
    "tickSizes": [
      "TickSize"
    ],
    "lotSize": 0
  }
]

Rate limit: The base limit is 60 requests per minute.

`getContracts`

Signature

async getContracts(symbols: string[], secType: string): Promise<Contract[]>

Purpose

Gets contracts.

Parameters, defaults, and constraints

Parameter	Type	Required	SDK default	Constraints
`symbols`	`string[]`	Yes	None	None.
`secType`	`string`	Yes	None	None.

Returns

Promise<Contract[]>

Field	Type	Description
contractId	number	Contract ID
symbol	string	Symbol code
secType	string	Security type
currency	string	Currency
exchange	string	Exchange
primaryExchange	string	Primary exchange
localSymbol	string	Local symbol
tradingClass	string	Trading class
expiry	string	Expiration date
strike	number	Strike price
right	string	Option right (CALL/PUT)
multiplier	number	Contract multiplier
identifier	string	Identifier
name	string	Name
market	string	Market
tradeable	boolean	Whether tradeable
conid	number	Contract sequence number
status	number	Trading status
marginable	boolean	Whether marginable
shortable	boolean	Whether shortable
closeOnly	boolean	Whether close-only
isEtf	boolean	Whether ETF
supportOvernightTrading	boolean	Whether supports overnight trading
supportFractionalShare	boolean	Whether supports fractional shares
shortMargin	number	Short margin
shortInitialMargin	number	Short initial margin
shortMaintenanceMargin	number	Short maintenance margin
longInitialMargin	number	Long initial margin
longMaintenanceMargin	number	Long maintenance margin
tickSizes	TickSize[]	Tick sizes list
lotSize	number	Lot size

Type-checked example

const result = await tradeClient.getContracts(['AAPL'], 'STK');
console.log(result);

Response example

[
  {
    "contractId": 0,
    "symbol": "string",
    "secType": "string",
    "currency": "string",
    "exchange": "string",
    "primaryExchange": "string",
    "localSymbol": "string",
    "tradingClass": "string",
    "expiry": "string",
    "strike": 0,
    "right": "string",
    "multiplier": 0,
    "identifier": "string",
    "name": "string",
    "market": "string",
    "tradeable": true,
    "conid": 0,
    "status": 0,
    "marginable": true,
    "shortable": true,
    "closeOnly": true,
    "isEtf": true,
    "supportOvernightTrading": true,
    "supportFractionalShare": true,
    "shortMargin": 0,
    "shortInitialMargin": 0,
    "shortMaintenanceMargin": 0,
    "longInitialMargin": 0,
    "longMaintenanceMargin": 0,
    "tickSizes": [
      "TickSize"
    ],
    "lotSize": 0
  }
]

Rate limit: The base limit is 60 requests per minute.

`getQuoteContract`

Signature

async getQuoteContract(symbol: string, secType: string, expiry: string): Promise<Contract[]>

Purpose

Gets quote contract.

Parameters, defaults, and constraints

Parameter	Type	Required	SDK default	Constraints
`symbol`	`string`	Yes	None	None.
`secType`	`string`	Yes	None	None.
`expiry`	`string`	Yes	None	None.

Returns

Promise<Contract[]>

Field	Type	Description
contractId	number	Contract ID
symbol	string	Symbol code
secType	string	Security type
currency	string	Currency
exchange	string	Exchange
primaryExchange	string	Primary exchange
localSymbol	string	Local symbol
tradingClass	string	Trading class
expiry	string	Expiration date
strike	number	Strike price
right	string	Option right (CALL/PUT)
multiplier	number	Contract multiplier
identifier	string	Identifier
name	string	Name
market	string	Market
tradeable	boolean	Whether tradeable
conid	number	Contract sequence number
status	number	Trading status
marginable	boolean	Whether marginable
shortable	boolean	Whether shortable
closeOnly	boolean	Whether close-only
isEtf	boolean	Whether ETF
supportOvernightTrading	boolean	Whether supports overnight trading
supportFractionalShare	boolean	Whether supports fractional shares
shortMargin	number	Short margin
shortInitialMargin	number	Short initial margin
shortMaintenanceMargin	number	Short maintenance margin
longInitialMargin	number	Long initial margin
longMaintenanceMargin	number	Long maintenance margin
tickSizes	TickSize[]	Tick sizes list
lotSize	number	Lot size

Type-checked example

const result = await tradeClient.getQuoteContract('AAPL', 'STK', '20260619');
console.log(result);

Response example

[
  {
    "contractId": 0,
    "symbol": "string",
    "secType": "string",
    "currency": "string",
    "exchange": "string",
    "primaryExchange": "string",
    "localSymbol": "string",
    "tradingClass": "string",
    "expiry": "string",
    "strike": 0,
    "right": "string",
    "multiplier": 0,
    "identifier": "string",
    "name": "string",
    "market": "string",
    "tradeable": true,
    "conid": 0,
    "status": 0,
    "marginable": true,
    "shortable": true,
    "closeOnly": true,
    "isEtf": true,
    "supportOvernightTrading": true,
    "supportFractionalShare": true,
    "shortMargin": 0,
    "shortInitialMargin": 0,
    "shortMaintenanceMargin": 0,
    "longInitialMargin": 0,
    "longMaintenanceMargin": 0,
    "tickSizes": [
      "TickSize"
    ],
    "lotSize": 0
  }
]

Rate limit: The base limit is 60 requests per minute.

`getDerivativeContracts`

Signature

async getDerivativeContracts(req: DerivativeContractsRequest): Promise<Contract[]>

Purpose

Gets derivative contracts.

Parameters, defaults, and constraints

Parameter	Type	Required	SDK default	Constraints
`req`	`DerivativeContractsRequest`	Yes	None	None.
`req.account`	`string \| undefined`	No	TradeClient account when omitted or empty	None.
`req.secretKey`	`string \| undefined`	No	None	Institution account secret key. Overrides the default set in ClientConfig; omit to use the config default.
`req.symbols`	`string[]`	Yes	None	None.
`req.secType`	`string`	Yes	None	None.
`req.expiry`	`string \| undefined`	No	None	None.
`req.lang`	`string \| undefined`	No	None	None.

Returns

Promise<Contract[]>

Field	Type	Description
contractId	number	Contract ID
symbol	string	Symbol code
secType	string	Security type
currency	string	Currency
exchange	string	Exchange
primaryExchange	string	Primary exchange
localSymbol	string	Local symbol
tradingClass	string	Trading class
expiry	string	Expiration date
strike	number	Strike price
right	string	Option right (CALL/PUT)
multiplier	number	Contract multiplier
identifier	string	Identifier
name	string	Name
market	string	Market
tradeable	boolean	Whether tradeable
conid	number	Contract sequence number
status	number	Trading status
marginable	boolean	Whether marginable
shortable	boolean	Whether shortable
closeOnly	boolean	Whether close-only
isEtf	boolean	Whether ETF
supportOvernightTrading	boolean	Whether supports overnight trading
supportFractionalShare	boolean	Whether supports fractional shares
shortMargin	number	Short margin
shortInitialMargin	number	Short initial margin
shortMaintenanceMargin	number	Short maintenance margin
longInitialMargin	number	Long initial margin
longMaintenanceMargin	number	Long maintenance margin
tickSizes	TickSize[]	Tick sizes list
lotSize	number	Lot size

Type-checked example

const result = await tradeClient.getDerivativeContracts({ symbols: ['AAPL'], secType: 'STK' });
console.log(result);

Response example

[
  {
    "contractId": 0,
    "symbol": "string",
    "secType": "string",
    "currency": "string",
    "exchange": "string",
    "primaryExchange": "string",
    "localSymbol": "string",
    "tradingClass": "string",
    "expiry": "string",
    "strike": 0,
    "right": "string",
    "multiplier": 0,
    "identifier": "string",
    "name": "string",
    "market": "string",
    "tradeable": true,
    "conid": 0,
    "status": 0,
    "marginable": true,
    "shortable": true,
    "closeOnly": true,
    "isEtf": true,
    "supportOvernightTrading": true,
    "supportFractionalShare": true,
    "shortMargin": 0,
    "shortInitialMargin": 0,
    "shortMaintenanceMargin": 0,
    "longInitialMargin": 0,
    "longMaintenanceMargin": 0,
    "tickSizes": [
      "TickSize"
    ],
    "lotSize": 0
  }
]

Rate limit: The base limit is 60 requests per minute.

`placeOrder`

Signature

async placeOrder(order: OrderRequest): Promise<PlaceOrderResult | undefined>

Purpose

Submits a order request.

Parameters, defaults, and constraints

Parameter	Type	Required	SDK default	Constraints
`order`	`OrderRequest`	Yes	None	None.

Returns

Promise<PlaceOrderResult | undefined>

Field	Type	Description
id	`number \| string`	Global order ID; required by the SDK model
order_id?	`number \| string`	Account-level order ID
subIds?	`(number \| string)[]`	Sub-order IDs, returned only for applicable order structures
orders?	`Order[]`	Orders, present only when returned by the server

Type-checked example

const result = await tradeClient.placeOrder({ action: 'BUY', orderType: 'LMT', totalQuantity: 1, timeInForce: 'DAY', symbol: 'AAPL', secType: 'STK' });
console.log(result);

Response example

{
  "id": "31234567890123456",
  "order_id": 10423876
}

Rate limit: The base limit is 120 requests per minute.

`previewOrder`

Signature

async previewOrder(order: OrderRequest): Promise<PreviewResult | undefined>

Purpose

Performs preview order.

Parameters, defaults, and constraints

Parameter	Type	Required	SDK default	Constraints
`order`	`OrderRequest`	Yes	None	None.

Returns

Promise<PreviewResult | undefined>

Field	Type	Description
account	string	Account
isPass	boolean	Whether passed
commission	number	Commission; may be omitted; `0` is numeric zero
commissionCurrency	string	Commission currency
marginCurrency	string	Margin currency
initMargin	number	Initial margin
initMarginBefore	number	Initial margin before
maintMargin	number	Maintenance margin
maintMarginBefore	number	Maintenance margin before
equityWithLoan	number	Equity with loan
equityWithLoanBefore	number	Equity with loan before
availableEE	number	Available excess equity after the hypothetical fill, in `marginCurrency`; may be omitted when not applicable
excessLiquidity	number	Excess liquidity after the hypothetical fill, in `marginCurrency`; may be omitted when not applicable
overnightLiquidation	number	Overnight excess liquidity after the hypothetical fill, in `marginCurrency`; may be omitted when not applicable
gst	number	Goods and services tax; may be omitted; `0` is numeric zero
message	string	Message

Type-checked example

const result = await tradeClient.previewOrder({ action: 'BUY', orderType: 'LMT', totalQuantity: 1, timeInForce: 'DAY', symbol: 'AAPL', secType: 'STK' });
console.log(result);

Response example

{
  "account": "string",
  "isPass": true,
  "commission": 0,
  "commissionCurrency": "string",
  "marginCurrency": "string",
  "initMargin": 0,
  "initMarginBefore": 0,
  "maintMargin": 0,
  "maintMarginBefore": 0,
  "equityWithLoan": 0,
  "equityWithLoanBefore": 0,
  "availableEE": 0,
  "excessLiquidity": 0,
  "overnightLiquidation": 0,
  "gst": 0,
  "message": "string"
}

`modifyOrder`

Signature

async modifyOrder(id: number | string, order: OrderRequest): Promise<OrderIdResult | undefined>

Purpose

Modifies order.

Parameters, defaults, and constraints

Parameter	Type	Required	SDK default	Constraints
`id`	`number \| string`	Yes	None	None.
`order`	`OrderRequest`	Yes	None	None.

Returns

Promise<OrderIdResult | undefined>

Field	Type	Description
id	`number \| string`	Order ID

The returned ID confirms only that the modify request was submitted. Continue querying the order: replaceStatus=REPLACED confirms success, FAILED confirms failure, and other values remain intermediate and must be interpreted with status.

Type-checked example

const result = await tradeClient.modifyOrder(1, { action: 'BUY', orderType: 'LMT', totalQuantity: 1, timeInForce: 'DAY', symbol: 'AAPL', secType: 'STK' });
console.log(result);

Response example

{
  "id": 12345
}

Rate limit: The base limit is 120 requests per minute.

`cancelOrder`

Signature

async cancelOrder(id: number | string, secretKey?: string): Promise<OrderIdResult | undefined>

Purpose

Cancels order.

Parameters, defaults, and constraints

Parameter	Type	Required	SDK default	Constraints
`id`	`number \| string`	Yes	None	None.
`secretKey`	`string`	No	None	None.

Returns

Promise<OrderIdResult | undefined>

Field	Type	Description
id	`number \| string`	Order ID

The returned ID confirms only that the cancellation request was submitted. Continue querying until status=Cancelled or the order reaches another final state, such as a fill that completed first; do not treat cancelStatus=RECEIVED as completion.

Type-checked example

const result = await tradeClient.cancelOrder(1, config.secretKey);
console.log(result);

Response example

{
  "id": 12345
}

Rate limit: The base limit is 120 requests per minute.

`getOrders`

Signature

async getOrders(req?: OrdersRequest): Promise<Order[]>

Purpose

Gets orders.

Parameters, defaults, and constraints

Parameter	Type	Required	SDK default	Constraints
`req`	`OrdersRequest`	No	None	None.
`req.account`	`string \| undefined`	No	TradeClient account when omitted or empty	None.
`req.secretKey`	`string \| undefined`	No	None	Institution account secret key. Overrides the default set in ClientConfig; omit to use the config default.
`req.secType`	`string \| undefined`	No	None	None.
`req.market`	`string \| undefined`	No	None	None.
`req.symbol`	`string \| undefined`	No	None	None.
`req.startDate`	`number \| undefined`	No	None	Unix timestamp in milliseconds
`req.endDate`	`number \| undefined`	No	None	Unix timestamp in milliseconds
`req.limit`	`number \| undefined`	No	None	None.
`req.isBrief`	`boolean \| undefined`	No	None	None.
`req.states`	`string[] \| undefined`	No	None	Order status filter: Invalid / Initial / PendingCancel / Cancelled / Submitted / Filled / Inactive / PendingSubmit
`req.sortBy`	`string \| undefined`	No	None	Omnibus accounts only. `LATEST_CREATED`: sorts descending and filters `startDate`/`endDate` by order creation/submission time. `LATEST_STATUS_UPDATED`: sorts descending and filters them by the most recent order status update time. The server defaults to `LATEST_CREATED` when omitted.
`req.segType`	`string \| undefined`	No	None	None.
`req.lang`	`string \| undefined`	No	None	None.
`req.pageToken`	`string \| undefined`	No	None	None.
`req.parentId`	`number \| undefined`	No	None	Used only by getActiveOrders to filter attached orders by parent ID

Time range: startDate and endDate are optional; an omitted bound adds no filter for that side. The interface has no maximum time span, but per-response result limits still apply. Use a reasonably bounded range.

Returns

Promise<Order[]>

Field	Type	Description
account	string	Account
id	`number \| string`	Order ID
orderId	`number \| string`	Account-level order ID
externalId	string	External ID
action	string	Trade direction (BUY/SELL)
orderType	string	Order type
totalQuantity	number	Total quantity
totalQuantityScale	number	Total quantity scale
filledQuantity	number	Filled quantity
filledQuantityScale	number	Filled quantity scale
filledCashAmount	number	Filled cash amount
limitPrice	number	Limit price
auxPrice	number	Auxiliary price
trailingPercent	number	Trailing percent
status	string	Trading status
avgFillPrice	number	Volume-weighted average of fill prices, excluding commissions and other fees
timeInForce	string	Time in force
outsideRth	boolean	Outside regular trading hours
orderLegs	OrderLeg[]	Order legs
algoParams	AlgoParams	Algorithm parameters
algoStrategy	string	Algorithm strategy
symbol	string	Symbol code
secType	string	Security type
market	string	Market
currency	string	Currency
expiry	string	Expiration date
strike	string	Strike price
right	string	Option right (CALL/PUT)
identifier	string	Identifier
name	string	Name
commission	number	Commission; may be omitted; `0` is numeric zero
gst	number	Goods and services tax; may be omitted; `0` is numeric zero
realizedPnl	number	Realized P&L; commission and GST are returned separately. Refer to the account statement for the exact calculation basis and currency
openTime	number	Open time
updateTime	number	Update time
latestTime	number	Latest trade time (ms timestamp)
latestPrice	number	Latest price
remark	string	Remark
source	string	Source
userMark	string	User mark
liquidation	boolean	Liquidation value
discount	number	Discount
replaceStatus	string	Modify status; `REPLACED` is final success, `FAILED` is failure, and `RECEIVED` only means accepted
cancelStatus	string	Cancellation-request status; `RECEIVED` only means accepted, and the final result comes from order `status`
canModify	boolean	Whether modifiable
canCancel	boolean	Whether cancellable
isOpen	boolean	Whether opening position
orderDiscount	number	Order discount
tradingSessionType	string	Trading session type
attrDesc	string	Attribute description
attrList	string[]	Attribute list

Type-checked example

const result = await tradeClient.getOrders({ market: 'US', secType: 'STK', limit: 100, sortBy: 'LATEST_CREATED' });
console.log(result);

Response example

[
  {
    "account": "string",
    "id": 12345,
    "orderId": 12345,
    "externalId": "string",
    "action": "string",
    "orderType": "string",
    "totalQuantity": 0,
    "totalQuantityScale": 0,
    "filledQuantity": 0,
    "filledQuantityScale": 0,
    "filledCashAmount": 0,
    "limitPrice": 0,
    "auxPrice": 0,
    "trailingPercent": 0,
    "status": "string",
    "avgFillPrice": 0,
    "timeInForce": "string",
    "outsideRth": true,
    "orderLegs": [
      "OrderLeg"
    ],
    "algoParams": {
      "algoStrategy": "string",
      "startTime": "string",
      "endTime": "string",
      "participationRate": 0
    },
    "algoStrategy": "string",
    "symbol": "string",
    "secType": "string",
    "market": "string",
    "currency": "string",
    "expiry": "string",
    "strike": "string",
    "right": "string",
    "identifier": "string",
    "name": "string",
    "commission": 0,
    "gst": 0,
    "realizedPnl": 0,
    "openTime": 0,
    "updateTime": 0,
    "latestTime": 0,
    "latestPrice": 0,
    "remark": "string",
    "source": "string",
    "userMark": "string",
    "liquidation": true,
    "discount": 0,
    "replaceStatus": "string",
    "cancelStatus": "string",
    "canModify": true,
    "canCancel": true,
    "isOpen": true,
    "orderDiscount": 0,
    "tradingSessionType": "string",
    "attrDesc": "string",
    "attrList": [
      "string"
    ]
  }
]

Rate limit: The base limit is 120 requests per minute.

`getActiveOrders`

Signature

async getActiveOrders(req?: OrdersRequest): Promise<Order[]>

Purpose

Gets active orders.

Parameters, defaults, and constraints

Parameter	Type	Required	SDK default	Constraints
`req`	`OrdersRequest`	No	None	None.
`req.account`	`string \| undefined`	No	TradeClient account when omitted or empty	None.
`req.secretKey`	`string \| undefined`	No	None	Institution account secret key. Overrides the default set in ClientConfig; omit to use the config default.
`req.secType`	`string \| undefined`	No	None	None.
`req.market`	`string \| undefined`	No	None	None.
`req.symbol`	`string \| undefined`	No	None	None.
`req.startDate`	`number \| undefined`	No	None	Optional start boundary, as a Unix timestamp in milliseconds
`req.endDate`	`number \| undefined`	No	None	Optional end boundary, as a Unix timestamp in milliseconds
`req.limit`	`number \| undefined`	No	None	None.
`req.isBrief`	`boolean \| undefined`	No	None	None.
`req.states`	`string[] \| undefined`	No	None	Order status filter: Invalid / Initial / PendingCancel / Cancelled / Submitted / Filled / Inactive / PendingSubmit
`req.sortBy`	`string \| undefined`	No	None	Omnibus accounts only. `LATEST_CREATED`: sorts descending and filters `startDate`/`endDate` by order creation/submission time. `LATEST_STATUS_UPDATED`: sorts descending and filters them by the most recent order status update time. The server defaults to `LATEST_CREATED` when omitted.
`req.segType`	`string \| undefined`	No	None	None.
`req.lang`	`string \| undefined`	No	None	None.
`req.pageToken`	`string \| undefined`	No	None	None.
`req.parentId`	`number \| undefined`	No	None	Used only by getActiveOrders to filter attached orders by parent ID

Returns

Promise<Order[]>

Field	Type	Description
account	string	Account
id	`number \| string`	Order ID
orderId	`number \| string`	Account-level order ID
externalId	string	External ID
action	string	Trade direction (BUY/SELL)
orderType	string	Order type
totalQuantity	number	Total quantity
totalQuantityScale	number	Total quantity scale
filledQuantity	number	Filled quantity
filledQuantityScale	number	Filled quantity scale
filledCashAmount	number	Filled cash amount
limitPrice	number	Limit price
auxPrice	number	Auxiliary price
trailingPercent	number	Trailing percent
status	string	Trading status
avgFillPrice	number	Volume-weighted average of fill prices, excluding commissions and other fees
timeInForce	string	Time in force
outsideRth	boolean	Outside regular trading hours
orderLegs	OrderLeg[]	Order legs
algoParams	AlgoParams	Algorithm parameters
algoStrategy	string	Algorithm strategy
symbol	string	Symbol code
secType	string	Security type
market	string	Market
currency	string	Currency
expiry	string	Expiration date
strike	string	Strike price
right	string	Option right (CALL/PUT)
identifier	string	Identifier
name	string	Name
commission	number	Commission; may be omitted; `0` is numeric zero
gst	number	Goods and services tax; may be omitted; `0` is numeric zero
realizedPnl	number	Realized P&L; commission and GST are returned separately. Refer to the account statement for the exact calculation basis and currency
openTime	number	Open time
updateTime	number	Update time
latestTime	number	Latest trade time (ms timestamp)
latestPrice	number	Latest price
remark	string	Remark
source	string	Source
userMark	string	User mark
liquidation	boolean	Liquidation value
discount	number	Discount
replaceStatus	string	Modify status; `REPLACED` is final success, `FAILED` is failure, and `RECEIVED` only means accepted
cancelStatus	string	Cancellation-request status; `RECEIVED` only means accepted, and the final result comes from order `status`
canModify	boolean	Whether modifiable
canCancel	boolean	Whether cancellable
isOpen	boolean	Whether opening position
orderDiscount	number	Order discount
tradingSessionType	string	Trading session type
attrDesc	string	Attribute description
attrList	string[]	Attribute list

Type-checked example

const result = await tradeClient.getActiveOrders({ market: 'US', secType: 'STK', symbol: 'AAPL' });
console.log(result);

Response example

[
  {
    "account": "string",
    "id": 12345,
    "orderId": 12345,
    "externalId": "string",
    "action": "string",
    "orderType": "string",
    "totalQuantity": 0,
    "totalQuantityScale": 0,
    "filledQuantity": 0,
    "filledQuantityScale": 0,
    "filledCashAmount": 0,
    "limitPrice": 0,
    "auxPrice": 0,
    "trailingPercent": 0,
    "status": "string",
    "avgFillPrice": 0,
    "timeInForce": "string",
    "outsideRth": true,
    "orderLegs": [
      "OrderLeg"
    ],
    "algoParams": {
      "algoStrategy": "string",
      "startTime": "string",
      "endTime": "string",
      "participationRate": 0
    },
    "algoStrategy": "string",
    "symbol": "string",
    "secType": "string",
    "market": "string",
    "currency": "string",
    "expiry": "string",
    "strike": "string",
    "right": "string",
    "identifier": "string",
    "name": "string",
    "commission": 0,
    "gst": 0,
    "realizedPnl": 0,
    "openTime": 0,
    "updateTime": 0,
    "latestTime": 0,
    "latestPrice": 0,
    "remark": "string",
    "source": "string",
    "userMark": "string",
    "liquidation": true,
    "discount": 0,
    "replaceStatus": "string",
    "cancelStatus": "string",
    "canModify": true,
    "canCancel": true,
    "isOpen": true,
    "orderDiscount": 0,
    "tradingSessionType": "string",
    "attrDesc": "string",
    "attrList": [
      "string"
    ]
  }
]

Rate limit: The base limit is 120 requests per minute.

`getInactiveOrders`

Signature

async getInactiveOrders(req?: OrdersRequest): Promise<Order[]>

Purpose

Gets inactive orders.

Parameters, defaults, and constraints

Parameter	Type	Required	SDK default	Constraints
`req`	`OrdersRequest`	No	None	None.
`req.account`	`string \| undefined`	No	TradeClient account when omitted or empty	None.
`req.secretKey`	`string \| undefined`	No	None	Institution account secret key. Overrides the default set in ClientConfig; omit to use the config default.
`req.secType`	`string \| undefined`	No	None	None.
`req.market`	`string \| undefined`	No	None	None.
`req.symbol`	`string \| undefined`	No	None	None.
`req.startDate`	`number \| undefined`	No	None	Optional start boundary, as a Unix timestamp in milliseconds
`req.endDate`	`number \| undefined`	No	None	Optional end boundary, as a Unix timestamp in milliseconds
`req.limit`	`number \| undefined`	No	None	None.
`req.isBrief`	`boolean \| undefined`	No	None	None.
`req.states`	`string[] \| undefined`	No	None	Order status filter: Invalid / Initial / PendingCancel / Cancelled / Submitted / Filled / Inactive / PendingSubmit
`req.sortBy`	`string \| undefined`	No	None	Omnibus accounts only. `LATEST_CREATED`: sorts descending and filters `startDate`/`endDate` by order creation/submission time. `LATEST_STATUS_UPDATED`: sorts descending and filters them by the most recent order status update time. The server defaults to `LATEST_CREATED` when omitted.
`req.segType`	`string \| undefined`	No	None	None.
`req.lang`	`string \| undefined`	No	None	None.
`req.pageToken`	`string \| undefined`	No	None	None.
`req.parentId`	`number \| undefined`	No	None	Used only by getActiveOrders to filter attached orders by parent ID

Returns

Promise<Order[]>

Field	Type	Description
account	string	Account
id	`number \| string`	Order ID
orderId	`number \| string`	Account-level order ID
externalId	string	External ID
action	string	Trade direction (BUY/SELL)
orderType	string	Order type
totalQuantity	number	Total quantity
totalQuantityScale	number	Total quantity scale
filledQuantity	number	Filled quantity
filledQuantityScale	number	Filled quantity scale
filledCashAmount	number	Filled cash amount
limitPrice	number	Limit price
auxPrice	number	Auxiliary price
trailingPercent	number	Trailing percent
status	string	Trading status
avgFillPrice	number	Volume-weighted average of fill prices, excluding commissions and other fees
timeInForce	string	Time in force
outsideRth	boolean	Outside regular trading hours
orderLegs	OrderLeg[]	Order legs
algoParams	AlgoParams	Algorithm parameters
algoStrategy	string	Algorithm strategy
symbol	string	Symbol code
secType	string	Security type
market	string	Market
currency	string	Currency
expiry	string	Expiration date
strike	string	Strike price
right	string	Option right (CALL/PUT)
identifier	string	Identifier
name	string	Name
commission	number	Commission; may be omitted; `0` is numeric zero
gst	number	Goods and services tax; may be omitted; `0` is numeric zero
realizedPnl	number	Realized P&L; commission and GST are returned separately. Refer to the account statement for the exact calculation basis and currency
openTime	number	Open time
updateTime	number	Update time
latestTime	number	Latest trade time (ms timestamp)
latestPrice	number	Latest price
remark	string	Remark
source	string	Source
userMark	string	User mark
liquidation	boolean	Liquidation value
discount	number	Discount
replaceStatus	string	Modify status; `REPLACED` is final success, `FAILED` is failure, and `RECEIVED` only means accepted
cancelStatus	string	Cancellation-request status; `RECEIVED` only means accepted, and the final result comes from order `status`
canModify	boolean	Whether modifiable
canCancel	boolean	Whether cancellable
isOpen	boolean	Whether opening position
orderDiscount	number	Order discount
tradingSessionType	string	Trading session type
attrDesc	string	Attribute description
attrList	string[]	Attribute list

Type-checked example

const result = await tradeClient.getInactiveOrders({ market: 'US', secType: 'STK', states: ['Cancelled'], limit: 50 });
console.log(result);

Response example

[
  {
    "account": "string",
    "id": 12345,
    "orderId": 12345,
    "externalId": "string",
    "action": "string",
    "orderType": "string",
    "totalQuantity": 0,
    "totalQuantityScale": 0,
    "filledQuantity": 0,
    "filledQuantityScale": 0,
    "filledCashAmount": 0,
    "limitPrice": 0,
    "auxPrice": 0,
    "trailingPercent": 0,
    "status": "string",
    "avgFillPrice": 0,
    "timeInForce": "string",
    "outsideRth": true,
    "orderLegs": [
      "OrderLeg"
    ],
    "algoParams": {
      "algoStrategy": "string",
      "startTime": "string",
      "endTime": "string",
      "participationRate": 0
    },
    "algoStrategy": "string",
    "symbol": "string",
    "secType": "string",
    "market": "string",
    "currency": "string",
    "expiry": "string",
    "strike": "string",
    "right": "string",
    "identifier": "string",
    "name": "string",
    "commission": 0,
    "gst": 0,
    "realizedPnl": 0,
    "openTime": 0,
    "updateTime": 0,
    "latestTime": 0,
    "latestPrice": 0,
    "remark": "string",
    "source": "string",
    "userMark": "string",
    "liquidation": true,
    "discount": 0,
    "replaceStatus": "string",
    "cancelStatus": "string",
    "canModify": true,
    "canCancel": true,
    "isOpen": true,
    "orderDiscount": 0,
    "tradingSessionType": "string",
    "attrDesc": "string",
    "attrList": [
      "string"
    ]
  }
]

Rate limit: The base limit is 120 requests per minute.

`getFilledOrders`

Signature

async getFilledOrders(req?: OrdersRequest): Promise<Order[]>

Purpose

Gets filled orders.

Parameters, defaults, and constraints

Parameter	Type	Required	SDK default	Constraints
`req`	`OrdersRequest`	No	None	None.
`req.account`	`string \| undefined`	No	TradeClient account when omitted or empty	None.
`req.secretKey`	`string \| undefined`	No	None	Institution account secret key. Overrides the default set in ClientConfig; omit to use the config default.
`req.secType`	`string \| undefined`	No	None	None.
`req.market`	`string \| undefined`	No	None	None.
`req.symbol`	`string \| undefined`	No	None	None.
`req.startDate`	`number \| undefined`	Yes	None	Unix timestamp in milliseconds; required together with `endDate`; maximum range: 90 days
`req.endDate`	`number \| undefined`	Yes	None	Unix timestamp in milliseconds; required together with `startDate`; maximum range: 90 days
`req.limit`	`number \| undefined`	No	None	None.
`req.isBrief`	`boolean \| undefined`	No	None	None.
`req.states`	`string[] \| undefined`	No	None	Order status filter: Invalid / Initial / PendingCancel / Cancelled / Submitted / Filled / Inactive / PendingSubmit
`req.sortBy`	`string \| undefined`	No	None	Omnibus accounts only. `LATEST_CREATED`: sorts descending and filters `startDate`/`endDate` by order creation/submission time. `LATEST_STATUS_UPDATED`: sorts descending and filters them by the most recent order status update time. The server defaults to `LATEST_CREATED` when omitted.
`req.segType`	`string \| undefined`	No	None	None.
`req.lang`	`string \| undefined`	No	None	None.
`req.pageToken`	`string \| undefined`	No	None	None.
`req.parentId`	`number \| undefined`	No	None	Used only by getActiveOrders to filter attached orders by parent ID

Returns

Promise<Order[]>

Field	Type	Description
account	string	Account
id	`number \| string`	Order ID
orderId	`number \| string`	Account-level order ID
externalId	string	External ID
action	string	Trade direction (BUY/SELL)
orderType	string	Order type
totalQuantity	number	Total quantity
totalQuantityScale	number	Total quantity scale
filledQuantity	number	Filled quantity
filledQuantityScale	number	Filled quantity scale
filledCashAmount	number	Filled cash amount
limitPrice	number	Limit price
auxPrice	number	Auxiliary price
trailingPercent	number	Trailing percent
status	string	Trading status
avgFillPrice	number	Volume-weighted average of fill prices, excluding commissions and other fees
timeInForce	string	Time in force
outsideRth	boolean	Outside regular trading hours
orderLegs	OrderLeg[]	Order legs
algoParams	AlgoParams	Algorithm parameters
algoStrategy	string	Algorithm strategy
symbol	string	Symbol code
secType	string	Security type
market	string	Market
currency	string	Currency
expiry	string	Expiration date
strike	string	Strike price
right	string	Option right (CALL/PUT)
identifier	string	Identifier
name	string	Name
commission	number	Commission; may be omitted; `0` is numeric zero
gst	number	Goods and services tax; may be omitted; `0` is numeric zero
realizedPnl	number	Realized P&L; commission and GST are returned separately. Refer to the account statement for the exact calculation basis and currency
openTime	number	Open time
updateTime	number	Update time
latestTime	number	Latest trade time (ms timestamp)
latestPrice	number	Latest price
remark	string	Remark
source	string	Source
userMark	string	User mark
liquidation	boolean	Liquidation value
discount	number	Discount
replaceStatus	string	Modify status; `REPLACED` is final success, `FAILED` is failure, and `RECEIVED` only means accepted
cancelStatus	string	Cancellation-request status; `RECEIVED` only means accepted, and the final result comes from order `status`
canModify	boolean	Whether modifiable
canCancel	boolean	Whether cancellable
isOpen	boolean	Whether opening position
orderDiscount	number	Order discount
tradingSessionType	string	Trading session type
attrDesc	string	Attribute description
attrList	string[]	Attribute list

Type-checked example

const result = await tradeClient.getFilledOrders({ market: 'US', secType: 'STK', startDate: Date.now() - 30 * 24 * 60 * 60 * 1000, endDate: Date.now(), limit: 100 });
console.log(result);

Response example

[
  {
    "account": "string",
    "id": 12345,
    "orderId": 12345,
    "externalId": "string",
    "action": "string",
    "orderType": "string",
    "totalQuantity": 0,
    "totalQuantityScale": 0,
    "filledQuantity": 0,
    "filledQuantityScale": 0,
    "filledCashAmount": 0,
    "limitPrice": 0,
    "auxPrice": 0,
    "trailingPercent": 0,
    "status": "string",
    "avgFillPrice": 0,
    "timeInForce": "string",
    "outsideRth": true,
    "orderLegs": [
      "OrderLeg"
    ],
    "algoParams": {
      "algoStrategy": "string",
      "startTime": "string",
      "endTime": "string",
      "participationRate": 0
    },
    "algoStrategy": "string",
    "symbol": "string",
    "secType": "string",
    "market": "string",
    "currency": "string",
    "expiry": "string",
    "strike": "string",
    "right": "string",
    "identifier": "string",
    "name": "string",
    "commission": 0,
    "gst": 0,
    "realizedPnl": 0,
    "openTime": 0,
    "updateTime": 0,
    "latestTime": 0,
    "latestPrice": 0,
    "remark": "string",
    "source": "string",
    "userMark": "string",
    "liquidation": true,
    "discount": 0,
    "replaceStatus": "string",
    "cancelStatus": "string",
    "canModify": true,
    "canCancel": true,
    "isOpen": true,
    "orderDiscount": 0,
    "tradingSessionType": "string",
    "attrDesc": "string",
    "attrList": [
      "string"
    ]
  }
]

Rate limit: The base limit is 120 requests per minute.

`getOrder`

Signature

async getOrder(req: GetOrderRequest): Promise<Order | undefined>

Purpose

Gets order.

Parameters, defaults, and constraints

Parameter	Type	Required	SDK default	Constraints
`req`	`GetOrderRequest`	Yes	None	None.
`req.account`	`string \| undefined`	No	TradeClient account when omitted or empty	None.
`req.secretKey`	`string \| undefined`	No	None	Institution account secret key. Overrides the default set in ClientConfig; omit to use the config default.
`req.id`	`number \| undefined`	No	None	None.
`req.orderId`	`number \| undefined`	No	None	None.
`req.isBrief`	`boolean \| undefined`	No	None	None.
`req.showCharges`	`boolean \| undefined`	No	None	None.
`req.lang`	`string \| undefined`	No	None	None.

Returns

Promise<Order | undefined>

Field	Type	Description
account	string	Account
id	`number \| string`	Order ID
orderId	`number \| string`	Account-level order ID
externalId	string	External ID
action	string	Trade direction (BUY/SELL)
orderType	string	Order type
totalQuantity	number	Total quantity
totalQuantityScale	number	Total quantity scale
filledQuantity	number	Filled quantity
filledQuantityScale	number	Filled quantity scale
filledCashAmount	number	Filled cash amount
limitPrice	number	Limit price
auxPrice	number	Auxiliary price
trailingPercent	number	Trailing percent
status	string	Trading status
avgFillPrice	number	Volume-weighted average of fill prices, excluding commissions and other fees
timeInForce	string	Time in force
outsideRth	boolean	Outside regular trading hours
orderLegs	OrderLeg[]	Order legs
algoParams	AlgoParams	Algorithm parameters
algoStrategy	string	Algorithm strategy
symbol	string	Symbol code
secType	string	Security type
market	string	Market
currency	string	Currency
expiry	string	Expiration date
strike	string	Strike price
right	string	Option right (CALL/PUT)
identifier	string	Identifier
name	string	Name
commission	number	Commission; may be omitted; `0` is numeric zero
gst	number	Goods and services tax; may be omitted; `0` is numeric zero
realizedPnl	number	Realized P&L; commission and GST are returned separately. Refer to the account statement for the exact calculation basis and currency
openTime	number	Open time
updateTime	number	Update time
latestTime	number	Latest trade time (ms timestamp)
latestPrice	number	Latest price
remark	string	Remark
source	string	Source
userMark	string	User mark
liquidation	boolean	Liquidation value
discount	number	Discount
replaceStatus	string	Modify status; `REPLACED` is final success, `FAILED` is failure, and `RECEIVED` only means accepted
cancelStatus	string	Cancellation-request status; `RECEIVED` only means accepted, and the final result comes from order `status`
canModify	boolean	Whether modifiable
canCancel	boolean	Whether cancellable
isOpen	boolean	Whether opening position
orderDiscount	number	Order discount
tradingSessionType	string	Trading session type
attrDesc	string	Attribute description
attrList	string[]	Attribute list

Type-checked example

const result = await tradeClient.getOrder({ orderId: 30854, showCharges: true });
console.log(result);

Response example

{
  "account": "string",
  "id": 12345,
  "orderId": 12345,
  "externalId": "string",
  "action": "string",
  "orderType": "string",
  "totalQuantity": 0,
  "totalQuantityScale": 0,
  "filledQuantity": 0,
  "filledQuantityScale": 0,
  "filledCashAmount": 0,
  "limitPrice": 0,
  "auxPrice": 0,
  "trailingPercent": 0,
  "status": "string",
  "avgFillPrice": 0,
  "timeInForce": "string",
  "outsideRth": true,
  "orderLegs": [
    {
      "legType": "string",
      "price": 0,
      "timeInForce": "string",
      "quantity": 0
    }
  ],
  "algoParams": {
    "algoStrategy": "string",
    "startTime": "string",
    "endTime": "string",
    "participationRate": 0
  },
  "algoStrategy": "string",
  "symbol": "string",
  "secType": "string",
  "market": "string",
  "currency": "string",
  "expiry": "string",
  "strike": "string",
  "right": "string",
  "identifier": "string",
  "name": "string",
  "commission": 0,
  "gst": 0,
  "realizedPnl": 0,
  "openTime": 0,
  "updateTime": 0,
  "latestTime": 0,
  "latestPrice": 0,
  "remark": "string",
  "source": "string",
  "userMark": "string",
  "liquidation": true,
  "discount": 0,
  "replaceStatus": "string",
  "cancelStatus": "string",
  "canModify": true,
  "canCancel": true,
  "isOpen": true,
  "orderDiscount": 0,
  "tradingSessionType": "string",
  "attrDesc": "string",
  "attrList": [
    "string"
  ]
}

Rate limit: The base limit is 120 requests per minute.

`getOrderTransactions`

Signature

async getOrderTransactions(req: OrderTransactionsRequest): Promise<Transaction[]>

Purpose

Gets order transactions.

Parameters, defaults, and constraints

Parameter	Type	Required	SDK default	Constraints
`req`	`OrderTransactionsRequest`	Yes	None	None.
`req.account`	`string \| undefined`	No	TradeClient account when omitted or empty	None.
`req.secretKey`	`string \| undefined`	No	None	Institution account secret key. Overrides the default set in ClientConfig; omit to use the config default.
`req.orderId`	`number \| undefined`	No	None	None.
`req.symbol`	`string \| undefined`	No	None	None.
`req.secType`	`string \| undefined`	No	None	None.
`req.startDate`	`number \| undefined`	No	None	Unix timestamp in milliseconds
`req.endDate`	`number \| undefined`	No	None	Unix timestamp in milliseconds
`req.limit`	`number \| undefined`	No	None	None.
`req.expiry`	`string \| undefined`	No	None	None.
`req.strike`	`number \| undefined`	No	None	None.
`req.putCall`	`string \| undefined`	No	None	None.
`req.lang`	`string \| undefined`	No	None	None.
`req.pageToken`	`string \| undefined`	No	None	None.

Returns

Promise<Transaction[]>

Field	Type	Description
id	number	Order ID
orderId	number	Order ID
accountId	number	Account ID
account	string	Account
symbol	string	Symbol code
secType	string	Security type
market	string	Market
currency	string	Currency
identifier	string	Identifier
action	string	Trade direction (BUY/SELL)
price	number	Price
filledPrice	number	Filled price
quantity	number	Quantity
filledQuantity	number	Filled quantity
filledQuantityScale	number	Filled quantity scale
amount	number	Trading amount
filledAmount	number	Filled amount
commission	number	Commission
transactedAt	string	Transacted at
transactionTime	number	Transaction time
time	number	Time (ms timestamp)

Type-checked example

const result = await tradeClient.getOrderTransactions({ symbol: 'AAPL', secType: 'STK', limit: 100 });
console.log(result);

Response example

[
  {
    "id": 987654,
    "orderId": 100234,
    "accountId": 10001,
    "account": "402901",
    "symbol": "AAPL",
    "secType": "STK",
    "market": "US",
    "currency": "USD",
    "identifier": "AAPL",
    "action": "BUY",
    "price": 195.50,
    "filledPrice": 195.48,
    "quantity": 100,
    "filledQuantity": 100,
    "filledQuantityScale": 0,
    "amount": 19550.0,
    "filledAmount": 19548.0,
    "commission": 1.99,
    "transactedAt": "2025-06-24T15:30:01Z",
    "transactionTime": 1719240601000,
    "time": 1719240601000
  }
]

Rate limit: The base limit is 60 requests per minute.