https://github.com/dannyben/gondl

Command line console for Quandl
https://github.com/dannyben/gondl

cli go quandl quandl-api

Last synced: 3 months ago
JSON representation

Command line console for Quandl

• Host: GitHub
• URL: https://github.com/dannyben/gondl
• Owner: DannyBen
• License: mit
• Created: 2014-10-10T11:19:13.000Z (about 10 years ago)
• Default Branch: master
• Last Pushed: 2015-12-05T10:59:35.000Z (about 9 years ago)
• Last Synced: 2024-10-06T05:20:57.541Z (3 months ago)
• Topics: cli, go, quandl, quandl-api
• Language: Go
• Size: 22.5 KB
• Stars: 6
• Watchers: 3
• Forks: 2
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
Gondl - Command line console for Quandl

=======================================

Gondl provides command line access to the 

[Quandl API](https://www.quandl.com/help/api).

It was developed in Go.

## Features

* Get data for a symbol

* Get a list of symbols in a data source

* Search the entire Quandl database

* Shows/saves JSON, CSV or XML

* Built in local file cache

## Download Windows Binary

[Download the latest build of gondl.exe](https://github.com/DannyBen/gondl/releases)

## Build from Source (All Platforms)

To build from source on Windows, Linux or Mac - 

[Install Go](https://golang.org/doc/install), then:

	$ go get github.com/DannyBen/gondl

	$ cd $GOPATH/src/github.com/DannyBen/gondl

	$ go build

## Examples

Get data for Apple stock:

	gondl get WIKI/AAPL

Get 3 rows of data as JSON, and use an API Key:

	gondl get WIKI/AAPL -r3 -fjson -kYOUR_KEY

Save data as XML to a file:

	gondl get WIKI/CSCO -fxml -oOutFile.txt --rows 10

Get a list of symbols in a source:

	gondl list WIKI --page 1 --per_page 10

Get search results:

	gondl search "crude oil" --page 1 --per_page 10

## Usage:

    gondl --help | -h  

    gondl --version | -v  

    gondl --config [options]  

    gondl --make-config  

    gondl get  [options]  

    gondl list  [options]  

    gondl search  [options]  

## Standalone Options:  

    -h, --help                Show this help.  

    -v, --version             Show version details.  

        --config              Show config files location and info.  

        --make-config         Create a default gondl.json file.  

## Global Options:  

    -k, --apikey         Send this api key with the request  

    -f, --format      Output as csv, json or xml (default: csv)  

    -o, --out           Save to file  

    -u, --url                 Show the request URL  

    -d, --debug               Show all registered arguments  

    -D, --cachedir       Set cache directory (default: ./cache)  

    -C, --cache         Set cache life to  minutes  

                              0 to disable (default: 240)  

## Get Options:  

    -c, --column           Request data column  only  

    -r, --rows             Request  rows  

    -t, --trim_start    Start data at , format yyyy-mm-dd  

    -T, --trim_end      End data at , format yyyy-mm-dd  

    -s, --sort_order   Set sort order to asc or desc  

    -x, --exclude_headers     Exclude CSV headers  

        --exclude_data        Get meta data only (JSON/XML format)  

        --collapse         Set frequency to one of: none | daily |  

                              weekly | monthly | quarterly | annual   

        --transformation   Enable data calculation. Set to one of:  

                              diff | rdiff | cumul | normalize  

## Search/List Options:  

    -p, --page             Start at page  (default: 1)  

    -P, --per_page         Show  results per page (default: 300)