CoinGecko Integration

Abstraxn Agent Kit supports CoinGecko market data and GeckoTerminal on-chain analytics using your CoinGecko API key (BYOK). Agents call the data_and_analytics MCP tool; responses are read-only — no wallet signing or on-chain transactions. The sample web app includes a Portfolio & Price predefined specialist agent (?serviceAgent=portfolio) tuned for balances, spot prices, charts, and — when CoinGecko is enabled — richer market and on-chain datasets via data_and_analytics.

Plans

Plan	API base	When to use
demo	`https://api.coingecko.com/api/v3`	Development and light usage
pro	`https://pro-api.coingecko.com/api/v3`	Production workloads and higher rate limits

Get keys from CoinGecko (Demo or Pro depending on your plan).

Dashboard setup

Open Agentic Stack → Integrations for your application.
Enable CoinGecko.
Select plan (demo or pro) and paste your API key.
Save — credentials are encrypted server-side and included in agent validation for MCP calls.

CoinGecko credentials are stored per application, not per end user. All agents under that app share the integration when enabled.

MCP tool: `data_and_analytics`

Requires CoinGecko enabled in Integrations. If disabled, the tool returns COINGECKO_NOT_ENABLED with setup instructions.

Parameter	Required	Description
`action`	Yes	Dataset to fetch (see actions below)
`coin_id`	For some actions	CoinGecko coin id (e.g. `ethereum`, `bitcoin`)
`query`	For `search`	Search text
`vs_currency`	No	Quote currency for price actions (default `usd`)
`network`	For on-chain actions	GeckoTerminal network slug (e.g. `eth`, `solana`, `base`)
`token_address`	For on-chain token actions	Contract address
`pool_address`	For `onchain_pool`	Pool address
`limit`	No	Max rows for list actions (default `20`, max `100`)
`days`	No	Lookback for charts (default `30`)
`from_date` / `to_date`	For `market_chart_range`	ISO dates `YYYY-MM-DD`
`duration`	No	For `top_gainers_losers` (e.g. `24h`)
`sort`	No	For `onchain_megafilter` (e.g. `pool_created_at_desc`)

Aggregated market actions (CoinGecko API)

`action`	Description
`coin_price`	Spot price for one or more coins
`coin_markets`	Market table (cap, volume, change)
`global_market`	Total crypto market stats
`global_defi`	DeFi market overview
`search`	Search coins, categories, exchanges
`trending`	Trending coins
`coin_detail`	Full coin metadata
`categories`	Category list
`market_chart`	Historical price/volume/market cap
`market_chart_range`	Chart between two dates
`ohlc`	OHLC candle data
`top_gainers_losers`	Top movers for a duration
`exchanges`	Exchange list
`ping`	API health check

On-chain actions (GeckoTerminal)

`action`	Description
`onchain_token_price`	DEX token price on a network
`onchain_pool`	Pool details
`onchain_trending_pools`	Trending pools
`onchain_new_pools`	Recently created pools
`onchain_megafilter`	Filtered pool discovery
`onchain_token_info`	On-chain token metadata

Example tools/call (application API key — include agent_id when required):

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "data_and_analytics",
    "arguments": {
      "agent_id": "AGENT_UUID",
      "action": "coin_price",
      "coin_id": "ethereum",
      "vs_currency": "usd"
    }
  }
}

Portfolio & Price specialist chat

In the sample web app, open chat with ?serviceAgent=portfolio (or pick Portfolio & Price from the agent category picker). The backend:

Filters tools to read-only portfolio and market calls
Injects Portfolio-specific system prompts (no transfers, swaps, or paid APIs)
Uses wallet tools (get_balance, get_token_price, token_chart, etc.) for holdings and simple prices
Uses data_and_analytics when CoinGecko is enabled for global markets, trending, gainers/losers, and GeckoTerminal on-chain data

The Portfolio agent is read-only. For transfers use ?serviceAgent=transfer; for swaps use Uniswap, LiFi, Jupiter, or 1inch agents.

`get_token_price` vs `data_and_analytics`

Tool	CoinGecko BYOK	Behavior
`get_token_price`	Not required	Simple spot price via public CoinGecko API; subject to x402 spend policy on paid tiers
`data_and_analytics`	Required	Full CoinGecko + GeckoTerminal datasets using your plan and API key

Enable CoinGecko when agents need market tables, trending lists, historical charts beyond token_chart, or on-chain pool analytics.

Errors

Code	Meaning
`COINGECKO_NOT_ENABLED`	Integration disabled or missing plan/key in dashboard
`RATE_LIMITED`	CoinGecko rate limit — retry later or upgrade plan
`NOT_FOUND`	Unknown coin, network, or pool
`INVALID_INPUT`	Missing or invalid `action` / parameters
`TIMEOUT`	Upstream request timed out

Third-party integrations

BYOK overview, architecture, and deployment.

MCP tools reference

Full tool catalog including data_and_analytics.

Full-stack integration

Sample backend + web app with category agents and chat.

Dashboard setup

Agentic Stack navigation and Integrations tab.

Getting started

SDK & wallets

Third-party integrations

Off-chain policies

Identity

Build your app

MCP

Payments

Help

Plans

Dashboard setup

MCP tool: `data_and_analytics`

Aggregated market actions (CoinGecko API)

On-chain actions (GeckoTerminal)

Portfolio & Price specialist chat

`get_token_price` vs `data_and_analytics`

Errors

Third-party integrations

MCP tools reference

Full-stack integration

Dashboard setup

​Plans

​Dashboard setup

​MCP tool: data_and_analytics

​Aggregated market actions (CoinGecko API)

​On-chain actions (GeckoTerminal)

​Portfolio & Price specialist chat

​get_token_price vs data_and_analytics

​Errors

​Related

Third-party integrations

MCP tools reference

Full-stack integration

Dashboard setup

Plans

Dashboard setup

MCP tool: `data_and_analytics`

Aggregated market actions (CoinGecko API)

On-chain actions (GeckoTerminal)

Portfolio & Price specialist chat

`get_token_price` vs `data_and_analytics`

Errors

Related