Finance
Data source: CoinGecko API
MCP Protocol
Endpoint
https://context.gnist.ai/mcp/coingecko/
claude_desktop_config.json
{
"mcpServers": {
"gnist-coingecko": {
"url": "https://context.gnist.ai/mcp/coingecko/",
"headers": {
"Gnist-API-Key": "YOUR_API_KEY"
}
}
}
}
Shell
curl -X POST "https://context.gnist.ai/mcp/coingecko/" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-H "Gnist-API-Key: YOUR_API_KEY" \
-d '{"jsonrpc": "2.0", "method": "tools/call", "id": 1, "params": {"name": "search_coins", "arguments": {"query": "example"}}}'
REST API
API Root
https://context.gnist.ai/rest/coingecko/
7 endpoints available:
GET /rest/coingecko/search_coinsGET /rest/coingecko/get_priceGET /rest/coingecko/get_coin_detailGET /rest/coingecko/get_market_chartGET /rest/coingecko/get_trendingGET /rest/coingecko/get_marketsGET /rest/coingecko/report_feedback
Shell
curl "https://context.gnist.ai/rest/coingecko/search_coins?query=example" \ -H "Gnist-API-Key: YOUR_API_KEY"
Python
import httpx
resp = httpx.get(
"https://context.gnist.ai/rest/coingecko/search_coins",
headers={"Gnist-API-Key": "YOUR_API_KEY"},
params={
"query": "example"
},
)
print(resp.json())
Command Line
Command
gc coingecko
CLI documentation will be available when the GnistAI SDK is published.
Install
pip install gnistai
Available Tools (7)
search_coinsSearch for cryptocurrencies by name or ticker symbol.
| Parameter | Type | Required | Description |
|---|---|---|---|
query | string | required | Coin name or symbol (e.g. "bitcoin", "eth", "solana", "dogecoin"). |
get_priceGet current prices for one or more cryptocurrencies.
| Parameter | Type | Required | Description |
|---|---|---|---|
coin_ids | list[string] | required | Coin IDs (e.g. ["bitcoin", "ethereum"]). Use search_coins to find IDs. |
vs_currency | string | optional | Currency for prices: usd, eur, nok, gbp, btc, etc. (default: "usd") |
get_coin_detailGet comprehensive details for a cryptocurrency.
| Parameter | Type | Required | Description |
|---|---|---|---|
coin_id | string | required | CoinGecko coin ID (e.g. "bitcoin", "ethereum", "solana"). Use search_coins to find it. |
get_market_chartGet historical price chart data for a cryptocurrency.
| Parameter | Type | Required | Description |
|---|---|---|---|
coin_id | string | required | CoinGecko coin ID (e.g. "bitcoin"). Use search_coins to find it. |
vs_currency | string | optional | Quote currency (default 'usd'). (default: "usd") |
days | integer | optional | Days of history (1–365, default 30). 1=hourly, 2-90=hourly, 91+=daily. (default: 30) |
get_trendingGet trending cryptocurrencies — most searched coins in the last 24 hours.
get_marketsGet top cryptocurrencies ranked by market capitalization.
| Parameter | Type | Required | Description |
|---|---|---|---|
vs_currency | string | optional | Quote currency (default 'usd'). (default: "usd") |
limit | integer | optional | Number of results (1–50, default 20). (default: 20) |
category | any | optional | Category filter: 'decentralized-finance-defi', 'stablecoins', 'meme-token', 'layer-1', 'layer-2', 'gaming', etc. |
report_feedbackReport a bug, feature request, or general feedback for this data source.
| Parameter | Type | Required | Description |
|---|---|---|---|
feedback | string | required | |
feedback_type | string | optional | (default: "general") |