Stock Leaders API

getLeaders

The getLeaders API provides leaderboard lists for equities, futures, forex, mutual funds and ETFs, including most active, gainers, losers, what's hot and what's not hot. Users can access the data in real-time, delayed or end-of-day.

View All APIs

First Name^*

Last Name^*

Email Address^*

Phone^*

Company^*

Role^*

Industry^*

Country^*

What you are looking for?^*

Please provide as much information as possible (e.g. exchanges, markets or other data sources), the APIs you are interested in (e.g. getQuote, getHistory, getChart, getCorporateActions, etc.), and your use case.

Here are some examples: Example #1, Example #2, Example #3.

By submitting this form you are opting in to receive email communications from Barchart for related product, service or company information, updates and announcements. You can unsubscribe at anytime. View our Privacy Policy.

Inputs

exchanges^optional

Exchange code for the marketplace where the financial instruments are listed.

Type

list-enum (A comma or semi-colon delimited string that must match a list of valid possible values.)

Example

NYSE

Valid Values

AMEX, CBOT, CBOTM, CME, COMEX, COMEX, FOREX, GBLX, ICE, ICEFI, ICEUS, WCE, CADFUNDS, FUND, INDEX, INDEX-CBOE, INDEX-DOW, INDEX-NQ, INDEX-NY, INDEX-SP, INDEX-TSX, IOM, IMM, KCBT, LCE, MIAX, NASDAQ, OTHER OTC, RATES, RATE, NYMEX, NYMI, NYSE, NLIF, TSX, TSX-V, NEO, SECTOR, CNSX, LIFFE, EUIDX, EUREX, BMF, MATIF, CXMI, CXMI, HKFE, SPECIAL, INDEX-RL, MATBA, NCDEX, ASX, ROFEX, OTC-BB, SIMEX, CZCE, CROSS, BSE, MNTRL, ECON, TOCOM, MEFF, ENDEX, SAFEX, TIFFE, CASH, MCX, NZX, MDEX, DGCX, NSE, CBOE, GME, OMX, CFE, TURK, TFEX, TAIWA, SHFE, DCE, BATS, LSE, LME, EEX, CFFEX, JPX, SFE, KFE, CRYPTO, GRBIDS, AGIDX_B_COU, AGIDX_B_CRD, AGIDX_B_NAT, AGIDX_B_REG, AGIDX_B_STA, AGIDX_P_COU, AGIDX_P_CRD, AGIDX_P_NAT, AGIDX_P_REG, AGIDX_P_STA, MTIDX_P_NAT_SY, C3, CXE, EURNXT_EQ_BE, EURNXT_EQ_FR, EURNXT_EQ_NL, EURNXT_EQ_PT, AGYIELD, CMDTY_STATS, CSTATS_BARCHART, CSTATS_BHUGHES, CSTATS_CFTC, CSTATS_ENGCORPS, CSTATS_EUSTAT, CSTATS_STATCAN, CSTATS_USBEA, CSTATS_USBLS, CSTATS_USCB, CSTATS_USDA, CSTATS_USEIA, CMENRF, CMENRF_IDX, CMENWF, CMMTPM, AGYIELD_BIW, SCB_BIOFUEL_EU, SCB_BIOFUEL_US, SCB_ETHANOL, SMALL, AGIDX_B_FCST, MER_ORG_GRN, MER_ORG_IMP, CSTATS_IBGE, PRM_GLB_BIO, PRM_LOW_CAR, AGYIELD_SA, CSTATS_CONAB, EEX_POWER, EEX_GAS, SGCOM, SGXFX, SGXNZ, SGIDX, BALTIC, AMEX, NASDAQ, NYSE

assetType^required

The type of asset. Includes: equities ("STK"), mutual funds ("FUNDS"), ETFs ("ETF"), futures ("FUT"), forex ("FOREX")

Type

enum (A type which includes a list of valid possible values.)

Example

STK

Valid Values

STK, ETF, FUND, FUT, FOREX

type^required

The type of leaderboard to display.

Type

enum (A type which includes a list of valid possible values.)

Example

hot

Valid Values

active, active_5d, active_1m, active_3m, active_6m, active_9m, active_12m, active_ytd, gainers, gainers_5d, gainers_1m, gainers_3m, gainers_6m, gainers_9m, gainers_12m, gainers_ytd, losers, losers_5d, losers_1m, losers_3m, losers_6m, losers_9m, losers_12m, losers_ytd, hot, hot_daily, hot_weekly, hot_monthly, nothot, nothot_daily, nothot_weekly, nothot_monthly, barchart

maxRecords^optional

The maximum number of records to show in the return.

Type

int (A numeric type defining a whole number. (example: 2))

Example

30

Default

100

period^optional

A value representing the time period.

Type

enum (A type which includes a list of valid possible values.)

Example

260d

Default

260d

Valid Values

5d, 20d, 65d, 100d, 260d

sortDirection^optional

To determine the sort direction.

Type

enum (A type which includes a list of valid possible values.)

Example

DESC

Default

ASC

Valid Values

ASC, DESC

excludeEtfsFromStocks^optional

When requesting Stocks data, if you would like the API to exclude ETFs please set this parameter to true.

Type

boolean (A logical type representing the truth of a value as 'true' or 'false'.)

Outputs

symbol
always returned

A symbol or code that identifies a financial instrument.