Docs menu

CoinGecko API endpoint

CoinGecko Markets API

Returns cryptocurrency market rows from CoinGecko. This endpoint supports the documented `vs_currency` enum and is not intended for real-time trading.

GETapiKey2 credits/requestCoinGeckocoingecko.marketsResponseDoc/coingecko/markets

Endpoint facts

Method: GET
API path: /coingecko/markets
Auth: apiKey
Credits: 2 credits/request
Charged on: Successful 2xx responses only
Platform: CoinGecko
Response schema: #/definitions/coingecko.marketsResponseDoc

CoinGecko scraping API Try CoinGecko Markets API in Playground CoinGecko API documentation

How this endpoint behaves

Returns market rows from CoinGecko.

Path parameters: none.

Query parameters:

page: Market page number. Defaults to 1.
limit: Maximum rows returned from the parsed page. Defaults to 100; maximum 100.
vs_currency: Quote currency. Allowed values: btc, eth, ltc, bch, bnb, eos, xrp, xlm, link, dot, yfi, sol, usd, aed, ars, aud, bdt, bhd, bmd, brl, cad, chf, clp, cny, czk, dkk, eur, gbp, gel, hkd, huf, idr, ils, inr, jpy, krw, kwd, lkr, mmk, mxn, myr, ngn, nok, nzd, php, pkr, pln, rub, sar, sek, sgd, thb, try, twd, uah, vef, vnd, zar, xdr, xag, xau, bits, sats.

Notable response behavior:

data.coins contains rank, CoinGecko id, symbol, name, URL, image URL, price, 1h/24h/7d percent changes, 24h volume, and market cap when present upstream.
Challenge pages, malformed HTML, and pages with zero parsed market rows return an upstream error.

Live monitoring

Monitored request: GET /coingecko/markets?limit=3&vs_currency=usd
Checks passed, 7 days to 14 Oct 2026: 100%
Median response time: 1.83 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /coingecko/markets?limit=20&vs_currency=usd
Items in coins: 20
Fields filled in every checked item: 10
Fields empty in some or all items: 2

Field	Filled in, of 20 checked	Values in the sample
rank	20	1 to 20, median 10
id	20
symbol	20	“BTC” and 19 other values
name	20	“Bitcoin” and 19 other values
url	20	coingecko.com
image_url	20	assets.coingecko.com and 1 other host
price	20	0.01 to 83,386.36, median 1.37
change_1h_percent	20	0 to 1.8, median 0.4
change_24h_percent	19	0.1 to 10.2, median 1.1
change_7d_percent	19	0 to 15.3, median 5.5
volume_24h	20	6,714,983,254 to 1,675,846,342,305, median 18,086,964,599
market_cap	20	8,764,702,088 to 1,675,871,108,053, median 24,034,254,807

Request parameters

Parameter	Type	Required	Description
page	integer	No	Page number, default 1
limit	integer	No	Rows to return, default 100, max 100
vs_currency	string	No	Quote currency Allowed values: btc, eth, ltc, bch, bnb, eos, xrp, xlm, link, dot, yfi, sol, usd, aed, ars, aud, bdt, bhd, bmd, brl, cad, chf, clp, cny, czk, dkk, eur, gbp, gel, hkd, huf, idr, ils, inr, jpy, krw, kwd, lkr, mmk, mxn, myr, ngn, nok, nzd, php, pkr, pln, rub, sar, sek, sgd, thb, try, twd, uah, vef, vnd, zar, xdr, xag, xau, bits, sats.
x-api-key (header)	string	Yes	API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/coingecko/markets?page=1&limit=10&vs_currency=btc" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "ok",
  "data": {
    "page": 1,
    "limit": 3,
    "vs_currency": "usd",
    "source_url": "https://www.coingecko.com/?page=1",
    "fetched_at": "2026-05-24T00:00:00Z",
    "coins": [
      {
        "rank": 1,
        "id": "bitcoin",
        "symbol": "BTC",
        "name": "Bitcoin",
        "url": "https://www.coingecko.com/en/coins/bitcoin",
        "price": 76535.94,
        "change_24h_percent": 1.5,
        "volume_24h": 26813530873,
        "market_cap": 1533816836729
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/coingecko.marketsResponseDoc

Field	Type	Required	Example	Description
code	integer	No	200
data	coingecko.MarketsResponse	No
data.coins	array	No		Coins on this page of the market table, ordered by market cap rank.
data.coins[].change_1h_percent	number	No	-0.1	Price change over the last hour, in percent.
data.coins[].change_24h_percent	number	No	1.5	Price change over the last 24 hours, in percent.
data.coins[].change_7d_percent	number	No	-1.9	Price change over the last 7 days, in percent.
data.coins[].id	string	No	bitcoin	CoinGecko coin id. Use it with the coin endpoint.
data.coins[].image_url	string	No	https://assets.coingecko.com/coins/images/1/standard/bitcoin.png	URL of the coin logo.
data.coins[].market_cap	number	No	1533816836729	Market capitalisation of the coin.
data.coins[].name	string	No	Bitcoin	Name of the coin.
data.coins[].price	number	No	76535.94	Current price of the coin.
data.coins[].rank	integer	No	1	Market cap rank of the coin.
data.coins[].symbol	string	No	BTC	Ticker symbol of the coin.
data.coins[].url	string	No	https://www.coingecko.com/en/coins/bitcoin	Link to the coin page on CoinGecko.
data.coins[].volume_24h	number	No	26813530873	Trading volume over the last 24 hours.
data.fetched_at	string	No	2026-05-24T00:00:00Z	Time the data was fetched, in UTC (RFC 3339).
data.limit	integer	No	100	Maximum number of coins returned.
data.page	integer	No	1	Page number returned.
data.source_url	string	No	https://www.coingecko.com/?page=1	URL the data was read from.
data.vs_currency	string	No	usd	Currency code from the request's vs_currency parameter.
msg	string	No	OK

Failure responses

Status	Description	Schema
400	Bad Request	#/definitions/app.Response
404	Not Found	#/definitions/app.Response
500	Internal Server Error	#/definitions/app.Response
503	Service Unavailable	#/definitions/app.Response

Code examples

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X GET "https://api.crawlora.net/api/v1/coingecko/markets?page=1&limit=10&vs_currency=btc" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

More CoinGecko endpoint docs CoinGecko scraping API CoinGecko categories API documentation CoinGecko Category Coins API documentation CoinGecko chains API documentation CoinGecko Chain API documentation CoinGecko Coin API documentation CoinGecko Coin Analysis API documentation

Open in Playground Back to group

Docs menu

CoinGecko API endpoint

CoinGecko Markets API

Returns cryptocurrency market rows from CoinGecko. This endpoint supports the documented `vs_currency` enum and is not intended for real-time trading.

GETapiKey2 credits/requestCoinGeckocoingecko.marketsResponseDoc/coingecko/markets

Endpoint facts

Method: GET
API path: /coingecko/markets
Auth: apiKey
Credits: 2 credits/request
Charged on: Successful 2xx responses only
Platform: CoinGecko
Response schema: #/definitions/coingecko.marketsResponseDoc

CoinGecko scraping API Try CoinGecko Markets API in Playground CoinGecko API documentation

How this endpoint behaves

Returns market rows from CoinGecko.

Path parameters: none.

Query parameters:

page: Market page number. Defaults to 1.
limit: Maximum rows returned from the parsed page. Defaults to 100; maximum 100.
vs_currency: Quote currency. Allowed values: btc, eth, ltc, bch, bnb, eos, xrp, xlm, link, dot, yfi, sol, usd, aed, ars, aud, bdt, bhd, bmd, brl, cad, chf, clp, cny, czk, dkk, eur, gbp, gel, hkd, huf, idr, ils, inr, jpy, krw, kwd, lkr, mmk, mxn, myr, ngn, nok, nzd, php, pkr, pln, rub, sar, sek, sgd, thb, try, twd, uah, vef, vnd, zar, xdr, xag, xau, bits, sats.

Notable response behavior:

data.coins contains rank, CoinGecko id, symbol, name, URL, image URL, price, 1h/24h/7d percent changes, 24h volume, and market cap when present upstream.
Challenge pages, malformed HTML, and pages with zero parsed market rows return an upstream error.

Live monitoring

Monitored request: GET /coingecko/markets?limit=3&vs_currency=usd
Checks passed, 7 days to 14 Oct 2026: 100%
Median response time: 1.83 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /coingecko/markets?limit=20&vs_currency=usd
Items in coins: 20
Fields filled in every checked item: 10
Fields empty in some or all items: 2

Field	Filled in, of 20 checked	Values in the sample
rank	20	1 to 20, median 10
id	20
symbol	20	“BTC” and 19 other values
name	20	“Bitcoin” and 19 other values
url	20	coingecko.com
image_url	20	assets.coingecko.com and 1 other host
price	20	0.01 to 83,386.36, median 1.37
change_1h_percent	20	0 to 1.8, median 0.4
change_24h_percent	19	0.1 to 10.2, median 1.1
change_7d_percent	19	0 to 15.3, median 5.5
volume_24h	20	6,714,983,254 to 1,675,846,342,305, median 18,086,964,599
market_cap	20	8,764,702,088 to 1,675,871,108,053, median 24,034,254,807

Request parameters

Parameter	Type	Required	Description
page	integer	No	Page number, default 1
limit	integer	No	Rows to return, default 100, max 100
vs_currency	string	No	Quote currency Allowed values: btc, eth, ltc, bch, bnb, eos, xrp, xlm, link, dot, yfi, sol, usd, aed, ars, aud, bdt, bhd, bmd, brl, cad, chf, clp, cny, czk, dkk, eur, gbp, gel, hkd, huf, idr, ils, inr, jpy, krw, kwd, lkr, mmk, mxn, myr, ngn, nok, nzd, php, pkr, pln, rub, sar, sek, sgd, thb, try, twd, uah, vef, vnd, zar, xdr, xag, xau, bits, sats.
x-api-key (header)	string	Yes	API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/coingecko/markets?page=1&limit=10&vs_currency=btc" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "ok",
  "data": {
    "page": 1,
    "limit": 3,
    "vs_currency": "usd",
    "source_url": "https://www.coingecko.com/?page=1",
    "fetched_at": "2026-05-24T00:00:00Z",
    "coins": [
      {
        "rank": 1,
        "id": "bitcoin",
        "symbol": "BTC",
        "name": "Bitcoin",
        "url": "https://www.coingecko.com/en/coins/bitcoin",
        "price": 76535.94,
        "change_24h_percent": 1.5,
        "volume_24h": 26813530873,
        "market_cap": 1533816836729
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/coingecko.marketsResponseDoc

Field	Type	Required	Example	Description
code	integer	No	200
data	coingecko.MarketsResponse	No
data.coins	array	No		Coins on this page of the market table, ordered by market cap rank.
data.coins[].change_1h_percent	number	No	-0.1	Price change over the last hour, in percent.
data.coins[].change_24h_percent	number	No	1.5	Price change over the last 24 hours, in percent.
data.coins[].change_7d_percent	number	No	-1.9	Price change over the last 7 days, in percent.
data.coins[].id	string	No	bitcoin	CoinGecko coin id. Use it with the coin endpoint.
data.coins[].image_url	string	No	https://assets.coingecko.com/coins/images/1/standard/bitcoin.png	URL of the coin logo.
data.coins[].market_cap	number	No	1533816836729	Market capitalisation of the coin.
data.coins[].name	string	No	Bitcoin	Name of the coin.
data.coins[].price	number	No	76535.94	Current price of the coin.
data.coins[].rank	integer	No	1	Market cap rank of the coin.
data.coins[].symbol	string	No	BTC	Ticker symbol of the coin.
data.coins[].url	string	No	https://www.coingecko.com/en/coins/bitcoin	Link to the coin page on CoinGecko.
data.coins[].volume_24h	number	No	26813530873	Trading volume over the last 24 hours.
data.fetched_at	string	No	2026-05-24T00:00:00Z	Time the data was fetched, in UTC (RFC 3339).
data.limit	integer	No	100	Maximum number of coins returned.
data.page	integer	No	1	Page number returned.
data.source_url	string	No	https://www.coingecko.com/?page=1	URL the data was read from.
data.vs_currency	string	No	usd	Currency code from the request's vs_currency parameter.
msg	string	No	OK

Failure responses

Status	Description	Schema
400	Bad Request	#/definitions/app.Response
404	Not Found	#/definitions/app.Response
500	Internal Server Error	#/definitions/app.Response
503	Service Unavailable	#/definitions/app.Response

Code examples

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X GET "https://api.crawlora.net/api/v1/coingecko/markets?page=1&limit=10&vs_currency=btc" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

Open in Playground Back to group

CoinGecko Markets API

Endpoint facts

How this endpoint behaves

Live monitoring

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related

CoinGecko Markets API

Endpoint facts

How this endpoint behaves

Live monitoring

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related