# Crypto market data

Let your agent read the market.

Get price history, market rankings and movers from CoinGecko for your agent’s analysis.



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¢.


## A real example

Tested on 2026-10-29 through CoinGecko.

One paid call from our own test run.

Your agent asked: Get the daily Bitcoin price in USD for the last 7 days

Returned in this test:

- Price observations: 8
- Also returned: Market caps and total volumes

Charged in this test: $0.06.

One seven-day daily snapshot from the provider.




## Connect your agent

Read the [setup guide](https://taskfuel.ai/docs/setup/) and choose the connection your agent supports.

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

### Check the data behind your idea.

Request the time range you need. Check for missing dates before drawing a conclusion.

### Fill a view with market data.

Fetch the fields your interface needs. Each refresh is another request.

### Use a paid call when it earns its place.

For a price you can already get from a free source, use that source.




## Questions

### Can't my agent just look up a price for free?

For one current price, a free source may be enough. TaskFuel is useful when your agent needs structured data from a supported provider in the same task. Check the requested history range and the price first.

### What does a call cost?

Our seven-day Bitcoin/USD history request cost 6¢ on 29 October 2026. Your agent shows the price for your own request before it pays.

### Where does the data come from?

This guide uses CoinGecko through TaskFuel. Fields, coverage and freshness depend on the selected provider.

### Do I need a CoinGecko account or API key?

No. Your agent pays from your TaskFuel balance, so there is nothing else to sign up for.

### What can it actually answer?

Historical and current prices, market caps and volumes, ranked market pages, per-coin profiles, tokens by contract address, exchange listings and rates, categories, trending coins, top gainers and losers, and global and DeFi market stats.

### Can it watch a price for me?

Your AI can check again whenever you ask, and each check is billed separately. There is no standing subscription quietly polling in the background.

### What if a lookup fails?

A provider error (4xx or 5xx) is not charged. A lookup that succeeds with an empty or unhelpful answer can still be charged.

## Related tool guides

- [Read prediction market questions and outcome prices](https://taskfuel.ai/tools/polymarket-mcp/)
- [Find the posts behind a market claim](https://taskfuel.ai/tools/x-search/)
- [Compare prediction market API options](https://taskfuel.ai/tools/prediction-market-api/)
- [Compare Finnhub alternatives for stock data](https://taskfuel.ai/tools/finnhub-alternative/)


## Reference

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