Securities

Example context

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

const config = createClientConfig();
const quoteClient = QuoteClient.fromConfig(config);

getSymbols

Signature

async getSymbols(req: SymbolsRequest): Promise<string[]>

Purpose

Gets symbols.

Parameters, defaults, and constraints

ParameterTypeRequiredSDK defaultConstraints
reqSymbolsRequestYesNoneNo client-side validation is declared.
req.marketstring | undefinedNoNoneNo client-side validation is declared.
req.secTypestring | undefinedNoNoneNo client-side validation is declared.
req.includeOtcboolean | undefinedNoNoneNo client-side validation is declared.
req.langstring | undefinedNoNoneNo client-side validation is declared.

Returns

Promise<string[]>

Type-checked example

const result = await quoteClient.getSymbols({ market: 'US', secType: 'STK' });
console.log(result);

Response example

[
  "string"
]

getSymbolNames

Signature

async getSymbolNames(req: SymbolsRequest): Promise<SymbolName[]>

Purpose

Gets symbol names.

Parameters, defaults, and constraints

ParameterTypeRequiredSDK defaultConstraints
reqSymbolsRequestYesNoneNo client-side validation is declared.
req.marketstring | undefinedNoNoneNo client-side validation is declared.
req.secTypestring | undefinedNoNoneNo client-side validation is declared.
req.includeOtcboolean | undefinedNoNoneNo client-side validation is declared.
req.langstring | undefinedNoNoneNo client-side validation is declared.

Returns

Promise<SymbolName[]>

FieldTypeDescription
symbolstringSymbol code
namestringName
marketstringMarket

Type-checked example

const result = await quoteClient.getSymbolNames({ market: 'US' });
console.log(result);

Response example

[
  {
    "symbol": "string",
    "name": "string",
    "market": "string"
  }
]

getTradeMetas

Signature

async getTradeMetas(req: TradeMetasRequest): Promise<TradeMeta[]>

Purpose

Gets trade metas.

Parameters, defaults, and constraints

ParameterTypeRequiredSDK defaultConstraints
reqTradeMetasRequestYesNoneNo client-side validation is declared.
req.symbolsstring[] | undefinedNoNoneNo client-side validation is declared.
req.langstring | undefinedNoNoneNo client-side validation is declared.

Returns

Promise<TradeMeta[]>

FieldTypeDescription
symbolstringSymbol code
lotSizenumberLot size
minTicknumberMinimum tick size
spreadScalenumberQuote precision
shortableFlagstringShortable flag
marginableFlagstringMarginable flag

Type-checked example

const result = await quoteClient.getTradeMetas({ symbols: ['AAPL'] });
console.log(result);

Response example

[
  {
    "symbol": "string",
    "lotSize": 0,
    "minTick": 0,
    "spreadScale": 0,
    "shortableFlag": "string",
    "marginableFlag": "string"
  }
]


getRealTimeQuote

Signature

async getRealTimeQuote(req: BriefRequest): Promise<Brief[]>

Purpose

Gets real time quote.

Parameters, defaults, and constraints

ParameterTypeRequiredSDK defaultConstraints
reqBriefRequestYesNoneNo client-side validation is declared.
req.symbolsstring[] | undefinedNoNoneNo client-side validation is declared.
req.includeHourTradingboolean | undefinedNoNoneNo client-side validation is declared.
req.secTypestring | undefinedNoNoneNo client-side validation is declared.
req.langstring | undefinedNoNoneNo client-side validation is declared.

Returns

Promise<Brief[]>

FieldTypeDescription
symbolstringSymbol code
opennumberOpen price
highnumberHigh price
lownumberLow price
closenumberClose price
preClosenumberPrevious close price
latestPricenumberLatest price
latestTimenumberLatest trade time (ms timestamp)
askPricenumberAsk price (best offer)
askSizenumberAsk size
bidPricenumberBid price (best bid)
bidSizenumberBid size
volumenumberTrading volume
statusstringTrading status
adjPreClosenumberAdjusted previous close
changenumberPrice change
changeRatenumberPrice change rate
amplitudenumberAmplitude
expirystringExpiration date
strikestringStrike price
rightstringOption right (CALL/PUT)
multipliernumberContract multiplier
openInterestnumberOpen interest

Type-checked example

const result = await quoteClient.getRealTimeQuote({ symbols: ['AAPL', 'TSLA'] });
console.log(result);

Response example

[
  {
    "symbol": "string",
    "open": 0,
    "high": 0,
    "low": 0,
    "close": 0,
    "preClose": 0,
    "latestPrice": 0,
    "latestTime": 0,
    "askPrice": 0,
    "askSize": 0,
    "bidPrice": 0,
    "bidSize": 0,
    "volume": 0,
    "status": "string",
    "adjPreClose": 0,
    "change": 0,
    "changeRate": 0,
    "amplitude": 0,
    "expiry": "string",
    "strike": "string",
    "right": "string",
    "multiplier": 0,
    "openInterest": 0
  }
]

getDelayedQuote

Signature

async getDelayedQuote(req: StockDelayBriefsRequest): Promise<Brief[]>

Purpose

Gets delayed quote.

Parameters, defaults, and constraints

ParameterTypeRequiredSDK defaultConstraints
reqStockDelayBriefsRequestYesNoneNo client-side validation is declared.
req.symbolsstring[] | undefinedNoNoneNo client-side validation is declared.
req.secTypestring | undefinedNoNoneNo client-side validation is declared.
req.langstring | undefinedNoNoneNo client-side validation is declared.

Returns

Promise<Brief[]>

FieldTypeDescription
symbolstringSymbol code
opennumberOpen price
highnumberHigh price
lownumberLow price
closenumberClose price
preClosenumberPrevious close price
latestPricenumberLatest price
latestTimenumberLatest trade time (ms timestamp)
askPricenumberAsk price (best offer)
askSizenumberAsk size
bidPricenumberBid price (best bid)
bidSizenumberBid size
volumenumberTrading volume
statusstringTrading status
adjPreClosenumberAdjusted previous close
changenumberPrice change
changeRatenumberPrice change rate
amplitudenumberAmplitude
expirystringExpiration date
strikestringStrike price
rightstringOption right (CALL/PUT)
multipliernumberContract multiplier
openInterestnumberOpen interest

Type-checked example

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

Response example

[
  {
    "symbol": "string",
    "open": 0,
    "high": 0,
    "low": 0,
    "close": 0,
    "preClose": 0,
    "latestPrice": 0,
    "latestTime": 0,
    "askPrice": 0,
    "askSize": 0,
    "bidPrice": 0,
    "bidSize": 0,
    "volume": 0,
    "status": "string",
    "adjPreClose": 0,
    "change": 0,
    "changeRate": 0,
    "amplitude": 0,
    "expiry": "string",
    "strike": "string",
    "right": "string",
    "multiplier": 0,
    "openInterest": 0
  }
]

getKline

Signature

async getKline(req: KlineRequest): Promise<Kline[]>

Purpose

Gets kline.

Parameters, defaults, and constraints

ParameterTypeRequiredSDK defaultConstraints
reqKlineRequestYesNoneNo client-side validation is declared.
req.symbolsstring[] | undefinedNoNoneNo client-side validation is declared.
req.periodstring | undefinedNoNoneNo client-side validation is declared.
req.rightstring | undefinedNoNoneNo client-side validation is declared.
req.beginTimenumber | undefinedNoNoneNo client-side validation is declared.
req.endTimenumber | undefinedNoNoneNo client-side validation is declared.
req.limitnumber | undefinedNoNoneNo client-side validation is declared.
req.beginIndexnumber | undefinedNoNoneNo client-side validation is declared.
req.endIndexnumber | undefinedNoNoneNo client-side validation is declared.
req.pageTokenstring | undefinedNoNoneNo client-side validation is declared.
req.tradeSessionstring | undefinedNoNoneNo client-side validation is declared.
req.datestring | undefinedNoNoneNo client-side validation is declared.
req.withFundamentalboolean | undefinedNoNoneNo client-side validation is declared.
req.secTypestring | undefinedNoNoneNo client-side validation is declared.
req.langstring | undefinedNoNoneNo client-side validation is declared.

Returns

Promise<Kline[]>

FieldTypeDescription
symbolstringSymbol code
periodstringK-line period
nextPageTokenstringNext page token
itemsKlineItem[]Data items array

Type-checked example

const result = await quoteClient.getKline({ symbols: ['AAPL'], period: 'day', limit: 100 });
console.log(result);

Response example

[
  {
    "symbol": "string",
    "period": "string",
    "nextPageToken": "string",
    "items": [
      "KlineItem"
    ]
  }
]

getKlineByPage

Signature

async getKlineByPage(req: KlineByPageRequest): Promise<KlineItem[]>

Purpose

Gets kline by page.

Parameters, defaults, and constraints

ParameterTypeRequiredSDK defaultConstraints
reqKlineByPageRequestYesNoneNo client-side validation is declared.
req.symbolstring | undefinedNoNoneNo client-side validation is declared.
req.periodstring | undefinedNoNoneNo client-side validation is declared.
req.beginTimenumber | undefinedNoNoneNo client-side validation is declared.
req.endTimenumber | undefinedNoNoneNo client-side validation is declared.
req.totalSizenumber | undefinedNo1000 (client)No client-side validation is declared.
req.pageSizenumber | undefinedNo200 (client)No client-side validation is declared.
req.rightstring | undefinedNoNoneNo client-side validation is declared.
req.langstring | undefinedNoNoneNo client-side validation is declared.
req.tradeSessionstring | undefinedNoNoneNo client-side validation is declared.

Returns

Promise<KlineItem[]>

FieldTypeDescription
timenumberTime (ms timestamp)
volumenumberTrading volume
opennumberOpen price
closenumberClose price
highnumberHigh price
lownumberLow price
amountnumberTrading amount

Type-checked example

const result = await quoteClient.getKlineByPage({ symbol: 'AAPL', period: 'day', totalSize: 500, pageSize: 200 });
console.log(result);

Response example

[
  {
    "time": 0,
    "volume": 0,
    "open": 0,
    "close": 0,
    "high": 0,
    "low": 0,
    "amount": 0
  }
]

getTimeline

Signature

async getTimeline(symbols: string[]): Promise<Timeline[]>

Purpose

Gets timeline.

Parameters, defaults, and constraints

ParameterTypeRequiredSDK defaultConstraints
symbolsstring[]YesNoneNo client-side validation is declared.

Returns

Promise<Timeline[]>

FieldTypeDescription
symbolstringSymbol code
periodstringK-line period
preClosenumberPrevious close price
intradayTimelineBucketIntraday timeline data
preHoursTimelineBucketPre-market timeline data
afterHoursTimelineBucketAfter-hours timeline data

Type-checked example

const result = await quoteClient.getTimeline(['AAPL']);
console.log(result);

Response example

[
  {
    "symbol": "string",
    "period": "string",
    "preClose": 0,
    "intraday": {
      "items": [
        "TimelineItem"
      ]
    },
    "preHours": {
      "items": [
        "TimelineItem"
      ]
    },
    "afterHours": {
      "items": [
        "TimelineItem"
      ]
    }
  }
]

getTimelineHistory

Signature

async getTimelineHistory(req: TimelineHistoryRequest): Promise<Timeline[]>

Purpose

Gets timeline history.

Parameters, defaults, and constraints

ParameterTypeRequiredSDK defaultConstraints
reqTimelineHistoryRequestYesNoneNo client-side validation is declared.
req.symbolsstring[] | undefinedNoNoneNo client-side validation is declared.
req.datestring | undefinedNoNoneyyyy-MM-dd
req.rightstring | undefinedNoNoneNo client-side validation is declared.
req.tradeSessionstring | undefinedNoNoneNo client-side validation is declared.
req.langstring | undefinedNoNoneNo client-side validation is declared.

Returns

Promise<Timeline[]>

FieldTypeDescription
symbolstringSymbol code
periodstringK-line period
preClosenumberPrevious close price
intradayTimelineBucketIntraday timeline data
preHoursTimelineBucketPre-market timeline data
afterHoursTimelineBucketAfter-hours timeline data

Type-checked example

const result = await quoteClient.getTimelineHistory({ symbols: ['AAPL'], date: '2026-01-02' });
console.log(result);

Response example

[
  {
    "symbol": "string",
    "period": "string",
    "preClose": 0,
    "intraday": {
      "items": [
        "TimelineItem"
      ]
    },
    "preHours": {
      "items": [
        "TimelineItem"
      ]
    },
    "afterHours": {
      "items": [
        "TimelineItem"
      ]
    }
  }
]

getTradeTick

Signature

async getTradeTick(req: TradeTickRequest): Promise<TradeTick[]>

Purpose

Gets trade tick.

Parameters, defaults, and constraints

ParameterTypeRequiredSDK defaultConstraints
reqTradeTickRequestYesNoneNo client-side validation is declared.
req.symbolsstring[] | undefinedNoNoneNo client-side validation is declared.
req.beginIndexnumber | undefinedNoNoneNo client-side validation is declared.
req.endIndexnumber | undefinedNoNoneNo client-side validation is declared.
req.limitnumber | undefinedNoNoneNo client-side validation is declared.
req.langstring | undefinedNoNoneNo client-side validation is declared.

Returns

Promise<TradeTick[]>

FieldTypeDescription
symbolstringSymbol code
beginIndexnumberBegin index
endIndexnumberEnd index
itemsTradeTickItem[]Data items array

Type-checked example

const result = await quoteClient.getTradeTick({ symbols: ['AAPL'], limit: 100 });
console.log(result);

Response example

[
  {
    "symbol": "string",
    "beginIndex": 0,
    "endIndex": 0,
    "items": [
      "TradeTickItem"
    ]
  }
]

getQuoteDepth

Signature

async getQuoteDepth(req: DepthQuoteRequest): Promise<Depth[]>

Purpose

Gets quote depth.

Parameters, defaults, and constraints

ParameterTypeRequiredSDK defaultConstraints
reqDepthQuoteRequestYesNoneNo client-side validation is declared.
req.symbolsstring[] | undefinedNoNoneNo client-side validation is declared.
req.marketstring | undefinedNoNoneNo client-side validation is declared.
req.tradeSessionstring | undefinedNoNoneNo client-side validation is declared.
req.langstring | undefinedNoNoneNo client-side validation is declared.

Returns

Promise<Depth[]>

FieldTypeDescription
symbolstringSymbol code
asksDepthLevel[]Ask order queue
bidsDepthLevel[]Bid order queue

Type-checked example

const result = await quoteClient.getQuoteDepth({ symbols: ['AAPL'], market: 'US' });
console.log(result);

Response example

[
  {
    "symbol": "string",
    "asks": [
      "DepthLevel"
    ],
    "bids": [
      "DepthLevel"
    ]
  }
]

getStockBroker

Signature

async getStockBroker(req: StockBrokerRequest): Promise<StockBroker | undefined>

Purpose

Gets stock broker.

Parameters, defaults, and constraints

ParameterTypeRequiredSDK defaultConstraints
reqStockBrokerRequestYesNoneNo client-side validation is declared.
req.symbolstring | undefinedNoNoneNo client-side validation is declared.
req.limitnumber | undefinedNoNoneNo client-side validation is declared.
req.secTypestring | undefinedNoNoneNo client-side validation is declared.
req.langstring | undefinedNoNoneNo client-side validation is declared.

Returns

Promise<StockBroker | undefined>

FieldTypeDescription
symbolstringSymbol code
levelAskListStockBrokerItem[]Ask broker queue by level
levelBidListStockBrokerItem[]Bid broker queue by level

Type-checked example

const result = await quoteClient.getStockBroker({ symbol: '00700', limit: 40, secType: 'STK' });
console.log(result);

Response example

{
  "symbol": "string",
  "levelAskList": [
    {
      "level": 0,
      "price": 0,
      "brokers": [
        "BrokerDetail"
      ]
    }
  ],
  "levelBidList": [
    {
      "level": 0,
      "price": 0,
      "brokers": [
        "BrokerDetail"
      ]
    }
  ]
}

getCapitalFlow

Signature

async getCapitalFlow(symbol: string, market: string, period: string): Promise<CapitalFlow | undefined>

Purpose

Gets capital flow.

Parameters, defaults, and constraints

ParameterTypeRequiredSDK defaultConstraints
symbolstringYesNoneNo client-side validation is declared.
marketstringYesNoneNo client-side validation is declared.
periodstringYesNoneNo client-side validation is declared.

Returns

Promise<CapitalFlow | undefined>

FieldTypeDescription
symbolstringSymbol code
periodstringK-line period
itemsCapitalFlowItem[]Data items array

Type-checked example

const result = await quoteClient.getCapitalFlow('AAPL', 'US', 'day');
console.log(result);

Response example

{
  "symbol": "string",
  "period": "string",
  "items": [
    {
      "time": "string",
      "timestamp": 0,
      "netInflow": 0
    }
  ]
}

getCapitalDistribution

Signature

async getCapitalDistribution(symbol: string, market: string): Promise<CapitalDistribution | undefined>

Purpose

Gets capital distribution.

Parameters, defaults, and constraints

ParameterTypeRequiredSDK defaultConstraints
symbolstringYesNoneNo client-side validation is declared.
marketstringYesNoneNo client-side validation is declared.

Returns

Promise<CapitalDistribution | undefined>

FieldTypeDescription
symbolstringSymbol code
netInflownumberNet inflow
inAllnumberTotal inflow
inBignumberLarge order inflow
inMidnumberMedium order inflow
inSmallnumberSmall order inflow
outAllnumberTotal outflow
outBignumberLarge order outflow
outMidnumberMedium order outflow
outSmallnumberSmall order outflow

Type-checked example

const result = await quoteClient.getCapitalDistribution('AAPL', 'US');
console.log(result);

Response example

{
  "symbol": "string",
  "netInflow": 0,
  "inAll": 0,
  "inBig": 0,
  "inMid": 0,
  "inSmall": 0,
  "outAll": 0,
  "outBig": 0,
  "outMid": 0,
  "outSmall": 0
}

getTradeRank

Signature

async getTradeRank(req: TradeRankRequest): Promise<TradeRankItem[]>

Purpose

Gets trade rank.

Parameters, defaults, and constraints

ParameterTypeRequiredSDK defaultConstraints
reqTradeRankRequestYesNoneNo client-side validation is declared.
req.marketstring | undefinedNoNoneNo client-side validation is declared.
req.langstring | undefinedNoNoneNo client-side validation is declared.

Returns

Promise<TradeRankItem[]>

FieldTypeDescription
symbolstringSymbol code
namestringName
latestPricenumberLatest price
changenumberPrice change
changeRatenumberPrice change rate
volumenumberTrading volume
amountnumberTrading amount

Type-checked example

const result = await quoteClient.getTradeRank({ market: 'US' });
console.log(result);

Response example

[
  {
    "symbol": "string",
    "name": "string",
    "latestPrice": 0,
    "change": 0,
    "changeRate": 0,
    "volume": 0,
    "amount": 0
  }
]

getShortInterest

Signature

async getShortInterest(req: ShortInterestRequest): Promise<ShortInterest[]>

Purpose

Gets short interest.

Parameters, defaults, and constraints

ParameterTypeRequiredSDK defaultConstraints
reqShortInterestRequestYesNoneNo client-side validation is declared.
req.symbolsstring[] | undefinedNoNoneNo client-side validation is declared.
req.langstring | undefinedNoNoneNo client-side validation is declared.

Returns

Promise<ShortInterest[]>

FieldTypeDescription
symbolstringSymbol code
settlementDatestringSettlement date
shortInterestnumberShort interest shares
avgDailyVolumenumberAverage daily volume
daysToCovernumberDays to cover
percentOfFloatnumberPercent of float
shortInterestPreviousnumberPrevious short interest
percentChangenumberPercent change

Type-checked example

const result = await quoteClient.getShortInterest({ symbols: ['AAPL'] });
console.log(result);

Response example

[
  {
    "symbol": "string",
    "settlementDate": "string",
    "shortInterest": 0,
    "avgDailyVolume": 0,
    "daysToCover": 0,
    "percentOfFloat": 0,
    "shortInterestPrevious": 0,
    "percentChange": 0
  }
]


Did this page help you?