quandl-api: Quandl.com API library

[ api, bsd3, data, library, web ] [ Propose Tags ]

This library provides an easy way to download data from Quandl.com.


[Skip to Readme]

Modules

[Index]

Downloads

Maintainer's Corner

Package maintainers

For package maintainers and hackage trustees

Candidates

Versions [RSS] 0.1.0.0, 0.2.0.0, 0.2.1.0
Change log CHANGELOG.md
Dependencies aeson, base (>=4 && <5), blaze-builder, bytestring, http-conduit, http-types, syb, text, time, time-locale-compat, unordered-containers [details]
License BSD-3-Clause
Copyright (c) 2014 Peter van den Brand
Author Peter van den Brand <peter@vdbrand.nl>
Maintainer Peter van den Brand <peter@vdbrand.nl>
Category Data, API, Web
Home page https://github.com/pvdbrand/quandl-api
Bug tracker https://github.com/pvdbrand/quandl-api/issues
Source repo head: git clone git://github.com/pvdbrand/quandl-api.git
Uploaded by PeterVanDenBrand at 2015-05-18T09:33:19Z
Distributions
Reverse Dependencies 1 direct, 0 indirect [details]
Downloads 2673 total (14 in the last 30 days)
Rating (no votes yet) [estimated by Bayesian average]
Your Rating
  • λ
  • λ
  • λ
Status Docs available [build log]
Last success reported on 2015-05-21 [all 1 reports]

Readme for quandl-api-0.2.1.0

[back to package description]

quandl-api

This library provides an easy way to download data from Quandl.com in Haskell.

Installation

Basic Usage

The getTable function is all you need to download tables. To get all data points for the dataset FRED/GDP:

import Data.Quandl
getTable "FRED" "GDP" Nothing

Registered users should include their auth_token, like this:

import Data.Quandl
getTable "FRED" "GDP" (Just "dsahFHUiewjjd")

Advanced Usage

The getTableWith function allows you to use query a subset of the data, query multiple tables (multisets), apply frequency conversions, and apply transformations supported by Quandl. For example, here is the annual percentage return for AAPL stock over the previous decade, in ascending date order:

import Data.Quandl
import Data.Time (fromGregorian)
getTableWith (defaultOptions {opSortAscending  = True, 
                              opStartDate      = Just (fromGregorian 2000 1 1), 
                              opEndDate        = Just (fromGregorian 2010 1 1), 
                              opFrequency      = Just Annual, 
                              opTransformation = Just RDiff})
             [("WIKI", "AAPL", Just 4)]  -- Just 4 means we only want the 4'th column (Close price)

You can pull data from multiple datasets (or from multiple columns in a single dataset) using this function as well. In the example below, we combine US GDP from FRED/GDP, crude oil spot prices from DOE/RWTC, and Apple closing prices from WIKI/AAPL. We are going to convert all of them to annual percentage changes, and look only at data for the last 10 years:

import Data.Quandl
getTableWith (defaultOptions {opNumRows        = Just 10,
                              opFrequency      = Just Annual,
                              opTransformation = Just RDiff})
             [("FRED", "GDP", Just 1), ("DOE", "RWTC", Just 1), ("WIKI", "AAPL", Just 4)]

See http://www.quandl.com/help/api for detailed information on the Quandl API.