Skip to main content
POST /v1/data/coingecko/coins/run Pricing: $0.0015 per coin ($1.50 per 1,000).

Ways to call it

  • Top coins (optional: currency, maxResults)
  • By coin ID: set coinIds (optional: currency, maxResults)
  • By ticker: set symbols (optional: currency, maxResults)
  • By category: set category (optional: currency, maxResults)

Request

Send the inputs under params. Only the keys below are accepted; any other key returns 422 invalid_params.
string[]
CoinGecko coin ids, the last part of the coin page URL coingecko.com/en/coins/<id> (e.g. bitcoin, ethereum, jasmycoin). One row per coin found; an unknown id returns no row and is not billed. Not allowed with Tickers.
string[]
Coin tickers such as btc, eth, sol (any case). Each ticker returns its highest-ranked coin, so use Coin IDs when several coins share a ticker. Not allowed with Coin IDs.
string
CoinGecko category id, the last part of coingecko.com/en/categories/<id>, e.g. meme-token, layer-1, stablecoins. Returns the coins in that category by market cap.
string
default:"USD"
Currency for price, market cap, volume, highs and lows. USD by default.63 allowed values, for example USD, EUR, GBP, JPY, CNY, KRW, INR, RUB, TRY, BRL. Fetch the full list with GET /v1/data/coingecko/coins?expand=options.
integer
default:"100"
How many coins to return in total, up to 1000. Defaults to 100; use 0 for all.Max 1000.

Example

Response fields

Each row in data is one coin, keyed by these fields.

Example response

Abridged: long text and lists are shortened.
For funding, investors and contract addresses use crypto/projects.