parsimony-coingecko

CoinGecko connector — crypto market data via the CoinGecko v3 API and on-chain prices via GeckoTerminal.

Part of the parsimony-connectors monorepo. Distributed standalone on PyPI as parsimony-coingecko.

Connectors

11 connectors grouped by capability:

coingecko_top_gainers_losers is PRO-only, and coingecko_market_chart_range beyond 365 days is restricted on the Demo plan — both return PaymentRequiredError on a Demo key.

Install

pip install parsimony-coingecko

Pulls in a compatible parsimony automatically. Verify discovery:

python -c "from parsimony import discover; print([p.name for p in discover.iter_providers()])"

Configuration

Set the following environment variable:

export COINGECKO_API_KEY="<your-key>"

Get a Demo key at https://www.coingecko.com/en/api/pricing.

Quick start

import os
from parsimony_coingecko import load

# Bind the key off the call surface (kept out of provenance and logs).
connectors = load(api_key=os.environ["COINGECKO_API_KEY"])
result = connectors["coingecko_price"](ids="bitcoin", vs_currencies="usd")
print(result.raw.head())

If the key is not bound, each connector falls back to COINGECKO_API_KEY from the environment, and a missing key fails fast with UnauthorizedError.

For multi-plugin composition:

from parsimony import discover

connectors = discover.load_all()

Provider

• Homepage: https://www.coingecko.com
• API docs: https://docs.coingecko.com/v3.0.1/reference/introduction

License

See LICENSE.