---
title: "CoinGecko category coins"
method: GET
path: "/coingecko/category/{slug}/coins"
tags: ["CoinGecko"]
---

# CoinGecko category coins

`GET /coingecko/category/{slug}/coins`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/coingecko/category/{slug}/coins`
- Auth: API key in header `x-api-key`

Lists the coins in one CoinGecko category, identified by the required `slug` such as `stablecoins`. Paged with `page` (default 1) and `limit` (default and max 100), priced in `vs_currency`. Each coin has rank, symbol, price, 1h to 30d changes, 24h volume, market cap and fully diluted valuation.

## Path parameters

- `slug` string, required

## Query parameters

- `page` integer
- `limit` integer
- `vs_currency` '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'

## Headers

- `x-api-key` string, required

## Response `200`

OK

- CoingeckoCategoryCoinsResponseDoc
  - `code` integer
  - `data` CoingeckoCategoryCoinsResponse
    - `coins` CoingeckoCategoryCoinRow[]: Coins in the category on this page.
      - `change_1h_percent` number: Price change over the last hour, in percent.
      - `change_24h_percent` number: Price change over the last 24 hours, in percent.
      - `change_30d_percent` number: Price change over the last 30 days, in percent.
      - `change_7d_percent` number: Price change over the last 7 days, in percent.
      - `fully_diluted_valuation` number: Fully diluted valuation.
      - `id` string: CoinGecko coin id.
      - `image_url` string: URL of the coin logo.
      - `market_cap` number: Market capitalisation of the coin.
      - `market_cap_fdv_ratio` number: Market capitalisation divided by fully diluted valuation.
      - `name` string: Name of the coin.
      - `price` number: Current price of the coin.
      - `rank` integer: Market cap rank of the coin.
      - `symbol` string: Ticker symbol of the coin.
      - `url` string: Link to the coin page on CoinGecko.
      - `volume_24h` number: Trading volume over the last 24 hours.
    - `fetched_at` string: Time the data was fetched, in UTC (RFC 3339).
    - `limit` integer: Maximum number of coins returned.
    - `name` string: Name of the category.
    - `page` integer: Page number returned.
    - `slug` string: URL slug of the category.
    - `source_url` string: URL the data was read from.
    - `vs_currency` string: Currency code from the request's vs_currency parameter.
  - `msg` string

## Other responses

- `400`: Bad Request
- `404`: Not Found
- `500`: Internal Server Error
- `503`: Service Unavailable

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/afac9b012a27?raw)
