Retrieve per-coin metadata from CoinGecko (CMC-compatible columns)

Companion to crypto_info() but for CoinGecko. Pulls descriptive metadata (description, categories, logos, contract addresses across chains, links) for each coin in coin_list. Uses the documented public API endpoint api.coingecko.com/api/v3/coins/{slug} (no key required; ~30 req/min).

Usage

cg_info(
  coin_list = NULL,
  limit = NULL,
  requestLimit = 1,
  sleep = 0,
  finalWait = FALSE
)

Arguments

coin_list: string if NULL retrieve all currently existing coins (cg_list()), or provide list of cryptocurrencies in the cg_list() / cg_listings() format.
limit: integer Return the top n records, default is all tokens.
requestLimit: Kept for parity with crypto_info() – ignored (CoinGecko endpoint is one coin per call).
sleep: integer (default 0) Seconds to sleep between API requests. The internal client enforces a polite floor (default 2.5s) to stay under the Demo-tier 30 req/min cap.
finalWait: Sleep 60s after the last call (mirrors crypto_info()).

Value

Tibble with one row per coin:

id: CoinGecko internal numeric id (from image$thumb).
name, symbol, slug: Coin identifiers.
category: "coin" if asset_platform_id is NA, else "token".
description: English description (HTML stripped to text).
logo: URL of the large coin logo.
status: Status notice from CoinGecko (public_notice field).
notice: Additional notices (additional_notices joined).
date_added: Date the coin was added to CoinGecko (genesis_date when set, else NA).
date_launched: Same as date_added for CG (no separate launch field exposed).
categories: List-column of coin categories.
platforms: List-column: per-chain contract addresses.
web_slug: CoinGecko canonical web slug (sometimes differs from API slug).
country_origin: Country of project origin (often empty).
sentiment_votes_up_percentage, sentiment_votes_down_percentage: Community sentiment percentages.
watchlist_portfolio_users: Number of CG users watching this coin.
url: List-column of resource URLs (homepage, whitepaper, blockchain explorers, forums, repos, chats, announcements, subreddit, twitter).

Details

Column names mirror crypto_info() where there is a direct equivalent, and add a few CG-specific fields (platforms, categories).

Examples

if (FALSE) { # \dontrun{
info <- cg_info(cg_list(top_n = 50))
} # }