Get Top Gainers & Losers
GET/top-stocks/source/data
Get top stocks data
"Top stocks data" generally refers to information about the best-performing or most popular stocks in the financial markets. This data can include various metrics and indicators that investors use to evaluate the performance of stocks.
Top Stock Type | Reference |
---|---|
Top gainers by percentage change | 1 |
Top loosers by percentage change | 3 |
Most active by volume | 4 |
Most active by value | 6 |
NOTE: Above mentioned top stock types are available. Others are deprecated.
Request
Query Parameters
The source Id of the exchange you want to request top stocks. It will also be used for authorization. Only a single source ID can be given per request.
Possible values: [json
, csv
, xml
]
Default value: json
The response format.
Possible values: <= 1000
Default value: 10
Number of records per page in the response.
The index of the page requested.
Filter the response further using queries in solr query syntax. Always TOP_STOCK_TYPE should be given. Single or multiple TOP_STOCK_TYPES can be given. Recommended - TOP_STOCK_TYPE:(1 3 4 6)
The field on which the response should be sorted of. Any field can be given.
Possible values: [true
, false
]
Default value: true
Whether to sort in ascending order or descending order.
Header Parameters
Responses
- 200
OK
- application/json
- Schema
- Example (from schema)
- example
Schema
- Array [
- Array [
- ]
- ]
response object
docs object[]
Exchange, top stock type and the sub market code separated by ~
Exchange, top stock type and the sub market code separated by ~
Type of the top stock
Sub market id of the exchange
Exchange code
TOP_STOCK_DATA object[]
Symbole code
Maximum number of decimal places for numeric feilds
Asset class code
Decimal correction factor
Traded price of the symbol
Total volume traded for the day
Net change of the stock (Trade price - Previous closed)
Percentage change of the net change
Total value traded for the day
{
"response": {
"numFound": 0,
"start": 0,
"docs": [
{
"KEY": "string",
"ID": "string",
"TOP_STOCK_TYPE": "string",
"SUB_MARKET_CODE": "string",
"SOURCE_ID": "string",
"LANGUAGE_ID": "string",
"TOP_STOCK_DATA": [
{
"SYMBOL": "string",
"DECIMAL_PLACES": 0,
"INSTRUMENT_TYPE": 0,
"DCF": 0,
"TRADE_PRICE": "string",
"VOLUME": "string",
"NET_CHANGE": "string",
"PERCENTAGE_CHANGE": "string",
"TURNOVER": "string",
"SHORT_DESCRIPTION": "string",
"LONG_DESCRIPTION": "string"
}
]
}
]
}
}
{
"response": {
"numFound": 2,
"start": 0,
"docs": [
{
"KEY": "HKEX~4~R",
"ID": "HKEX~4~R~EN",
"TOP_STOCK_TYPE": "4",
"SUB_MARKET_CODE": "R",
"SOURCE_ID": "HKEX",
"LANGUAGE_ID": "EN",
"LAST_UPDATED_ON": "2024-01-04T04:44:07Z",
"COMPONENT_TIME": "2024-01-04T04:44:07Z",
"BATCH_ID": "55848",
"SOURCE_LAST_UPDATED_TIME": "2024-01-04T04:43:00.506Z",
"TOP_STOCK_DATA": [
{
"SYMBOL": "1176",
"DECIMAL_PLACES": 4,
"INSTRUMENT_TYPE": 0,
"DCF": 100,
"TRADE_PRICE": "0.2300",
"VOLUME": "157660000",
"NET_CHANGE": "0.0030",
"PERCENTAGE_CHANGE": "1.3200",
"TURNOVER": "36873918.0000",
"SHORT_DESCRIPTION": "ZHUGUANG HOLDINGS GROUP CO LTD",
"LONG_DESCRIPTION": "ZHUGUANG HOLDINGS GROUP CO LTD - Main Normal Market"
},
{
"SYMBOL": "1468",
"DECIMAL_PLACES": 4,
"INSTRUMENT_TYPE": 0,
"DCF": 100,
"TRADE_PRICE": "0.3000",
"VOLUME": "132410000",
"NET_CHANGE": "-0.0600",
"PERCENTAGE_CHANGE": "-16.6700",
"TURNOVER": "41682050.0000",
"SHORT_DESCRIPTION": "KINGKEY FINANCIAL INTL (HLDG) LTD",
"LONG_DESCRIPTION": "KINGKEY FINANCIAL INTL (HLDG) LTD - Main Normal Market"
},
{
"SYMBOL": "1398",
"DECIMAL_PLACES": 4,
"INSTRUMENT_TYPE": 0,
"DCF": 100,
"TRADE_PRICE": "3.7600",
"VOLUME": "57888881",
"NET_CHANGE": "0.0200",
"PERCENTAGE_CHANGE": "0.5300",
"TURNOVER": "217427402.0000",
"SHORT_DESCRIPTION": "INDUSTRIAL & COMMERCIAL BK OF CHINA",
"LONG_DESCRIPTION": "INDUSTRIAL & COMMERCIAL BK OF CHINA"
},
{
"SYMBOL": "1802",
"DECIMAL_PLACES": 4,
"INSTRUMENT_TYPE": 0,
"DCF": 100,
"TRADE_PRICE": "0.1000",
"VOLUME": "53098000",
"NET_CHANGE": "-0.0080",
"PERCENTAGE_CHANGE": "-7.4100",
"TURNOVER": "5506634.0000",
"SHORT_DESCRIPTION": "WENYE GROUP HLDGS LTD",
"LONG_DESCRIPTION": "WENYE GROUP HLDGS LTD - Main Normal Market"
},
{
"SYMBOL": "1918",
"DECIMAL_PLACES": 4,
"INSTRUMENT_TYPE": 0,
"DCF": 100,
"TRADE_PRICE": "1.4400",
"VOLUME": "36290829",
"NET_CHANGE": "-0.0300",
"PERCENTAGE_CHANGE": "-2.0400",
"TURNOVER": "52445003.0000",
"SHORT_DESCRIPTION": "SUNAC CHINA HLDGS",
"LONG_DESCRIPTION": "SUNAC CHINA HLDGS - Main Normal Market"
},
{
"SYMBOL": "1919",
"DECIMAL_PLACES": 4,
"INSTRUMENT_TYPE": 0,
"DCF": 100,
"TRADE_PRICE": "8.2500",
"VOLUME": "35428525",
"NET_CHANGE": "0.3000",
"PERCENTAGE_CHANGE": "3.7700",
"TURNOVER": "292633195.0000",
"SHORT_DESCRIPTION": "COSCO SHIPPING HOLDINGS",
"LONG_DESCRIPTION": "COSCO SHIPPING HOLDINGS - Main Normal Market"
},
{
"SYMBOL": "1177",
"DECIMAL_PLACES": 4,
"INSTRUMENT_TYPE": 0,
"DCF": 100,
"TRADE_PRICE": "3.4000",
"VOLUME": "33688500",
"NET_CHANGE": "0.0600",
"PERCENTAGE_CHANGE": "1.8000",
"TURNOVER": "113610250.0000",
"SHORT_DESCRIPTION": "SINO BIOPHARMACEUTICAL",
"LONG_DESCRIPTION": "SINO BIOPHARMACEUTICAL - Main Normal Market"
},
{
"SYMBOL": "1765",
"DECIMAL_PLACES": 4,
"INSTRUMENT_TYPE": 0,
"DCF": 100,
"TRADE_PRICE": "0.3250",
"VOLUME": "31086000",
"NET_CHANGE": "-0.0100",
"PERCENTAGE_CHANGE": "-2.9900",
"TURNOVER": "10023440.0000",
"SHORT_DESCRIPTION": "HOPE EDUCATION GROUP CO LTD",
"LONG_DESCRIPTION": "HOPE EDUCATION GROUP CO LTD - Main Normal Market"
},
{
"SYMBOL": "1810",
"DECIMAL_PLACES": 4,
"INSTRUMENT_TYPE": 0,
"DCF": 100,
"TRADE_PRICE": "15.0000",
"VOLUME": "26381750",
"NET_CHANGE": "0.0200",
"PERCENTAGE_CHANGE": "0.1300",
"TURNOVER": "395371324.0000",
"SHORT_DESCRIPTION": "XIAOMI CORPORATION",
"LONG_DESCRIPTION": "XIAOMI CORPORATION - Main Normal Market"
},
{
"SYMBOL": "182",
"DECIMAL_PLACES": 4,
"INSTRUMENT_TYPE": 0,
"DCF": 100,
"TRADE_PRICE": "0.6400",
"VOLUME": "25630000",
"NET_CHANGE": "0.0000",
"PERCENTAGE_CHANGE": "0.0000",
"TURNOVER": "16521600.0000",
"SHORT_DESCRIPTION": "CONCORD NEW ENERGY GROUP LIMITED",
"LONG_DESCRIPTION": "CONCORD NEW ENERGY GROUP LIMITED - Main Normal Market"
}
]
},
{
"KEY": "HKEX~4~R",
"ID": "HKEX~4~R~AR",
"TOP_STOCK_TYPE": "4",
"SUB_MARKET_CODE": "R",
"SOURCE_ID": "HKEX",
"LANGUAGE_ID": "AR",
"LAST_UPDATED_ON": "2024-01-04T04:44:07Z",
"COMPONENT_TIME": "2024-01-04T04:44:07Z",
"BATCH_ID": "55860",
"SOURCE_LAST_UPDATED_TIME": "2024-01-04T04:43:00.506Z",
"TOP_STOCK_DATA": [
{
"SYMBOL": "1176",
"DECIMAL_PLACES": 4,
"INSTRUMENT_TYPE": 0,
"DCF": 100,
"TRADE_PRICE": "0.2300",
"VOLUME": "157660000",
"NET_CHANGE": "0.0030",
"PERCENTAGE_CHANGE": "1.3200",
"TURNOVER": "36873918.0000",
"SHORT_DESCRIPTION": "",
"LONG_DESCRIPTION": ""
},
{
"SYMBOL": "1468",
"DECIMAL_PLACES": 4,
"INSTRUMENT_TYPE": 0,
"DCF": 100,
"TRADE_PRICE": "0.3000",
"VOLUME": "132410000",
"NET_CHANGE": "-0.0600",
"PERCENTAGE_CHANGE": "-16.6700",
"TURNOVER": "41682050.0000",
"SHORT_DESCRIPTION": "",
"LONG_DESCRIPTION": ""
},
{
"SYMBOL": "1398",
"DECIMAL_PLACES": 4,
"INSTRUMENT_TYPE": 0,
"DCF": 100,
"TRADE_PRICE": "3.7600",
"VOLUME": "57888881",
"NET_CHANGE": "0.0200",
"PERCENTAGE_CHANGE": "0.5300",
"TURNOVER": "217427402.0000",
"SHORT_DESCRIPTION": "",
"LONG_DESCRIPTION": ""
},
{
"SYMBOL": "1802",
"DECIMAL_PLACES": 4,
"INSTRUMENT_TYPE": 0,
"DCF": 100,
"TRADE_PRICE": "0.1000",
"VOLUME": "53098000",
"NET_CHANGE": "-0.0080",
"PERCENTAGE_CHANGE": "-7.4100",
"TURNOVER": "5506634.0000",
"SHORT_DESCRIPTION": "",
"LONG_DESCRIPTION": ""
},
{
"SYMBOL": "1918",
"DECIMAL_PLACES": 4,
"INSTRUMENT_TYPE": 0,
"DCF": 100,
"TRADE_PRICE": "1.4400",
"VOLUME": "36290829",
"NET_CHANGE": "-0.0300",
"PERCENTAGE_CHANGE": "-2.0400",
"TURNOVER": "52445003.0000",
"SHORT_DESCRIPTION": "",
"LONG_DESCRIPTION": ""
},
{
"SYMBOL": "1919",
"DECIMAL_PLACES": 4,
"INSTRUMENT_TYPE": 0,
"DCF": 100,
"TRADE_PRICE": "8.2500",
"VOLUME": "35428525",
"NET_CHANGE": "0.3000",
"PERCENTAGE_CHANGE": "3.7700",
"TURNOVER": "292633195.0000",
"SHORT_DESCRIPTION": "",
"LONG_DESCRIPTION": ""
},
{
"SYMBOL": "1177",
"DECIMAL_PLACES": 4,
"INSTRUMENT_TYPE": 0,
"DCF": 100,
"TRADE_PRICE": "3.4000",
"VOLUME": "33688500",
"NET_CHANGE": "0.0600",
"PERCENTAGE_CHANGE": "1.8000",
"TURNOVER": "113610250.0000",
"SHORT_DESCRIPTION": "",
"LONG_DESCRIPTION": ""
},
{
"SYMBOL": "1765",
"DECIMAL_PLACES": 4,
"INSTRUMENT_TYPE": 0,
"DCF": 100,
"TRADE_PRICE": "0.3250",
"VOLUME": "31086000",
"NET_CHANGE": "-0.0100",
"PERCENTAGE_CHANGE": "-2.9900",
"TURNOVER": "10023440.0000",
"SHORT_DESCRIPTION": "",
"LONG_DESCRIPTION": ""
},
{
"SYMBOL": "1810",
"DECIMAL_PLACES": 4,
"INSTRUMENT_TYPE": 0,
"DCF": 100,
"TRADE_PRICE": "15.0000",
"VOLUME": "26381750",
"NET_CHANGE": "0.0200",
"PERCENTAGE_CHANGE": "0.1300",
"TURNOVER": "395371324.0000",
"SHORT_DESCRIPTION": "",
"LONG_DESCRIPTION": ""
},
{
"SYMBOL": "182",
"DECIMAL_PLACES": 4,
"INSTRUMENT_TYPE": 0,
"DCF": 100,
"TRADE_PRICE": "0.6400",
"VOLUME": "25630000",
"NET_CHANGE": "0.0000",
"PERCENTAGE_CHANGE": "0.0000",
"TURNOVER": "16521600.0000",
"SHORT_DESCRIPTION": "",
"LONG_DESCRIPTION": ""
}
]
}
]
}
}
- application/json
- Schema
- Example (from schema)
- example
Schema
docs object
{
"numFound": "string",
"start": "string",
"docs": {
"KEY": "string",
"ID": "string",
"TOP_STOCK_TYPE": "string",
"SOURCE_ID": "string",
"LAST_UPDATE_ON": "string",
"COMPONENT_TIME": "string",
"BATCH_ID": "string",
"SOURCE_LAST_UPDATE_TIME": "string",
"TOP_STOCK_DATA": [
null
]
}
}
{
"numFound": "string",
"start": "string",
"docs": {
"KEY": "string",
"ID": "string",
"TOP_STOCK_TYPE": "string",
"SOURCE_ID": "string",
"LAST_UPDATE_ON": "string",
"COMPONENT_TIME": "string",
"BATCH_ID": "string",
"SOURCE_LAST_UPDATE_TIME": "string",
"TOP_STOCK_DATA": {
"SYMBOL": "string",
"DECIMAL_PLACES": "string",
"INSTRUMENT_TYPE": "string",
"DCF": "string",
"NUMBER_OF_TRADES": "string",
"VOLUME": "string",
"NET_CHANGE": "string",
"PERCENTAGE_CHANGE": "string",
"TURNOVER": "string",
"HIGH_PRICE_OF_52_WEEKS": "string",
"LOW_PRICE_OF_52_WEEKS": "string",
"LONG_DESCRIPTION": "string",
"SHORT_DESCRIPTION": "string"
}
}
}