https://github.com/anvk/google-stocks
Get stocks using Google Finance API.
https://github.com/anvk/google-stocks
google nodejs npm-module stock-market stocks
Last synced: 19 days ago
JSON representation
Get stocks using Google Finance API.
- Host: GitHub
- URL: https://github.com/anvk/google-stocks
- Owner: anvk
- License: mit
- Created: 2015-05-02T19:01:59.000Z (almost 10 years ago)
- Default Branch: master
- Last Pushed: 2018-01-05T16:49:21.000Z (over 7 years ago)
- Last Synced: 2025-04-11T02:13:52.678Z (19 days ago)
- Topics: google, nodejs, npm-module, stock-market, stocks
- Language: JavaScript
- Homepage: https://www.npmjs.com/package/google-stocks
- Size: 106 KB
- Stars: 33
- Watchers: 4
- Forks: 14
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# google-stocks [](https://travis-ci.org/anvk/google-stocks)
> Get stocks using Google Finance API
## Install
```
$ npm install google-stocks --save
```
## Usage
### Callbacks
```js
var googleStocks = require('google-stocks');
googleStocks(['AAPL'], function(error, data) {
console.log(data);
});
googleStocks(['TSE:WJA', 'NASDAQ:GOOG', 'AAPL'], function(error, data) {
console.log(data);
});
```
### Promises
```js
var googleStocks = require('google-stocks');
googleStocks(['AAPL'])
.then(function(data) {
/* do something with data */
})
.catch(function(error) {
/* error logic */
});
googleStocks(['TSE:WJA', 'NASDAQ:GOOG', 'AAPL'])
.then(function(data) {
/* do something with data */
})
.catch(function(error) {
/* error logic */
});
```
### ES2015
```js
import googleStocks from 'google-stocks';
googleStocks(['AAPL'])
.then(data => {
/* do something with data */
})
.catch(error => {
/* error logic */
});
googleStocks(['TSE:WJA', 'NASDAQ:GOOG', 'AAPL'])
.then(data => {
/* do something with data */
})
.catch(error => {
/* error logic */
});
```
(_Jan 02 2018_) Example of a returned format:
```js
/**
[
{
"symbol": "AAPL",
"exchange": "NASDAQ",
"id": "22144",
"t": "AAPL",
"e": "NASDAQ",
"name": "Apple Inc.",
"f_reuters_url": "http:\u002F\u002Fstocks.us.reuters.com\u002Fstocks\u002Fratios.asp?rpc=66\u0026symbol=AAPL.O",
"f_recent_quarter_date": "Q3 (Sep \u002717)",
"f_annual_date": "2017",
"f_ttm_date": "2016",
"financials": [{...
],
"kr_recent_quarter_date": "Q3 (Sep \u002717)",
"kr_annual_date": "2017",
"kr_ttm_date": "TTM",
"keyratios": [{...
],
"c": "+1.30",
"l": "170.53",
"cp": "0.77",
"ccol": "chg",
"op": "170.16",
"hi": "170.54",
"lo": "169.26",
"vo": "1.14M",
"avvo": "26.27M",
"hi52": "177.20",
"lo52": "114.76",
"mc": "875.55B",
"pe": "18.56",
"fwpe": "",
"beta": "1.24",
"eps": "9.19",
"dy": "1.48",
"ldiv": "0.63",
"shares": "5.13B",
"instown": "62%",
"eo": "",
"sid": "us-TRBC:57",
"sname": "Technology",
"iid": "us-TRBC:5710601010",
"iname": "Computer Hardware - NEC",
"related": [{...
],
"summary": [{...
],
"management": [{...
],
"moreresources": [{...
],
"events": []
}
]
**/
```
## Example
```
npm run example
```
## License
MIT license; see [LICENSE](./LICENSE).