# Let Claude Code read the market.

Years of price history, a ranked page of the whole market, the day's biggest movers. The calls a free endpoint rate-limits you out of, at 6¢ each. No CoinGecko account of your own.

Provider in the worked example: CoinGecko.

Price shown for this route: 6¢ per call.

## What it can do

### Market chart

Request historical price, market cap and volume for a coin over a supported time range.

Price: 6¢.

### Top gainers and losers

Get the largest gains and losses over a supported time period.

Price: 6¢.

### Coins markets

Request a ranked page of coins with market data and optional sparklines.

Price: 6¢.

### Coin history

Get a market-data snapshot for a coin on a specified date.

Price: 6¢.

### Categories

Compare coin categories using market cap and volume.

Price: 6¢.

### Coin data

Request a coin’s profile and market data.

Price: 6¢.

### Token price by contract

Look up a token price by contract address and chain.

Price: 6¢.

### Trending

See the coins and categories attracting recent searches.

Price: 6¢.

### Global

Get total market cap, volume and Bitcoin dominance.

Price: 6¢.

### Global DeFi

Get DeFi market totals.

Price: 6¢.

### Exchanges

Look up exchange data and reported volume.

Price: 6¢.

### Exchange rates

Get Bitcoin exchange rates against supported currencies.

Price: 6¢.

### Simple price

Request prices for one or more coins in a supported currency.

Price: 6¢.

### Search

Find a coin or exchange by keyword.

Price: 6¢.

### Coins list

Resolve a coin’s name or ticker to its provider ID.

Price: 6¢.

## Connect your agent

Read the [Claude Code setup guide](https://taskfuel.ai/docs/setup-cli/).

Use one TaskFuel account and prepaid balance. Inspect the provider and request quote before a paid call, then review the returned response and recorded charge.

## When to use it

### Backtest on real history.

A strategy is only as good as the data behind it. Pull history for any coin at 6¢ a call and let Claude Code write the backtest in the same session.

### Stop working around a rate limit.

Free crypto endpoints throttle exactly when a script starts being useful. A per-call price is predictable: you know what the run costs before you start it.

### Ask the question, not the API.

Which categories moved this week, what the top hundred look like by volume, where a token traded a year ago. Claude Code makes the calls and reads the answer back.

## Questions

### Can Claude Code get crypto prices?

Not on its own. Connect TaskFuel and it calls CoinGecko as a tool, 6¢ a call, with no key of your own and no free-tier rate limit to work around.

### Do I need a CoinGecko API key?

No. One TaskFuel account and one prepaid balance covers it. TaskFuel pays the provider and bills your balance.

### What does a call cost?

6¢ for market chart, top gainers and losers, coins markets, coin history, categories and coin data. Claude Code reads the exact price before it pays.

### Can it build me a trading bot?

It can write one and feed it real data. What it cannot do is place a trade: this is market data, not an exchange connection. Anything that moves money is still yours to wire up.

### Which coins are covered?

CoinGecko's catalogue, which is broad enough that the answer is usually yes. Your agent can list the categories and the ranked market to find what it needs.

### What if a call fails?

Upstream 4xx and 5xx responses are not charged. A successful provider response can still be charged when its answer is empty or unhelpful.

## Reference

- [Read this guide on the website](https://taskfuel.ai/tools/crypto-market-data/claude-code/).
- [Browse providers and capabilities](https://taskfuel.ai/catalog/).
- [Pricing](https://taskfuel.ai/pricing/).
- [Agent instructions](https://taskfuel.ai/llms.txt).
