Skip to main content

Library for fetching coin/token metrics data from the internet.

Project description

https://raw.githubusercontent.com/im-n1/karpet/master/assets/logo.png

Karpet

Karpet is a tiny library with just a few dependencies for fetching coins/tokens metrics data the internet.

It can provide following data:

  • coin/token historical price data (no limits)

  • google trends for the given list of keywords (longer period than official API)

What is upcoming?

  • Reddit metrics

  • Have a request? Open an issue ;)

Dependencies

Library uses a few nifty dependencies and is Python 3.6+ only. There is no need to install dependencies you don’t need. Therefore this library utilizes extras which install optional dependencies:

  • for Google trends - google

  • for Twitter scraping - twitter

Usage

Install the library via pip.

~ pip install karpet  # Basics only
~ pip install karpet[twitter]  # For Twitter scraping
~ pip install karpet[google]  # For Google trends
~ pip install karpet[twitter,google]  # All features

Import the library class first.

from karpet.karpet import Karpet

Symbol (ticker) -> coninmarketcap.com URL slug conversion.

c = Karpet(date(2019, 1, 1), date(2019, 5, 1))
c.get_coin_slug("BTC")  # bitcoin

Retrieving historical data.

c = Karpet(date(2019, 1, 1), date(2019, 5, 1))
df = c.fetch_crypto_historical_data(coin="bitcoin")  # Dataframe with historical data
df.head()
https://raw.githubusercontent.com/im-n1/karpet/master/assets/historical_data.png

Retrieving Google Trends - in percents for the given date range.

c = Karpet(date(2019, 1, 1), date(2019, 5, 1))
df = c.fetch_google_trends(kw_list=["bitcoin"])  # Dataframe with trends.
df.head()
https://raw.githubusercontent.com/im-n1/karpet/master/assets/trends.png

And with a few lines of code you can get a chart

df = df.set_index("date")
df.plot()
https://raw.githubusercontent.com/im-n1/karpet/master/assets/trends_chart.png

Credits

This is my personal library I use in my long-term project. I can pretty much guarantee it will live for a long time then. I will add new features over time and I more than welcome any help or bug reports. Feel free to open an issue or merge request.

The code is is licensed under MIT license.

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

karpet-0.2.0rc1.tar.gz (5.4 kB view hashes)

Uploaded Source

Built Distribution

karpet-0.2.0rc1-py3-none-any.whl (6.7 kB view hashes)

Uploaded Python 3

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