parsimony-coingecko 0.4.0

CoinGecko connector for the parsimony framework

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:

Name	Kind	Description
coingecko_search	fetch	Resolve coin names/symbols to CoinGecko IDs.
coingecko_trending	fetch	Top 7 trending coins by 24-h search volume.
coingecko_top_gainers_losers	fetch	Top gaining and losing coins over a window.
coingecko_price	fetch	Current price(s) for one or more coins in one or more vs-currencies.
coingecko_markets	fetch	Ranked market data (price, market cap, ATH/ATL, 24h change), paged.
coingecko_coin_detail	fetch	Full per-coin metadata (description, links, market data) — returns nested dict.
coingecko_market_chart	fetch	Historical price/market-cap/volume over the last N days.
coingecko_market_chart_range	fetch	Historical price/market-cap/volume between two ISO dates.
coingecko_ohlc	fetch	OHLC candlesticks for a coin.
coingecko_token_price_onchain	fetch	On-chain token price by contract address (GeckoTerminal).
enumerate_coingecko	enumerator	Full coin list (~15 000 rows) for catalog indexing.

Install

pip install parsimony-coingecko

Pulls in parsimony-core>=0.4,<0.5 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 asyncio
from parsimony_coingecko import CONNECTORS

async def main():
    connectors = CONNECTORS.bind_env()
    result = await connectors["coingecko_price"](ids="bitcoin", vs_currencies="usd")
    print(result.data.head())

asyncio.run(main())

For multi-plugin composition:

from parsimony import discover
connectors = discover.load_all().bind_env()

Provider

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

License

See LICENSE.