python-coingecko 0.0.4

Python wrapper for coingecko.com v3 api

python-coingecko

⚠️ This package is actively being developed and accepting PRs (see TODO section)!

A Python wrapper for coingecko.com V3 api. Other notable api wrappers that didn't satisfy my need:

• pycoingecko has not been active in over two years and does not support the newer endpoints

Features

• 🪙 CoinGecko api routes, including current beta
• ✏️ MyPy Fully typed using most recent versions
• ⚒️ Modern tooling like uv, ruff, and pre-commit
• 📥 GitHub Actions CI/CD to automate everything
• ↩️ Code Coverage Fully tested using tools like Codecov

Installation

$ pip install python-coingecko

Usage

Demo (free)

>>> from pycoingecko import CoinGecko
>>> coingecko = CoinGecko(api_key=<YOUR_API_KEY>)
>>> coingecko.simple.coin_price_by_id(ids="bitcoin")
{
  "bitcoin": {
    "usd": 67187.3358936566,
    "usd_market_cap": 1317802988326.25,
    "usd_24h_vol": 31260929299.5248,
    "usd_24h_change": 3.63727894677354,
    "last_updated_at": 1711356300
  }
}

Pro

>>> from pycoingecko import CoinGecko
>>> coingecko = CoinGecko(api_key=<YOUR_API_KEY>, is_pro=True)
>>> coingecko.coins.recently_added()
[
  {
    "id": "long-johnson",
    "symbol": "olong",
    "name": "Long Johnson",
    "activated_at": 1712562430
  },
  {
    "id": "dogita",
    "symbol": "doga",
    "name": "DOGITA",
    "activated_at": 1712562282
  },
  {
    "id": "bebe-on-base",
    "symbol": "bebe",
    "name": "Bebe on Base",
    "activated_at": 1712561709
  }
]

Development

To develop on this project, you'll need uv installed.

Install dev dependencies

$ uv sync

Run linters black/ruff/isort/mypy

$ make lint-all

Run pytest

$ make test

TODO

APIs

• Ping ✅
  • Check API server status
• Simple ✅
  • Coin Price
  • Token Address Price
  • Supported Currencies
• Coins ✅
  • Coins List
  • Coins List With Market Data
  • Coin Data
  • Coin Tickers
  • Coin Historical Data
  • Coin Historical Chart Data
  • Coin Historical Chart Data Within Time Range
  • Coin OHLC Chart
• Contract ✅
  • Coin Data
  • Coin Historical Chart Data
  • Coin Historical Chart Data Within Time Range
• Asset Platforms ✅
  • Asset List
• Categories ✅
  • List Categories
  • Market Data by Category
• Exchanges ✅
  • List Exchanges
  • Exchange Data
  • Tickers
  • Volume Chart
• Derivatives ✅
  • Tickers
  • Derivative Exchanges
  • Derivative Data
• NFTs (Beta)
  • List NFTs
  • Collection Data
• Exchange Rates ✅
  • BTC to Currency Rates
• Search ✅
  • General Search
• Trending ✅
  • Trending Search
• Global ✅
  • Global Market Data
  • DeFi Market Data
• Companies (Beta)
  • Public Companies Holdings
• Pro
• Enterprise
• On Chain

Ops

• CI for coverage and codecov

Docs

• Update README
• Add sphinx

Package

• Add polrs
• 100% coverage