Skip to main content

Historical data manager for cryptos.

Project description


PyPI Python Build Status License

Take one snapshot, use all data as cached.

Use it for machine learning, vector prediction or for whatever you like. Be my guest.

How this works?

You take one snapshot, and access hundreds of cryptos without slowing down.

Basically, this program parses all historical data, stores/caches at CSV files through running a snapshot. When you access through this package, requesting a data vector, calculates what coinmarketcap doesn’t give you, like circulation supply, daily percentage change, datetime object etc. and returns the vector.

If you want, you can use .csv files seperately.

File structure:

            CSV files
            JSON files


Install with pip or clone, both works.

$ pip install coindata
---- or ----
$ git clone
$ python coindata/ install


There are 3 modules you will use:


Update cache with snapshot

Note: It will ask for a snapshot at initial import, and show you the progress, write out the cache path.

>>> coindata.snapshot.take()

Get data with parser

>>> coindata.parser.vector_of('btc')
      . . .
     [ 'Date': string,
       'Open*': float,
       'High': float,
       'Low': float,
       'Close**': float,
       'Volume': float,
       'Market Cap': float,
       # additional info below #
       'date': datetime.object,
       'circulation': decimal,
       'change': float ]
       . . .

Get specific with request

You don’t need to use if you don’t want to get specific. API related operations. ( write, read, retrieve without writing, get ticker etc. )

Note: I recommend caching with snapshot.

# write all history of one $indicator to $where as CSV file
>>> coindata.request.write($indicator, $where)

Get documentation for more with built-in help() or read the code.

Important Notes

+ Symbol, name and case doesn't matter.

btc = BTC = bitcoin = BITCOIN

+ Based on USD.

+ Date notation is ISO8601 in CSV files. .. code:: python

>>> coindata.ISO8601

Give this a star this if you feel this helped you.

Also, if you want to buy a beer:

BTC: 16XwDdxUaphSX4yWDTTiSfNy2dTyEZ5MLy
ETH: 0x35F4B63f7eBBB2E6080F7f9f797A068004faf323
LTC: LdukNLZqzeEvvFYMw98L9Rj8AYvP86BhEe


1.1 (2019-01-27)

  • Major update to data manager
    • Refactor to

    • Add and

    • Update documentation

1.0 (????-??-??)

  • First release

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

coindata-1.1.tar.gz (6.9 kB view hashes)

Uploaded source

Built Distribution

coindata-1.1-py2.py3-none-any.whl (10.4 kB view hashes)

Uploaded py2 py3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page