Crypto market data API

Finance & crypto · v1.1.0 · coingecko_coins

$0.0002 / coin

$0.16 / 1K · pay per delivered coin

A crypto market data API that returns one row per coin from CoinGecko's public markets endpoint: current price in your quote currency, market cap and rank, 24h volume, 24h change with the session high and low, circulating and total supply, and the all-time high with its date. Take the market-cap ranking as is, or narrow to specific coin ids or a category.

By Aldo Morese, founder of QuanticData · Published Aug 21, 2026 · Updated Sep 3, 2026

Run in dashboard See the request

$0.0002 per delivered coin · $2 free every month · Failed runs never billed

What it does

What a crypto market data API does

Most "crypto price" feeds hand you a single number per symbol and leave the rest — cap, volume, supply, ATH — to stitch from other calls. This reads the markets table, so every row already carries the columns an analysis joins on, in the vs_currency you asked for rather than a USD figure you then convert.

The source is CoinGecko's aggregate across exchanges, not one venue's order book, so the price is a market view rather than a single exchange's. You pass coin ids, a category slug like stablecoins, or nothing at all for the ranking; up to 250 coins come back in one run, each stamped with the time CoinGecko last updated it.

Inputs

The whole request. Anything you leave out falls back to the default shown in the catalog.

Input	Type	Required	What it does
`vs_currency`	string	no	Quote currency (usd, eur, btc…).
`coin_ids`	array	no	Specific CoinGecko ids (bitcoin, ethereum…). Empty = ranking order.
`category`	string	no	CoinGecko category slug, e.g. stablecoins, meme-token.
`order`	string	no	Sort order (default market_cap_desc). One of: `market_cap_desc`, `market_cap_asc`, `volume_desc`, `volume_asc`, `id_asc`, `id_desc`.
`max_results`	integer	no	How many coins to deliver at most (1–250). You pay only for delivered coins.

Outputs — 28 fields, one row per coin

What one coin looks like

Every delivered coin carries these fields. Nullable means the source did not publish it — the field stays empty instead of being guessed.

Field	Type	What it holds
`rank`	integer	Row order as returned.
`id`	string	CoinGecko coin id.
`symbol`	string	Ticker symbol (uppercase).
`name`	string · nullable	Coin name.
`price`	number · nullable	Current price in vs_currency.
`currency`	string	Quote currency (uppercase).
`market_cap`	number · nullable	Market capitalization.
`market_cap_rank`	integer · nullable	Global market-cap rank.
`volume_24h`	number · nullable	24h trading volume.
`change_24h_pct`	number · nullable	24h price change %.
`high_24h`	number · nullable	24h high.
`low_24h`	number · nullable	24h low.
`circulating_supply`	number · nullable	Circulating supply.
`total_supply`	number · nullable	Total supply.
`ath`	number · nullable	All-time high price.
`ath_date`	string · nullable	All-time high date.
`image`	string · nullable	Coin icon URL.
`last_updated`	string · nullable	Data timestamp.
`fully_diluted_valuation`	number · nullable	Fully diluted valuation in vs_currency.
`change_24h`	number · nullable	24h price change in vs_currency.
`change_1h_pct`	number · nullable	1h price change %.
`change_7d_pct`	number · nullable	7d price change %.
`change_30d_pct`	number · nullable	30d price change %.
`market_cap_change_24h_pct`	number · nullable	24h market-cap change %.
`max_supply`	number · nullable	Maximum supply, when the coin has a cap.
`ath_change_pct`	number · nullable	Distance from the all-time high, %.
`atl`	number · nullable	All-time low price.
`atl_date`	string · nullable	All-time low date.

Integration

One POST, typed rows

Base URL https://api.quanticdata.io/v1, Bearer auth, the same key as every other Data API. Endpoint: POST /v1/scraper/collectors/coingecko_coins/run.

curl -X POST https://api.quanticdata.io/v1/scraper/collectors/coingecko_coins/run \
  -H "Authorization: Bearer $QD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"vs_currency":"usd","max_results":50}'

import requests

r = requests.post(
    "https://api.quanticdata.io/v1/scraper/collectors/coingecko_coins/run",
    headers={"Authorization": f"Bearer {QD_API_KEY}"},
    json={
        "vs_currency": "usd",
        "max_results": 50
    },
    timeout=120,
)
for row in r.json()["payload"]["results"]:
    print(row)

const res = await fetch(
  "https://api.quanticdata.io/v1/scraper/collectors/coingecko_coins/run",
  {
    method: "POST",
    headers: {
      Authorization: `Bearer ${process.env.QD_API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({"vs_currency":"usd","max_results":50}),
  },
);
const { payload } = await res.json();
console.table(payload.results);

claude mcp add quanticdata \
  -e QUANTICDATA_API_KEY=qd_live_your_key_here \
  -- npx -y quanticdata-mcp

# then, in the chat:
> run the coingecko_coins collector with vs_currency="usd" and max_results=50

Example response

POST /v1/scraper/collectors/coingecko_coins/run

$ curl $QD/coingecko_coins/run \
    -H "Authorization: Bearer $QD_API_KEY" \
    -d '{"vs_currency": "usd", "max_results": 50}'
{ "status": "done", "count": 50,
  "results": [
    {
      "id": "…",
      "symbol": "…",
      "name": "…",
      "price": … } ],
  "cost": 0.01 }
# 50 coins × $0.0002 · nothing delivered, nothing charged

Try it

Crypto market data (CoinGecko), running now

Change the input and run it against the live collector — nothing to install, no sign-up.

Run it from your own code, on your own inputs

Same collector, same rows — $2 of free API credit every month, no card.

Get my free API key

Crypto market data API: from vs_currency, QuanticData reads the crypto market page and returns one row per coin with name, symbol and price, at $0.0002 per delivered coin. — You send vs_currency and coin_ids; the run reads the source and comes back as coins with rank, id and symbol — 28 fields on every row — and you are billed $0.0002 for each coin actually delivered, nothing for a run that delivers none.

$0.0002 / coin10,000 coins on the free $2 every month

Semantic inputvs_currency, coin_ids, category — no URL lists

Up to 250coins per run, pagination handled for you

No browserread over HTTP/TLS — cheaper and faster than rendering

Pricing

Crypto market data API pricing

$0.0002 per delivered coin. A run that delivers nothing costs nothing: blocked pages, challenges and retries are on us, and the $2 monthly allowance covers about 10,000 coins before you spend anything.

$0.0002per delivered coin$0.16 per 1,000 delivered coins

10,000 coinson the free allowance$2 every month, no card

Zero rowszero chargeblocks, captchas and retries are on us

−30%on volume tiersthe catalog returns your key's price

Pay as you go

$0/mo

$2 free credit / month
60 requests / min
List unit prices

Starter

$19/mo

$15 free credit / month
300 requests / min
10% off unit prices

Growth

$79/mo

$50 free credit / month
600 requests / min
20% off unit prices

Scale

$299/mo

$250 free credit / month
1,200 requests / min
30% off unit prices

Same wallet, same key and same $2 monthly allowance as every other Data API. Prices are launch pricing read live from the billing config — GET /v1/scraper/collectors returns the price your key actually pays.

What people build with the crypto market data API

Three shapes of work this endpoint was designed around.

Portfolio valuation

Price a holdings list in one call by passing its coin ids, each row already denominated in your reporting currency via vs_currency.

Market dashboards

Rank the top coins by market cap or volume and read change, high and low for a movers board without a second request.

Category screening

Pull a category such as stablecoins or meme-token and compare cap, volume and supply across only that segment.

Crypto market data API versus rolling your own

The differences that actually cost time when you build this in-house.

	DIY scraper	This collector
Per row	One price number per call	Price, cap, volume, supply, 24h range and ATH together
Quote currency	USD you convert yourself	Any vs_currency, priced at read time
Selection	One coin per request	Ranking, an id list, or a category in one run

What people search for

Live autocomplete demand around Crypto market data (CoinGecko), pulled with our own Keyword ideas collector.

Crypto market data API: the POST to the coingecko_coins collector, 50 coins delivered and the bill, 50 × $0.0002 = $0.01 in usage.cost_usd; zero coins would cost $0. — The same call you would paste into a terminal: a Bearer key, vs_currency, coin_ids and category in the body, and back the envelope every QuanticData endpoint returns — type, message, payload — where count is how many coins arrived and usage.cost_usd is $0.01, which is 50 × $0.0002. A run that delivers nothing costs nothing. The key is good for 60 req/min on the free tier.

Sources and standards

The platform documentation and standards this collector is built against — check any claim on this page against the primary source:

FAQ

Questions we get about the crypto market data API.

Something else? Ask us

Is this real-time or a snapshot?

Each row carries CoinGecko's last_updated timestamp, so you read the latest aggregate it publishes and can see how fresh each coin is. It is a poll of the markets endpoint per run, not a streaming socket.

Can I price in EUR or BTC instead of USD?

Yes. vs_currency takes usd, eur, btc and the other quotes CoinGecko supports, and every numeric field — price, market cap, volume, ATH — comes back already denominated in it.

How do I read just the coins I hold?

Pass their CoinGecko ids in coin_ids (bitcoin, ethereum, solana…). Leave it empty for the market-cap ranking instead, or add a category to scope that ranking to one segment.

Is there a free crypto market data API?

Every account gets $2 of credit every month with no card, which is about 10,000 delivered coins on this endpoint at $0.0002 each. It renews monthly, and a run that delivers nothing is never billed — so a failed or blocked attempt does not eat the allowance.

How much does one run cost?

Multiply the rows you actually receive by $0.0002. A run capped at 250 coins — the maximum for this collector — costs $0.05 if every row comes back, and less when the source has fewer. Volume tiers take up to 30% off, and GET /v1/scraper/collectors returns the price your key actually pays.

Run the crypto market data API now

$2 of free credit every month, no card. Your key returns its own prices from GET /v1/scraper/collectors.

Run in dashboard

Illustration: three coloured zones of the page that is read (Crypto market page) turn into clean JSON with the fields name, symbol and price; 28 fields on every row.