---
id: pycoingecko
version: "3.2.0"
license: MIT
license_treatment: permissive
maintenance: dormant
---

# pycoingecko — Python wrapper around the CoinGecko API

License: permissive · Maintenance: dormant · Downloads: 414.3K/mo

## What it is and what it does

Pycoingecko is a Python client library that wraps the CoinGecko cryptocurrency API, letting you query live and historical price data, market capitalization, trading volume, and exchange information for thousands of cryptocurrencies. It supports both the free public API and the paid Pro tier, with optional API key authentication. The library maps CoinGecko's REST endpoints to Python methods, handling parameter conversion (lists, booleans, strings) and returning JSON responses as Python dictionaries.

You use it by instantiating a CoinGeckoAPI object, optionally passing an API key, then calling methods like get_price(), get_coin_by_id(), or get_coin_market_chart_by_id() with the parameters documented in the CoinGecko API reference. It depends only on requests, so installation and setup are straightforward. However, the project is dormant—no updates in 639 days—so if CoinGecko's API evolves, you may encounter compatibility issues or missing endpoints.

Use it for:

- Fetch current cryptocurrency prices in multiple fiat currencies for a portfolio tracker or price dashboard
- Build historical price charts or analyze market trends using get_coin_market_chart_by_id() for OHLC data
- Monitor exchange listings and trading pairs for a coin using get_coin_ticker_by_id()
- Query market cap, 24-hour volume, and price changes for research or algorithmic trading signals
- Retrieve metadata (name, symbol, description) and contract addresses for token discovery

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Python wrapper around the CoinGecko API (v3) that fetches cryptocurrency prices, market data, historical charts, and exchange information from both public and pro API endpoints.

Yes, if you need a lightweight, zero-setup way to query CoinGecko's public cryptocurrency data and can tolerate dormant maintenance. The low install friction and permissive license make it a safe choice for prototypes and read-only data fetching. No, if you require active maintenance, up-to-date Pro API support, or expect CoinGecko's endpoints to change—consider forking or monitoring for a maintained alternative.

## Install

pip install pycoingecko
uv add pycoingecko
poetry add pycoingecko

## Installing pycoingecko

Before you install: Low install friction with a single runtime dependency (requests). Maintenance is dormant—last commit was 2024-11-13 and no release in 639 days—so expect no active bug fixes or feature updates, though the repository remains public and not archived.

License in practice: MIT license is permissive, allowing free use, modification, and distribution with minimal restrictions, making it safe for commercial and private projects.

Quickstart:

pip install pycoingecko

from pycoingecko import CoinGeckoAPI
cg = CoinGeckoAPI()
print(cg.get_price(ids='bitcoin', vs_currencies='usd'))

Verify before relying:

- Whether the public API rate limits or access policies have changed since the last release
- Compatibility with current CoinGecko API response formats and endpoint behavior
- Whether Pro API features work reliably with the latest CoinGecko Pro API v3.1.1

## Package facts

- License: MIT (permissive)
- Python support: unspecified
- Install friction: low
- Maintenance: dormant
- Downloads: 414.3K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

cryptocurrency price data api, coingecko python wrapper, crypto market data fetcher, bitcoin ethereum price lookup, cryptocurrency historical charts, crypto market cap and volume, coingecko api client, cryptocurrency, api-client, market-data

[View on SkillFed](https://skillfed.io/packages/pycoingecko) · [View on PyPI](https://pypi.org/project/pycoingecko/)