API Documentation

Introduction

Welcome to Bytemine.io's API Hub. You can use our API to access API endpoints and our own signals, which can get information on Fundamentals of a Ticker, Historical Data, Pre-Processed Signals and more from our database.
Currently, we have language bindings in only Shell. However, you can easily translate this to whichever platform/language you are using as these are just simple API calls. You can view code examples in the dark area to the right, and you can switch the programming language of the examples with the tabs in the top right.
We offer compelling data services for a highly competitive price, if you decide to switch to one of our premium plans. On top of that you get access to the Trader's platform as well.
If you have any questions or want to raise a concern/query, please drop in a mail at [email protected]. We'll try our best to answer your queries within 24 working hours.

Authentication

No tricky authorization mechanisms. Authorization of the API key is essential for requesting data.
# With shell, you can just pass the correct API key with each request
curl https://app.bytemine.io/api/checkForCandlestick/{api_key}/...
$.ajax({
url: "https://app.bytemine.io/api/checkForCandlestick/{api_key}/...",
type: 'GET',
success: function(data) {
console.log(data);
}
});
Make sure to replace {api_key} with your API key.
To use the API you have to have an API key. You can get an API key from our developer portal.
The API key should be included in all API requests to the server

Signals

Candlestick Patterns

curl https://app.bytemine.io/api/checkForCandlestick/{api_key}/TSLA/5m
$.ajax({
url: "https://app.bytemine.io/api/checkForCandlestick/{api_key}/TSLA/5m",
type: 'GET',
success: function(data) {
console.log(data);
}
});
The above command returns JSON structured like this:
{
"success": true,
"data": [
{
"time": "2020-12-08 09:30",
"pattern": "Bearish Engulfing",
"close": 604.48,
"high": 654.32,
"open": 653.69,
"low": 588
}
]
}
You can get Candlestick Patterns from our API endpoints. This can be achieved using Long Polling. However, make sure to not call our Endpoints without adding atleast a 1 Min Delay.

HTTP Request

GET https://app.bytemine.io/api/checkForCandlestick/{api_key}/{ticker}/{timeframe}

Query Parameters

Parameter
Default
Description
api_key
true
API Key is required for authentication.
ticker
true
A ticker/symbol is needed for the appropriate candlestick pattern to be returned.
timeframe
true
Only one Timeframe out of these - 1m/2m/5m/15m/30m/60m/90m/1d/5d/1wk/1mo

Example HTTP Request

GET https://app.bytemine.io/api/checkForCandlestick/5fe69c95ed70a9869d9f9af7d8400a6673bb9ces/AAPL/5m
curl https://app.bytemine.io/api/getTickerTrend/{api_key}/AMD/30m
$.ajax({
url: "https://app.bytemine.io/api/getTickerTrend/{api_key}/AMD/30m",
type: 'GET',
success: function(data) {
console.log(data);
}
});
The above command returns JSON structured like this:
{
"success": true,
"trend": "Bearish"
}
Trends can be classified into three categories - Bullish, Bearish, Neutral. This can be achieved using Long Polling. However, make sure to not call our Endpoints without adding atleast a 1 Min Delay.

HTTP Request

GET https://app.bytemine.io/api/getTickerTrend/{api_key}/{ticker}/{timeframe}

Query Parameters

Parameter
Default
Description
api_key
true
API Key is required for authentication.
ticker
true
A ticker/symbol is needed for the appropriate candlestick pattern to be returned.
timeframe
true
Only one Timeframe out of these - 1m/2m/5m/15m/30m/60m/90m/1d/5d/1wk/1mo

Stock Market Data

Country Abbreviations

In some cases you might need country abbreviations to query the data. For example - if you want to find the list of stocks that a country has then you'd have to use country abbreviations. You can check the list of supported countries and their abbreviations from over here - https://airtable.com/shrffQ8hRyl0LKAQH/tbl9lvQLZq9nryClu.

Get List of all tickers of a Country

curl https://server1.bytemine.workers.dev/stocks/{api_key}/{country_abbreviation}/{offset}
$.ajax({
url: "https://server1.bytemine.workers.dev/stocks/{api_key}/cz/0",
type: 'GET',
success: function(data) {
console.log(data);
}
});
The above command returns JSON structured like this:
{
"start": 0,
"totalCount": 36,
"tickersReturned": 36,
"data": {
"0": {
"tickerSymbol": "RDSA.PR",
"open": 437.85,
"low": 434.6,
"high": 437.85,
"ltp": 434.6,
"volume": 251,
"dayChange": 6.600006,
"dayChangePercent": 1.5420575,
"fiftyTwoWeekLow": 275,
"fiftyTwoWeekHigh": 509,
"marketCap": 3278153187328
},
"1": {
"tickerSymbol": "VOLVB.PR",
"open": 535,
"low": 535,
"high": 535,
"ltp": 535,
"volume": 50,
"dayChange": 0,
"dayChangePercent": 0,
"fiftyTwoWeekLow": 290,
"fiftyTwoWeekHigh": 608,
"marketCap": 1089062043648
},
"2": {
"tickerSymbol": "EOAN.PR",
"open": 255.5,
"low": 255.5,
"high": 255.5,
"ltp": 255.5,
"volume": 223,
"dayChange": 0,
"dayChangePercent": 0,
"fiftyTwoWeekLow": 220,
"fiftyTwoWeekHigh": 275.05,
"marketCap": 671160205312
},
"3": {
"tickerSymbol": "VER.PR",
"open": 1600,
"low": 1600,
"high": 1600,
"ltp": 1600,
"volume": 15,
"dayChange": 0,
"dayChangePercent": 0,
"fiftyTwoWeekLow": 923,
"fiftyTwoWeekHigh": 1832.5,
"marketCap": 556734414848
},
"4": {
"tickerSymbol": "NOKIA.PR",
"open": 94.99,
"low": 92,
"high": 94.99,
"ltp": 92,
"volume": 520,
"dayChange": 1,
"dayChangePercent": 1.0989012,
"fiftyTwoWeekLow": 76.82,
"fiftyTwoWeekHigh": 126.88,
"marketCap": 511416041472
},
"5": {
"tickerSymbol": "ERBAG.PR",
"open": 766.8,
"low": 756,
"high": 766.8,
"ltp": 756,
"volume": 44238,
"dayChange": 2,
"dayChangePercent": 0.265252,
"fiftyTwoWeekLow": 440,
"fiftyTwoWeekHigh": 773.6,
"marketCap": 306056757248
},
"6": {
"tickerSymbol": "CEZ.PR",
"open": 567,
"low": 566,
"high": 573,
"ltp": 571.5,
"volume": 163983,
"dayChange": 6.5,
"dayChangePercent": 1.1504425,
"fiftyTwoWeekLow": 433.5,
"fiftyTwoWeekHigh": 573,
"marketCap": 306023366656
},
"7": {
"tickerSymbol": "OTP.PR",
"open": 978,
"low": 978,
"high": 978,
"ltp": 978,
"volume": 1,
"dayChange": -25,
"dayChangePercent": -2.4925225,
"fiftyTwoWeekLow": 651,
"fiftyTwoWeekHigh": 1003,
"marketCap": 264351432704
},
"8": {
"tickerSymbol": "PKO.PR",
"open": 186.5,
"low": 186.5,
"high": 186.5,
"ltp": 186.5,
"volume": 1,
"dayChange": 0,
"dayChangePercent": 0,
"fiftyTwoWeekLow": 110,
"fiftyTwoWeekHigh": 186.5,
"marketCap": 226819424256
},
"9": {
"tickerSymbol": "PKN.PR",
"open": 368,
"low": 368,
"high": 368,
"ltp": 368,
"volume": 10,
"dayChange": 2,
"dayChangePercent": 0.54644805,
"fiftyTwoWeekLow": 225.9,
"fiftyTwoWeekHigh": 434.6,
"marketCap": 155653701632
},
"10": {
"tickerSymbol": "RBI.PR",
"open": 474.4,
"low": 474.4,
"high": 474.4,
"ltp": 474.4,
"volume": 230,
"dayChange": 0,
"dayChangePercent": 0,
"fiftyTwoWeekLow": 332,
"fiftyTwoWeekHigh": 494.6,
"marketCap": 157174415360
},
"11": {
"tickerSymbol": "AVST.PR",
"open": 143.15,
"low": 140.9,
"high": 143.15,
"ltp": 143,
"volume": 198961,
"dayChange": 0.3500061,
"dayChangePercent": 0.24536005,
"fiftyTwoWeekLow": 119.6,
"fiftyTwoWeekHigh": 177,
"marketCap": 145669816320
},
"12": {
"tickerSymbol": "KOMB.PR",
"open": 684,
"low": 678,
"high": 686,
"ltp": 678,
"volume": 94533,
"dayChange": -2,
"dayChangePercent": -0.29411766,
"fiftyTwoWeekLow": 460,
"fiftyTwoWeekHigh": 725,
"marketCap": 128044367872
},
"13": {
"tickerSymbol": "MOL.PR",
"open": 156.2,
"low": 156.2,
"high": 156.2,
"ltp": 156.2,
"volume": 200,
"dayChange": -1.5,
"dayChangePercent": -0.9511732,
"fiftyTwoWeekLow": 115,
"fiftyTwoWeekHigh": 176,
"marketCap": 117469896704
},
"14": {
"tickerSymbol": "TELEC.PR",
"open": 261,
"low": 260,
"high": 264,
"ltp": 260,
"volume": 40454,
"dayChange": -1,
"dayChangePercent": -0.38314176,
"fiftyTwoWeekLow": 209,
"fiftyTwoWeekHigh": 264,
"marketCap": 78229315584
},
"15": {
"tickerSymbol": "VIG.PR",
"open": 590.5,
"low": 586,
"high": 595,
"ltp": 595,
"volume": 3429,
"dayChange": 11,
"dayChangePercent": 1.8835617,
"fiftyTwoWeekLow": 469,
"fiftyTwoWeekHigh": 619,
"marketCap": 76236161024
},
"16": {
"tickerSymbol": "TABAK.PR",
"open": 14600,
"low": 14500,
"high": 14620,
"ltp": 14600,
"volume": 1286,
"dayChange": 100,
"dayChangePercent": 0.6896552,
"fiftyTwoWeekLow": 13000,
"fiftyTwoWeekHigh": 15780,
"marketCap": 40082694144
},
"17": {
"tickerSymbol": "MONET.PR",
"open": 78,
"low": 77.55,
"high": 78.15,
"ltp": 77.65,
"volume": 1665687,
"dayChange": -0.5499954,
"dayChangePercent": -0.70331895,
"fiftyTwoWeekLow": 48.25,
"fiftyTwoWeekHigh": 84.3,
"marketCap": 39679152128
},
"18": {
"tickerSymbol": "JUVE.PR",
"open": 20.92,
"low": 20.67,
"high": 20.92,
"ltp": 20.67,
"volume": 174,
"dayChange": -0.8600006,
"dayChangePercent": -3.994429,
"fiftyTwoWeekLow": 19.82,
"fiftyTwoWeekHigh": 29,
"marketCap": 26427215872
},
"19": {
"tickerSymbol": "STOCK.PR",
"open": 85.5,
"low": 85,
"high": 86,
"ltp": 85,
"volume": 3715,
"dayChange": -0.19999695,
"dayChangePercent": -0.2347382,
"fiftyTwoWeekLow": 50.4,
"fiftyTwoWeekHigh": 87.5,
"marketCap": 17314670592
},
"20": {
"tickerSymbol": "BVB.PR",
"open": 136,
"low": 135,
"high": 136,
"ltp": 135,
"volume": 223,
"dayChange": 0,
"dayChangePercent": 0,
"fiftyTwoWeekLow": 119.4,
"fiftyTwoWeekHigh": 172.9,
"marketCap": 12491508736
},
"21": {
"tickerSymbol": "FACC.PR",
"open": 247,
"low": 247,
"high": 247,
"ltp": 247,
"volume": 100,
"dayChange": 0,
"dayChangePercent": 0,
"fiftyTwoWeekLow": 126.1,
"fiftyTwoWeekHigh": 276.4,
"marketCap": 11015656448
},
"22": {
"tickerSymbol": "CZG.PR",
"open": 374,
"low": 370,
"high": 374,
"ltp": 373,
"volume": 895,
"dayChange": 2,
"dayChangePercent": 0.53908354,
"fiftyTwoWeekLow": 280,
"fiftyTwoWeekHigh": 410,
"marketCap": 11129574400
},
"23": {
"tickerSymbol": "KOFOL.PR",
"open": 273,
"low": 272,
"high": 274,
"ltp": 273,
"volume": 8947,
"dayChange": 1,
"dayChangePercent": 0.36764705,
"fiftyTwoWeekLow": 212,
"fiftyTwoWeekHigh": 26900,
"marketCap": 6085688832
},
"24": {
"tickerSymbol": "PEN.PR",
"open": 80,
"low": 79,
"high": 80,
"ltp": 79,
"volume": 370,
"dayChange": -1,
"dayChangePercent": -1.25,
"fiftyTwoWeekLow": 30,
"fiftyTwoWeekHigh": 115,
"marketCap": 3911606016
},
"25": {
"tickerSymbol": "PINK.PR",
"open": 1100,
"low": 1100,
"high": 1100,
"ltp": 1100,
"volume": 3460,
"dayChange": -100,
"dayChangePercent": -8.333334,
"fiftyTwoWeekLow": 500,
"fiftyTwoWeekHigh": 1500,
"marketCap": 2750000128
},
"26": {
"tickerSymbol": "SABFG.PR",
"open": 10600,
"low": 10600,
"high": 10600,
"ltp": 10600,
"volume": 310,
"dayChange": 0,
"dayChangePercent": 0,
"fiftyTwoWeekLow": 10500,
"fiftyTwoWeekHigh": 10600,
"marketCap": 2731959296
},
"27": {
"tickerSymbol": "TOMA.PR",
"open": 1290,
"low": 1290,
"high": 1290,
"ltp": 1290,
"volume": 650,
"dayChange": 0,
"dayChangePercent": 0,
"fiftyTwoWeekLow": 1200,
"fiftyTwoWeekHigh": 1380,
"marketCap": 1718628352
},
"28": {
"tickerSymbol": "PRIUA.PR",
"open": 352,
"low": 352,
"high": 352,
"ltp": 352,
"volume": 600,
"dayChange": -4,
"dayChangePercent": -1.1235955,
"fiftyTwoWeekLow": 240,
"fiftyTwoWeekHigh": 358,
"marketCap": 1537930240
},
"29": {
"tickerSymbol": "PVT.PR",
"open": 1.99,
"low": 1.25,
"high": 1.99,
"ltp": 1.25,
"volume": 5511,
"dayChange": -0.09000003,
"dayChangePercent": -6.7164207,
"fiftyTwoWeekLow": 0.5,
"fiftyTwoWeekHigh": 1.99,
"marketCap": 1331337472
},
"30": {
"tickerSymbol": "PRAB.PR",
"open": 392,
"low": 392,
"high": 392,
"ltp": 392,
"volume": 500,
"dayChange": 0,
"dayChangePercent": 0,
"fiftyTwoWeekLow": 354,
"fiftyTwoWeekHigh": 402,
"marketCap": 392000000
},
"31": {
"tickerSymbol": "EFORU.PR",
"open": 103,
"low": 103,
"high": 103,
"ltp": 103,
"volume": 4,
"dayChange": 0,
"dayChangePercent": 0,
"fiftyTwoWeekLow": 92,
"fiftyTwoWeekHigh": 103,
"marketCap": 246338912
},
"35": {
"tickerSymbol": "DBK.PR",
"open": 273.1,
"low": 273.1,
"high": 273.1,
"ltp": 273.1,
"volume": 5,
"dayChange": 0,
"dayChangePercent": 0,
"fiftyTwoWeekLow": 153.4,
"fiftyTwoWeekHigh": 293.6,
"marketCap": 552189100032
}
}
}
The API endpoint requires 3 parameters -> API key, country abbreviation and finally an offset. You can get the country abbreviation from the above step. For offset the default value that you should enter is 0. Since the data is picked up from our SQL database hence we require an offset param to determine which next set of data should we output. You can read about offset from here.
If you still have questions about this then please contact us at [email protected]

Get Country's Most Active stocks

curl https://server1.bytemine.workers.dev/activestocks/{api_key}/{country_abbreviation}/{offset}
$.ajax({
url: "https://server1.bytemine.workers.dev/activestocks/{api_key}/cz/0",
type: 'GET',
success: function(data) {
console.log(data);
}
});
The above command returns JSON structured like this:
{
"start": 0,
"totalCount": 38,
"tickersReturned": 38,
"data": {
"0": {
"tickerSymbol": "MONET.PR",
"open": 77.95,
"low": 77.6,
"high": 78.1,
"ltp": 78,
"volume": 1098092,
"dayChange": 0.34999847,
"dayChangePercent": 0.45073852,
"fiftyTwoWeekLow": 48.25,
"fiftyTwoWeekHigh": 84.3,
"marketCap": 39857999872
},
"2": {
"tickerSymbol": "CEZ.PR",
"open": 572,
"low": 571.5,
"high": 581,
"ltp": 581,
"volume": 280469,
"dayChange": 9.5,
"dayChangePercent": 1.6622921,
"fiftyTwoWeekLow": 433.5,
"fiftyTwoWeekHigh": 581,
"marketCap": 311110369280
},
"3": {
"tickerSymbol": "KOMB.PR",
"open": 680,
"low": 673.5,
"high": 683.5,
"ltp": 673.5,
"volume": 162851,
"dayChange": -4.5,
"dayChangePercent": -0.6637168,
"fiftyTwoWeekLow": 460,
"fiftyTwoWeekHigh": 725,
"marketCap": 127194513408
},
"4": {
"tickerSymbol": "AVST.PR",
"open": 143,
"low": 140.85,
"high": 143.15,
"ltp": 141.3,
"volume": 119147,
"dayChange": -1.699997,
"dayChangePercent": -1.188809,
"fiftyTwoWeekLow": 119.6,
"fiftyTwoWeekHigh": 177,
"marketCap": 141875101696
},
"5": {
"tickerSymbol": "ERBAG.PR",
"open": 756,
"low": 753,
"high": 764,
"ltp": 762.8,
"volume": 48484,
"dayChange": 6.799988,
"dayChangePercent": 0.8994693,
"fiftyTwoWeekLow": 440,
"fiftyTwoWeekHigh": 773.6,
"marketCap": 308809662464
},
"6": {
"tickerSymbol": "TELEC.PR",
"open": 261,
"low": 261,
"high": 264,
"ltp": 263.5,
"volume": 20722,
"dayChange": 3.5,
"dayChangePercent": 1.3461539,
"fiftyTwoWeekLow": 209,
"fiftyTwoWeekHigh": 264,
"marketCap": 79282405376
},
"7": {
"tickerSymbol": "STOCK.PR",
"open": 85,
"low": 85,
"high": 86.9,
"ltp": 85.7,
"volume": 8837,
"dayChange": 0.69999695,
"dayChangePercent": 0.8235258,
"fiftyTwoWeekLow": 50.4,
"fiftyTwoWeekHigh": 87.5,
"marketCap": 17163910144
},
"8": {
"tickerSymbol": "KOFOL.PR",
"open": 275,
"low": 273,
"high": 276,
"ltp": 274,
"volume": 8071,
"dayChange": 1,
"dayChangePercent": 0.36630037,
"fiftyTwoWeekLow": 212,
"fiftyTwoWeekHigh": 26900,
"marketCap": 6107980800
},
"9": {
"tickerSymbol": "PVT.PR",
"open": 1.99,
"low": 1.25,
"high": 1.99,
"ltp": 1.25,
"volume": 5511,
"dayChange": 0,
"dayChangePercent": 0,
"fiftyTwoWeekLow": 0.5,
"fiftyTwoWeekHigh": 1.99,
"marketCap": 1331337472
},
"10": {
"tickerSymbol": "PINK.PR",
"open": 1100,
"low": 1100,
"high": 1100,
"ltp": 1100,
"volume": 8230,
"dayChange": 0,
"dayChangePercent": 0,
"fiftyTwoWeekLow": 500,
"fiftyTwoWeekHigh": 1500,
"marketCap": 2750000128
},
"11": {
"tickerSymbol": "UQA.PR",
"open": 172.6,
"low": 172.6,
"high": 173.2,
"ltp": 173.2,
"volume": 2215,
"dayChange": 3.5,
"dayChangePercent": 2.0624633,
"fiftyTwoWeekLow": 130.8,
"fiftyTwoWeekHigh": 199.7,
"marketCap": 54379429888
},
"12": {
"tickerSymbol": "VIG.PR",
"open": 595,
"low": 595,
"high": 599.5,
"ltp": 599.5,
"volume": 1260,
"dayChange": 4.5,
"dayChangePercent": 0.75630254,
"fiftyTwoWeekLow": 469,
"fiftyTwoWeekHigh": 619,
"marketCap": 76730605568
},
"14": {
"tickerSymbol": "RDSA.PR",
"open": 436,
"low": 430,
"high": 439.2,
"ltp": 431,
"volume": 762,
"dayChange": -3.600006,
"dayChangePercent": -0.8283493,
"fiftyTwoWeekLow": 275,
"fiftyTwoWeekHigh": 509,
"marketCap": 3155898400768
},
"15": {
"tickerSymbol": "TABAK.PR",
"open": 14680,
"low": 14640,
"high": 14940,
"ltp": 14940,
"volume": 1377,
"dayChange": 340,
"dayChangePercent": 2.328767,
"fiftyTwoWeekLow": 13000,
"fiftyTwoWeekHigh": 15780,
"marketCap": 41016127488
},
"16": {
"tickerSymbol": "PRIUA.PR",
"open": 350,
"low": 350,
"high": 350,
"ltp": 350,
"volume": 100,
"dayChange": -2,
"dayChangePercent": -0.5681818,
"fiftyTwoWeekLow": 240,
"fiftyTwoWeekHigh": 358,
"marketCap": 1520648448
},
"17": {
"tickerSymbol": "NOKIA.PR",
"open": 92,
"low": 92,
"high": 92,
"ltp": 92,
"volume": 100,
"dayChange": 0,
"dayChangePercent": 0,
"fiftyTwoWeekLow": 76.82,
"fiftyTwoWeekHigh": 126.88,
"marketCap": 511416041472
},
"18": {
"tickerSymbol": "TOMA.PR",
"open": 1290,
"low": 1290,
"high": 1290,
"ltp": 1290,
"volume": 650,
"dayChange": 0,
"dayChangePercent": 0,
"fiftyTwoWeekLow": 1200,
"fiftyTwoWeekHigh": 1380,
"marketCap": 1718628352
},
"19": {
"tickerSymbol": "CZG.PR",
"open": 374,
"low": 371,
"high": 374,
"ltp": 374,
"volume": 6540,
"dayChange": 1,
"dayChangePercent": 0.26809654,
"fiftyTwoWeekLow": 280,
"fiftyTwoWeekHigh": 410,
"marketCap": 11159411712
},
"20": {
"tickerSymbol": "SABFG.PR",
"open": 10600,
"low": 10600,
"high": 10600,
"ltp": 10600,
"volume": 650,
"dayChange": 0,
"dayChangePercent": 0,
"fiftyTwoWeekLow": 10500,
"fiftyTwoWeekHigh": 10600,
"marketCap": 2731959296
},
"21": {
"tickerSymbol": "PEN.PR",
"open": 80,
"low": 78,
"high": 80,
"ltp": 78,
"volume": 400,
"dayChange": -1,
"dayChangePercent": -1.2658228,
"fiftyTwoWeekLow": 30,
"fiftyTwoWeekHigh": 115,
"marketCap": 3931433984
},
"22": {
"tickerSymbol": "PRAB.PR",
"open": 392,
"low": 392,
"high": 392,
"ltp": 392,
"volume": 500,
"dayChange": 0,
"dayChangePercent": 0,
"fiftyTwoWeekLow": 354,
"fiftyTwoWeekHigh": 402,
"marketCap": 392000000
},
"24": {
"tickerSymbol": "MOL.PR",
"open": 156.2,
"low": 156.2,
"high": 156.2,
"ltp": 156.2,
"volume": 200,
"dayChange": 0,
"dayChangePercent": 0,
"fiftyTwoWeekLow": 115,
"fiftyTwoWeekHigh": 176,
"marketCap": 117469896704
},
"25": {
"tickerSymbol": "JUVE.PR",
"open": 20.92,
"low": 20.67,
"high": 20.92,
"ltp": 20.67,
"volume": 174,
"dayChange": 0,
"dayChangePercent": 0,
"fiftyTwoWeekLow": 19.82,
"fiftyTwoWeekHigh": 29,
"marketCap": 26427215872
},
"26": {
"tickerSymbol": "DBK.PR",
"open": 273.1,
"low": 273.1,
"high": 273.1,
"ltp": 273.1,
"volume": 5,
"dayChange": 0,
"dayChangePercent": 0,
"fiftyTwoWeekLow": 153.4,
"fiftyTwoWeekHigh": 293.6,
"marketCap": 552189100032
},
"27": {
"tickerSymbol": "VER.PR",
"open": 1600,
"low": 1600,
"high": 1600,
"ltp": 1600,
"volume": 15,
"dayChange": 0,
"dayChangePercent": 0,
"fiftyTwoWeekLow": 923,
"fiftyTwoWeekHigh": 1832.5,
"marketCap": 556734414848
},
"28": {
"tickerSymbol": "BVB.PR",
"open": 130,
"low": 130,
"high": 130,
"ltp": 130,
"volume": 61,
"dayChange": -5,
"dayChangePercent": -3.7037036,
"fiftyTwoWeekLow": 119.4,
"fiftyTwoWeekHigh": 172.9,
"marketCap": 12028860416
},
"30": {
"tickerSymbol": "FACC.PR",
"open": 247,
"low": 247,
"high": 247,
"ltp": 247,
"volume": 30,
"dayChange": 0,
"dayChangePercent": 0,
"fiftyTwoWeekLow": 126.1,
"fiftyTwoWeekHigh": 276.4,
"marketCap": 11015656448
},
"31": {
"tickerSymbol": "EOAN.PR",
"open": 257.15,
"low": 257.15,
"high": 257.15,
"ltp": 257.15,
"volume": 300,
"dayChange": 1.6499939,
"dayChangePercent": 0.64579016,
"fiftyTwoWeekLow": 220,
"fiftyTwoWeekHigh": 275.05,
"marketCap": 675494494208
},
"32": {
"tickerSymbol": "VOLVB.PR",
"open": 535,
"low": 535,
"high": 535,
"ltp": 535,
"volume": 50,
"dayChange": 0,
"dayChangePercent": 0,
"fiftyTwoWeekLow": 290,
"fiftyTwoWeekHigh": 608,
"marketCap": 1089062043648
},
"33": {
"tickerSymbol": "PKO.PR",
"open": 186.5,
"low": 186.5,
"high": 186.5,
"ltp": 186.5,
"volume": 1,
"dayChange": 0,
"dayChangePercent": 0,
"fiftyTwoWeekLow": 110,
"fiftyTwoWeekHigh": 186.5,
"marketCap": 226819424256
},
"34": {
"tickerSymbol": "RBI.PR",
"open": 474.4,
"low": 474.4,
"high": 474.4,
"ltp": 474.4,
"volume": 230,
"dayChange": 0,
"dayChangePercent": 0,
"fiftyTwoWeekLow": 332,
"fiftyTwoWeekHigh": 494.6,
"marketCap": 157005529088
},
"35": {
"tickerSymbol": "PKN.PR",
"open": 368,
"low": 368,
"high": 368,
"ltp": 368,
"volume": 10,
"dayChange": 0,
"dayChangePercent": 0,
"fiftyTwoWeekLow": 225.9,
"fiftyTwoWeekHigh": 434.6,
"marketCap": 155653701632
},
"36": {
"tickerSymbol": "EFORU.PR",
"open": 103,
"low": 103,
"high": 103,
"ltp": 103,
"volume": 10,
"dayChange": 0,
"dayChangePercent": 0,
"fiftyTwoWeekLow": 92,
"fiftyTwoWeekHigh": 103,
"marketCap": 246338912
},
"37": {
"tickerSymbol": "OTP.PR",
"open": 978,
"low": 978,
"high": 978,
"ltp": 978,
"volume": 1,
"dayChange": 0,
"dayChangePercent": 0,
"fiftyTwoWeekLow": 651,
"fiftyTwoWeekHigh": 1003,
"marketCap": 264351432704
}
}
}
The API endpoint requires 3 parameters -> API key, country abbreviation and finally an offset. You can get the country abbreviation from the Step 2 (under Stock Market Data). For offset the default value that you should enter is 0. Since the data is picked up from our SQL database hence we require an offset param to determine which next set of data should we output. You can read about offset from here.
At a time, the API returns a maximum of 200 tickers (if tickers in a country are greater 200). If you still have questions about this then please contact us at [email protected]

Get OLHCV Data of Tickers via single API Call

curl https://server1.bytemine.workers.dev/tickerList/{api_key}/{list_of_tickers}
$.ajax({
url: "https://server1.bytemine.workers.dev/tickerList/{api_key}/ULVR.L%2CGSK.L%2CRB.L%2CBATS.L%2CAZN.L",
type: 'GET',
success: function(data) {
console.log(data);
}
});
The above command returns JSON structured like this:
{
"0": {
"exchangeName": "LSE",
"percentChange": "0.11%",
"low": 4101.5,
"open": 4124.5,
"high": 4140,
"ltp": 4135.5,
"volume": 1682548,
"name": "Unilever PLC",
"symbol": "ULVR.L",
"type": "EQUITY"
},
"1": {
"exchangeName": "LSE",
"percentChange": "-1.67%",
"low": 1292.4,
"open": 1315,
"high": 1316.2,
"ltp": 1297.6,
"volume": 7105777,
"name": "GlaxoSmithKline plc",
"symbol": "GSK.L",
"type": "EQUITY"
},
"2": {
"exchangeName": "LSE",
"percentChange": "0.09%",
"low": 6464.855,
"open": 6506,
"high": 6556,
"ltp": 6498,
"volume": 1091046,
"name": "Reckitt Benckiser Group plc",
"symbol": "RB.L",
"type": "EQUITY"
},
"3": {
"exchangeName": "LSE",
"percentChange": "0.09%",
"low": 2764,
"open": 2780,
"high": 2805.5,
"ltp": 2788.5,
"volume": 2911611,
"name": "British American Tobacco p.l.c.",
"symbol": "BATS.L",
"type": "EQUITY"
},
"4": {
"exchangeName": "LSE",
"percentChange": "-0.85%",
"low": 7194,
"open": 7260,
"high": 7320,
"ltp": 7225,
"volume": 1359034,
"name": "AstraZeneca PLC",
"symbol": "AZN.L",
"type": "EQUITY"
}
}
The API endpoint requires 2 parameters -> API key, and list of ticker separated by a 'comma'. Since you'd be passing this list in a URL you'd have to convert this comma separated string into ascii codes. What this means is convert all commas into %2C. Please refer here for more details.
Please check out the example by switching over to the Javascript tab to know more about how to format this request. If you still have questions about this then please contact us at [email protected]

Company Details

curl https://valhalla.bytemine.workers.dev/companyDetails/{api_key}/ITC.NS
$.ajax({
url: "https://valhalla.bytemine.workers.dev/companyDetails/{api_key}/ITC.NS",
type: 'GET',
success: function(data) {
console.log(data);
}
});
The above command returns JSON structured like this:
{
"address": [
"Virginia House",
"37 Jawaharlal Nehru Road"
],
"businessSummary": "ITC Limited engages in the fast moving consumer goods, hotels, paperboards, paper and packaging, agri, and information technology (IT) businesses in India and internationally. The company primarily offers cigarettes and cigars; staples, spices, biscuits, confectionery and gums, snacks, noodles and pasta, beverages, dairy, ready to eat meals, chocolate, coffee, and frozen foods; personal care products; education and stationery products; safety matches; and incense sticks under various brands. It also retails formals and casual wear products, and other lifestyle products under the WLS brand. In addition, the company offers paper boards and specialty paper products; and packaging products, such as carton board, flexible, tobacco, and green packaging products, as well as operates approximately 100 hotels under the ITC Hotel, WelcomHotel, Fortune, and WelcomHeritage brands. Further, it exports feed ingredients, food grains, marine products, processed fruits, coffee products, leaf tobacco products, and spices; and offers IT services and solutions. Additionally, the company offers technology services and solutions for the banking, financial services, consumer packaged goods, manufacturing, travel, hospitality, and healthcare industries. The company also provides property infrastructure and real estate maintenance, business consulting, real estate development, and agro-forestry and other related services; manages and operates golf courses; fabricates and assembles machinery for tube filling, cartoning, wrapping, conveyor solutions, and engineering services; and produces and commercializes seed potato technology products. ITC Limited was incorporated in 1910 and is headquartered in Kolkata, India.",
"sector": "Consumer Defensive",
"website": "http://www.itcportal.com",
"phone": "91 33 2288 9371",
"country": "India",
"zip": "700071",
"city": "Kolkata",
"industry": "Tobacco",
"employeesCount": 28115,
"officers": [
{
"name": "Mr. Sanjiv Puri",
"age": 57,
"title": "Chairman & MD"
},
{
"name": "Mr. Rajendra Kumar Singhi",
"age": 55,
"title": "Exec. VP, Company Sec. & Compliance Officer"
},
{
"name": "Mr. Rajiv Tandon",
"age": 66,
"title": "Exec. Director"
},
{
"name": "Mr. Sumant Bhargavan",
"age": 56,
"title": "Exec. Director & Pres of FMCG Bus.es"
},
{
"name": "Mr. Nakul Anand",
"age": 64,
"title": "Exec. Director"
},
{
"name": "Mr. Supratim Dutta",
"age": 53,
"title": "CFO & Exec. VP of Corp. Fin."
},
{
"name": "Mr. Saradindu Dutta",
"age": 60,
"title": "Head of Corp. Accounts"
},
{
"name": "Mr. Samrat Banerjee",
"title": "VP & Divisional CIO"
},
{
"name": "Mr. Angamuthu Shanmuga Sundaram",
"age": 53,
"title": "Gen. Counsel"
},
{
"name": "Mr. Arif Nazeeb",
"age": 58,
"title": "Head of Corp. Communications & Exec. VP"
}
]
}
You can get company details of any stock from our API endpoints. This can be achieved using Long Polling. However, make sure to not call our Endpoints without adding atleast a 1 Min Delay.

HTTP Request

GET https://valhalla.bytemine.workers.dev/companyDetails/{api_key}/{ticker}

Query Parameters

Parameter
Default
Description
api_key
true
API Key is required for authentication.
ticker
true
A ticker/symbol is needed for the appropriate candlestick pattern to be returned.

Example HTTP Request

GET https://valhalla.bytemine.workers.dev/companyDetails/afdhesdf/TSLA

Open High Low Close Volume

curl https://valhalla.bytemine.workers.dev/olhc/{api_key}/GOOG/15m/1d
$.ajax({
url: "https://valhalla.bytemine.workers.dev/olhc/{api_key}/GOOG/15m/1d",
type: 'GET',
success: function(data) {
console.log(data);
}
});
The above command returns JSON structured like this:
{
"currency": "USD",
"exchangeTimeZone": "America/New_York",
"regularMarketPrice": 2285.88,
"timezone": "EDT",
"symbol": "GOOG",
"olhc": {
"timestamp": [
1617975000,
1617975900,
1617976800,
1617977700,
1617978600,
1617979500,
1617980400,
1617981300,
1617982200,
1617983100,
1617984000,
1617984900,
1617985800,
1617986700,
1617987600,
1617988500,
1617989400,
1617990300,
1617991200,
1617992100,
1617993000,
1617993900,
1617994800,
1617995700,
1617996600,
1617997500
],
"open": [
2256.699951171875,
2262.77001953125,
2266.89990234375,
2269.590087890625,
2261.139892578125,
2261,
2262.050048828125,
2266,
2265.60009765625,
2268.929931640625,
2271.199951171875,
2271.60009765625,
2271.405029296875,
2272.699951171875,
2276.449951171875,
2274.510009765625,
2276.5205078125,
2279,
2274.429931640625,
2277.429931640625,
2275.22998046875,
2275,
2273.409912109375,
2271.93994140625,
2277.830078125,
2279.3798828125
],
"high": [
2263.06005859375,
2269.949951171875,
2272.929931640625,
2270.8701171875,
2266.139892578125,
2264.340087890625,
2266,
2267.080078125,
2270.090087890625,
2271.72998046875,
2275.550048828125,
2273.06005859375,
2272.8701171875,
2276.56005859375,
2276.639892578125,
2275.22998046875,
2280,
2279,
2277.169921875,
2279.349853515625,
2277,
2275.669921875,
2274.43994140625,
2277.8349609375,
2283.455078125,
2289.0400390625
],
"low": [
2253.7138671875,
2258.5400390625,
2266.659912109375,
2260.27001953125,
2259.2099609375,
2260.985107421875,
2261.570068359375,
2263.080078125,
2264.89501953125,
2268.85009765625,
2270.5400390625,
2269.837890625,
2270.385009765625,
2272.195068359375,
2273.965087890625,
2272.830078125,
2276.280029296875,
2273.135009765625,
2274.22509765625,
2276.22998046875,
2275.22998046875,
2272,
2271.280029296875,
2271.6953125,
2277.780029296875,
2279.3798828125
],
"close": [
2260.71875,
2266.150146484375,
2269.639892578125,
2262.3798828125,
2261.969970703125,
2262.580078125,
2266,
2266.155029296875,
2270.070068359375,
2270.8798828125,
2270.5400390625,
2270.81494140625,
2272.699951171875,
2276.56005859375,
2274.397705078125,
2275.219970703125,
2279,
2274.409912109375,
2276.010009765625,
2277.47998046875,
2275.85009765625,
2272.8701171875,
2271.844970703125,
2277.8349609375,
2279.554931640625,
2284.610107421875
],
"volume": [
102072,
57972,
38485,
34142,
30494,
27754,
22196,
32638,
16987,
22611,
25798,
19028,
17944,
24300,
9935,
14062,
18068,
18513,
19314,
38876,
11802,
24502,
23483,
34506,
73263,
174841
]
}
}
You can get OLHC data of any stock from our API endpoints. This can be achieved using Long Polling. However, make sure to not call our Endpoints without adding atleast a 1 Min Delay.

HTTP Request

GET https://valhalla.bytemine.workers.dev/olhc/{api_key}/{ticker}/{timeframe}/{range}

Query Parameters

Parameter
Default
Description
api_key
true
API Key is required for authentication.
ticker
true
A ticker/symbol is needed for the appropriate candlestick pattern to be returned.
timeframe
true
Only one Timeframe out of these - 1m/2m/5m/15m/30m/60m/90m/1d/5d/1wk/1mo
range
true
Only one Range out of these - 1d/5d/1mo/3mo/6mo/1y/2y/5y/10y/ytd/max

Example HTTP Request

GET https://valhalla.bytemine.workers.dev/olhc/afdhesdf/TSLA/5m/5d

Similar Stocks

curl https://valhalla.bytemine.workers.dev/similar/{api_key}/{ticker}
$.ajax({
url: "https://valhalla.bytemine.workers.dev/similar/{api_key}/AMZN",
type: 'GET',
success: function(data) {
console.log(data);
}
});
The above command returns JSON structured like this:
{
"currentSymbol": "AMZN",
"similarStocks": [
"FB",
"AAPL",
"GOOG",
"TSLA",
"NFLX"
]
}
You can get similar stocks from our API endpoints. This can be achieved using Long Polling. However, make sure to not call our Endpoints without adding atleast a 1 Min Delay.

HTTP Request

GET https://valhalla.bytemine.workers.dev/similar/{api_key}/{ticker}

Query Parameters

Parameter
Default
Description
api_key
true
API Key is required for authentication.
ticker
true
A ticker/symbol is needed for the appropriate candlestick pattern to be returned.

Example HTTP Request

GET https://valhalla.bytemine.workers.dev/similar/afdhesdf/TSLA

Company Summary

curl https://valhalla.bytemine.workers.dev/summary/{api_key}/LSE.L