pymarketcap 4.0.16
Python3 API and web scraper for coinmarketcap.com.
License: BSD License
Keywords: coinmarketcap,cryptocurrency,API,wrapper,scraper,json,BTC,Bitcoin,C,Curl,Cython

pymarketcap
===========


|TravisCI| |AppVeyor| |Status| |ReadTheDocs| |Binder|

|PyPI| |PyPI-Versions| |LICENSE|


pymarketcap is a library for retrieve data from
`coinmarketcap <http://coinmarketcap.com/>`_ API and website. Consist
of a cythonized scraper and and API wrapper built with libcurl, but is
posible to compile a lightweight version with standard ``urllib``


Install
=======

You need to install `cython <http://cython.readthedocs.io/en/latest/src/quickstart/install.html>`_ before pymarketcap. Try: ``pip3 install Cython`` and then:

::

   pip3 install pymarketcap

- On Windows, `urllib <https://docs.python.org/3/library/urllib.html>`_  will be used library by default to make synchronous requests whereas that on Linux/Mac will be built using `libcurl <https://curl.haxx.se/docs/install.html>`_ C library. You can control this (see below):


From source
-----------

::

    git clone https://github.com/mondeja/pymarketcap.git
    cd pymarketcap
    pip3 install -r requirements.txt
    python setup.py install

- To force installation with libcurl, use ``--force-curl`` in last command.
- To install with urllib, use ``--no-curl``.


Documentation
-------------
- `Static documentation at Readthedocs <https://pymarketcap.readthedocs.io>`_.
- `Live running notebook hosted at Binderhub <https://mybinder.org/v2/gh/mondeja/pymarketcap/master?filepath=doc%2Fsync_live.ipynb>`_.

`Contributing <https://github.com/mondeja/pymarketcap/blob/master/doc/dev_guide/contributing.rst>`_
---------------------------------------------------------------------------------------------------

`Testing <https://github.com/mondeja/pymarketcap/blob/master/doc/dev_guide/testing.rst>`__
------------------------------------------------------------------------------------------


`Changelog <http://pymarketcap.readthedocs.io/dev_guide/changelog.html>`_
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

`License <https://github.com/mondeja/pymarketcap/blob/master/LICENSE>`_
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Support
~~~~~~~

- Issue Tracker: https://github.com/mondeja/pymarketcap/issues
- |Ask me anything| mondejar1994@gmail.com


.. |TravisCI| image:: https://travis-ci.org/mondeja/pymarketcap.svg?branch=master
    :target: https://cnhv.co/1xgw5
.. |PyPI| image:: https://img.shields.io/pypi/v/pymarketcap.svg
    :target: https://cnhv.co/1xgwg
.. |PyPI-Versions| image:: https://img.shields.io/pypi/pyversions/pymarketcap.svg
    :target: https://cnhv.co/1xgwm
.. |Binder| image:: https://mybinder.org/badge.svg
    :target: https://mybinder.org/v2/gh/mondeja/pymarketcap/master?filepath=doc%2Fsync_live.ipynb
.. |Status| image:: https://img.shields.io/pypi/status/pymarketcap.svg
    :target: https://cnhv.co/1xgwm
.. |ReadTheDocs| image:: https://readthedocs.org/projects/pymarketcap/badge/?version=latest
    :target: https://cnhv.co/1xgx1
.. |AppVeyor| image:: https://ci.appveyor.com/api/projects/status/puy2p0qhjna4hosc?svg=true
    :target: https://cnhv.co/1xgx7
.. |LICENSE| image:: https://img.shields.io/pypi/l/pymarketcap.svg
    :target: https://cnhv.co/1xgxd
.. |Ask me anything| image:: https://img.shields.io/badge/Ask%20me-anything-1abc9c.svg