CoinGecko Demo API

Name: CoinGecko Demo API API
Brand: CoinGecko
Availability: InStock

✓ Official Vendor SpecFinanceBankingapiKey41 EndpointsREST

For Agents

Look up crypto prices, market data, OHLC candles, exchanges, NFTs, and derivatives across thousands of assets and trading pairs aggregated by CoinGecko.

Quickstart

Get started with CoinGecko Demo API in minutes using your preferred integration method.

# Add to your MCP client config (Claude Desktop, Cursor, Windsurf)
{
  "jentic": {
    "url": "https://api.jentic.com/mcp",
    "auth": "oauth"
  }
}

# Then ask your agent:
"get current crypto prices for bitcoin and ethereum"

# → Jentic returns the GET /events tool with parameter schema, agent executes.

Capabilities

What an agent can do with CoinGecko Demo API API.

Get simple current prices for one or many coins quoted in any supported currency

Look up token prices by smart contract address on a specific blockchain platform

Retrieve OHLC candles, market chart series, and per-day historical snapshots for any coin

Browse exchanges, exchange tickers, and per-exchange volume data

GET STARTED

Start building with CoinGecko Demo API API

Explore with Jentic

View OpenAPI Document

Use for: Get the current price of bitcoin and ethereum in USD and EUR, Retrieve hourly OHLC candles for solana over the last 30 days, Look up the price of a token by its contract address on Ethereum, Find all coins matching the search term arbitrum

Not supported: Does not handle order placement, wallet management, or on-chain transactions — use for crypto, NFT, and derivatives market data only.

CoinGecko provides one of the most widely used cryptocurrency data APIs, aggregating prices, market metrics, exchanges, derivatives, NFT collections, and on-chain token data across thousands of assets. The Demo tier exposes 41 REST endpoints covering simple price lookups, coin metadata and history, OHLC candles, exchange data, search, trending coins, and global market metrics. It is a de facto reference dataset for crypto dashboards, portfolio trackers, and research tools.

Use Cases

Patterns agents use CoinGecko Demo API API for, with concrete tasks.

★ Crypto Portfolio Tracker

Power a portfolio tracker with live and historical pricing across thousands of coins and tokens. CoinGecko's simple price endpoint quotes any coin in any supported fiat or stablecoin in a single call, while market chart endpoints provide history for valuation and performance reporting. Integration usually takes a single afternoon for the read path.

Call GET /simple/price with ids=bitcoin,ethereum,solana and vs_currencies=usd and return the rates

Token Lookup by Contract Address

Surface live pricing and metadata for any ERC-20 or compatible token using its on-chain contract address. CoinGecko maps contract addresses to canonical coin ids and returns price, market cap, and volume. Useful for DeFi dashboards, wallet apps, and on-chain analytics tools.

Call GET /simple/token_price/ethereum with the contract address and vs_currencies=usd and return the price

Crypto Research and Trends

Power research dashboards and newsletters with trending coins, global market metrics, and detailed coin pages. The trending, global, and coins/{id} endpoints supply the narrative inputs (top movers, total market cap, dominance) plus per-coin developer, community, and link metadata.

Call GET /search/trending and return the top seven trending coin names with their CoinGecko ids

AI Crypto Research Agent via Jentic

Build an agent that answers crypto research questions by composing CoinGecko queries through Jentic. The agent expresses an intent in natural language; Jentic resolves the right endpoint and executes the call with stored credentials. Cost-effective for assistants that need broad coin coverage without per-exchange integration.

Through Jentic, fetch the current price and 24h change for the top three trending coins and summarise them in a brief paragraph

Key Endpoints

41 endpoints — coingecko provides one of the most widely used cryptocurrency data apis, aggregating prices, market metrics, exchanges, derivatives, nft collections, and on-chain token data across thousands of assets.

METHOD

PATH

DESCRIPTION

GET

/simple/price

Get current prices for one or many coins

GET

/simple/token_price/{id}

Get token price by contract address on a chain

GET

/coins/markets

List coin market data with pagination

GET

/coins/{id}/market_chart

Retrieve historical market chart data

GET

/coins/{id}/ohlc

Get OHLC candles for a coin

GET

/search/trending

List trending coins right now

GET

/simple/price

Get current prices for one or many coins

GET

/simple/token_price/{id}

Get token price by contract address on a chain

GET

/coins/markets

List coin market data with pagination

GET

/coins/{id}/market_chart

Retrieve historical market chart data

GET

/coins/{id}/ohlc

Get OHLC candles for a coin

Why though Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

CoinGecko API keys are stored encrypted in the Jentic vault. Agents receive scoped execution tokens — the raw x-cg-demo-api-key or x-cg-pro-api-key value never enters the agent's prompt or logs.

Intent-based discovery

Agents search Jentic by intent (e.g. get current crypto prices) and Jentic returns the matching CoinGecko operation with its parameter schema, so the agent calls the correct endpoint without browsing docs.

Time to first call

Direct integration: half a day for auth, pagination, and rate-limit backoff. Through Jentic: under 30 minutes — search, load schema, execute.

Related APIs

Alternatives and complements available in the Jentic catalogue.

Alternative

CoinMarketCap API

Closest competitor with broad rankings and market cap coverage

Choose CoinMarketCap when you need its specific rankings methodology or its widely cited market cap dataset

Alternative

CoinCap API

Lighter-weight free crypto pricing with a smaller endpoint surface

Choose CoinCap when you only need basic price and history and want a smaller endpoint surface

Complementary

CoinAPI Market Data REST API

Per-exchange OHLCV, trades, and order book data

Use alongside CoinGecko when you need per-exchange granularity such as order books or executed trades

FAQs

Specific to using CoinGecko Demo API API through Jentic.

What authentication does the CoinGecko API use?

The Demo and Pro tiers accept an API key either in the x-cg-demo-api-key header (or x-cg-pro-api-key for paid tiers) or as a query parameter. Through Jentic the key is stored in the encrypted vault and the agent receives a scoped execution token rather than the raw key.

Can I look up a token price by its contract address?

Yes. GET /simple/token_price/{id} accepts a platform id (for example ethereum) and one or more contract_addresses, returning the current price in any supported quote currencies. Use /simple/supported_vs_currencies to list valid quote currencies.

What are the rate limits for the CoinGecko Demo API?

The Demo tier permits roughly 30 calls per minute and a monthly call cap, while Pro tiers raise both limits substantially. Exact thresholds depend on the active plan attached to your API key — the OpenAPI spec does not declare them per endpoint.

How do I retrieve historical OHLC candles for a coin through Jentic?

Install the SDK with pip install jentic, search Jentic for get crypto ohlc candles, load the schema for GET /coins/{id}/ohlc, and execute with the coin id (e.g. bitcoin), vs_currency, and days parameter.

Does CoinGecko expose NFT and derivatives data in the same API?

Yes. The same v3 base URL exposes NFT collection metadata under /nfts and derivatives data under /derivatives, alongside coin and exchange endpoints — no separate auth or base URL is required.

Can I search for a coin by name or ticker?

Yes. GET /search accepts a free-text query and returns matching coins, exchanges, and NFT collections. For ranked lists, GET /search/trending returns the most-searched coins on CoinGecko in the last 24 hours.