https://github.com/markcheno/go-quote
Yahoo finance/Google finance/Coinbase/Bittrex/Binance/Tiingo historical quote downloader library and cli written in golang
https://github.com/markcheno/go-quote
binance binance-api bitcoin bittrex bittrex-api cli coinbase ethereum financial-data gdax gdax-api golang historical-cryptocurrency-prices historical-data litecoin quotes tiingo yahoo yahoo-finance-api
Last synced: 10 days ago
JSON representation
Yahoo finance/Google finance/Coinbase/Bittrex/Binance/Tiingo historical quote downloader library and cli written in golang
- Host: GitHub
- URL: https://github.com/markcheno/go-quote
- Owner: markcheno
- License: mit
- Created: 2016-03-16T01:19:58.000Z (about 9 years ago)
- Default Branch: master
- Last Pushed: 2024-02-25T22:49:52.000Z (about 1 year ago)
- Last Synced: 2024-05-22T15:31:19.501Z (11 months ago)
- Topics: binance, binance-api, bitcoin, bittrex, bittrex-api, cli, coinbase, ethereum, financial-data, gdax, gdax-api, golang, historical-cryptocurrency-prices, historical-data, litecoin, quotes, tiingo, yahoo, yahoo-finance-api
- Language: Go
- Homepage:
- Size: 291 KB
- Stars: 314
- Watchers: 18
- Forks: 80
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- my-awesome - markcheno/go-quote - api,bitcoin,bittrex,bittrex-api,cli,coinbase,ethereum,financial-data,gdax,gdax-api,golang,historical-cryptocurrency-prices,historical-data,litecoin,quotes,tiingo,yahoo,yahoo-finance-api pushed_at:2025-04 star:0.3k fork:0.1k Yahoo finance/Google finance/Coinbase/Bittrex/Binance/Tiingo historical quote downloader library and cli written in golang (Go)
- awesome-go-quant - go-quote - Yahoo finance/Google finance/Coinbase/Bittrex/Binance/Tiingo historical quote downloader library and cli written in golang (Golang / Market data)
README
# go-quote
[](http://godoc.org/github.com/markcheno/go-quote)
A free quote downloader library and cli
Downloads daily historical price quotes from Tiingo and daily/intraday data from various api's. Written in pure Go. No external dependencies. Now downloads crypto coin historical data from various exchanges.
- Update: 04/01/2025 - added markets flag, wildcard input files, multiple inputs
- Update: 03/02/2025 - Removed obsolete Yahoo support
- Update: 02/15/2024 - Major update: updated to Go 1.22, removed bittrex/binance support, fixed nasdaq/tiingo markets
- Update: 11/15/2021 - Removed obsolete markets, converted to go modules
- Update: 7/18/2021 - Removed obsolete Google support
- Update: 6/26/2019 - updated GDAX to Coinbase, added coinbase market
- Update: 4/26/2018 - Added preliminary [tiingo](https://api.tiingo.com/) CRYPTO support. Use -source=tiingo-crypto -token= You can also set env variable TIINGO_API_TOKEN. To get symbol lists, use market: tiingo-btc, tiingo-eth or tiingo-usd
- Update: 12/21/2017 - Added Amibroker format option (creates csv file with separate date and time). Use -format=ami
- Update: 12/20/2017 - Added [Binance](https://www.binance.com/trade.html) exchange support. Use -source=binance
- Update: 12/18/2017 - Added [Bittrex](https://bittrex.com/home/markets) exchange support. Use -source=bittrex
- Update: 10/21/2017 - Added Coinbase [GDAX](https://www.gdax.com/trade/BTC-USD) exchange support. Use -source=gdax All times are in UTC. Automatically rate limited.
- Update: 7/19/2017 - Added preliminary [tiingo](https://api.tiingo.com/) support. Use -source=tiingo -token= You can also set env variable TIINGO_API_TOKEN
- Update: 5/24/2017 - Now works with the new Yahoo download format. Beware - Yahoo data quality is now questionable and the free Yahoo quotes are likely to permanently go away in the near future. Use with caution!
Still very much in alpha mode. Expect bugs and API changes. Comments/suggestions/pull requests welcome!
Copyright 2024 Mark Chenoweth
Install CLI utility (quote) with:
```bash
go install github.com/markcheno/go-quote/quote@latest
```
```
Usage:
quote -h | -help
quote -v | -version
quote [-output=]
quote [-years=|(-start= [-end=])] [options] [-infile=| ...]
Options:
-h -help show help
-v -version show version
-years= number of years to download [default=5]
-start= yyyy[-[mm-[dd]]]
-end= yyyy[-[mm-[dd]]] [default=today]
-infile= list of symbols to download
-markets= list of markets to download (comma separated)
-outfile= output filename
-period= 1m|3m|5m|15m|30m|1h|2h|4h|6h|8h|12h|d|3d|w|m [default=d]
-source= tiingo|tiingo-crypto|coinbase [default=tiingo]
-token= tingo api token [default=TIINGO_API_TOKEN]
-format= (csv|json|hs|ami) [default=csv]
-all= all in one file (true|false) [default=false]
-log= filename|stdout|stderr|discard [default=stdout]
-delay= delay in milliseconds between quote requests
Note: not all periods work with all sources
Valid markets:
etf,nasdaq,nasdaq100,amex,nyse,megacap,largecap,midcap,smallcap,microcap,nanocap,
telecommunications,health_care,finance,real_estate,consumer_discretionary,
consumer_staples,industrials,basic_materials,energy,utilities
coinbase,tiingo-usd,tiingo-btc,tiingo-eth
```
## CLI Examples
```bash
# display usage
quote -help
# downloads 10 years of smallcap, midcap, largecap and megacap stocks to stocks.csv
quote -markets=smallcap,midcap,largecap,megacap -all=true -years=10 -outfile=stocks.csv
# downloads 10 years of spy,qqq and djia to indexes.csv
quote -years=10 -outfile=indexes.csv -all=true spy qqq djia
# downloads 5 years of Tiingo SPY history to spy.csv (TIINGO_API_TOKEN must be set)
quote spy
# downloads 1 year of bitcoin history to BTC-USD.csv
quote -years=1 -source=coinbase BTC-USD
# downloads full etf symbol list to etf.txt, also works for nasdaq,nasdaq100,nyse,amex
quote etf
# download fresh etf list and 5 years of etf data all in one file
quote -markets=etf -all=true -outfile=etf.csv
```
## Install library
Install the package with:
```bash
go get github.com/markcheno/go-quote@latest
```
## Library example
```go
package main
import (
"fmt"
"github.com/markcheno/go-quote"
"github.com/markcheno/go-talib"
)
func main() {
spy, _ := quote.NewQuoteFromTiingo("spy", "2016-01-01", "2016-04-01", quote.Daily, true)
fmt.Print(spy.CSV())
rsi2 := talib.Rsi(spy.Close, 2)
fmt.Println(rsi2)
}
```
## License
MIT License - see LICENSE for more details