coingecko-pro 0.1.0

package/dist/index.js

@@ -0,0 +1,2254 @@
+// src/utils/cache.ts
+var TTLCache = class {
+  store = /* @__PURE__ */ new Map();
+  defaultTtl;
+  /**
+   * @param defaultTtl - Default time-to-live in milliseconds for new entries.
+   */
+  constructor(defaultTtl) {
+    this.defaultTtl = defaultTtl;
+  }
+  /**
+   * Retrieves a value from the cache.
+   * Returns `undefined` if the key does not exist or has expired.
+   *
+   * @param key - Cache key.
+   * @returns The cached value, or `undefined` if missing/expired.
+   */
+  get(key) {
+    const entry = this.store.get(key);
+    if (entry === void 0) return void 0;
+    if (Date.now() > entry.expiresAt) {
+      this.store.delete(key);
+      return void 0;
+    }
+    return entry.value;
+  }
+  /**
+   * Stores a value in the cache with a TTL.
+   *
+   * @param key   - Cache key.
+   * @param value - Value to store.
+   * @param ttl   - Optional TTL in milliseconds. Falls back to the instance default.
+   */
+  set(key, value, ttl) {
+    const expiresAt = Date.now() + (ttl ?? this.defaultTtl);
+    this.store.set(key, { value, expiresAt });
+  }
+  /**
+   * Removes a single entry from the cache.
+   *
+   * @param key - Cache key to remove.
+   * @returns `true` if the key existed, `false` otherwise.
+   */
+  delete(key) {
+    return this.store.delete(key);
+  }
+  /**
+   * Removes all entries from the cache.
+   */
+  clear() {
+    this.store.clear();
+  }
+  /**
+   * Returns the number of entries currently in the cache, including expired
+   * entries that have not yet been lazily evicted.
+   */
+  get size() {
+    return this.store.size;
+  }
+};
+
+// src/utils/rate-limiter.ts
+var RateLimiter = class {
+  maxTokens;
+  /** Milliseconds between individual token refills. */
+  refillIntervalMs;
+  tokens;
+  lastRefillTime;
+  /**
+   * @param maxPerMinute - Maximum number of requests allowed per minute.
+   */
+  constructor(maxPerMinute) {
+    this.maxTokens = maxPerMinute;
+    this.refillIntervalMs = 6e4 / maxPerMinute;
+    this.tokens = maxPerMinute;
+    this.lastRefillTime = Date.now();
+  }
+  /**
+   * Refills tokens based on elapsed time since the last refill.
+   */
+  refill() {
+    const now = Date.now();
+    const elapsed = now - this.lastRefillTime;
+    const tokensToAdd = Math.floor(elapsed / this.refillIntervalMs);
+    if (tokensToAdd > 0) {
+      this.tokens = Math.min(this.maxTokens, this.tokens + tokensToAdd);
+      this.lastRefillTime += tokensToAdd * this.refillIntervalMs;
+    }
+  }
+  /**
+   * Acquires a single token, waiting asynchronously if none are available.
+   *
+   * When the bucket is empty the method calculates exactly how long until the
+   * next token is available and waits that duration before retrying, avoiding
+   * busy-polling.
+   *
+   * @returns A promise that resolves when a token has been consumed.
+   */
+  async acquire() {
+    this.refill();
+    if (this.tokens > 0) {
+      this.tokens -= 1;
+      return;
+    }
+    const waitMs = this.refillIntervalMs - (Date.now() - this.lastRefillTime);
+    await new Promise((resolve) => setTimeout(resolve, Math.max(0, waitMs)));
+    return this.acquire();
+  }
+};
+
+// src/utils/helpers.ts
+function formatArrayParam(value) {
+  if (Array.isArray(value)) {
+    return value.join(",");
+  }
+  return String(value);
+}
+function buildUrl(base, path, params) {
+  const normalised = base.replace(/\/+$/, "") + "/" + path.replace(/^\/+/, "");
+  const url = new URL(normalised);
+  if (params) {
+    for (const [key, value] of Object.entries(params)) {
+      if (value === void 0 || value === null) continue;
+      url.searchParams.set(key, formatArrayParam(value));
+    }
+  }
+  return url.toString();
+}
+
+// src/errors.ts
+var CoinGeckoError = class extends Error {
+  /**
+   * The HTTP status code returned by the API, or `0` for network-level
+   * failures (e.g. timeout, DNS error).
+   */
+  status;
+  /**
+   * The full URL that was requested when the error occurred.
+   */
+  url;
+  /**
+   * The response body parsed as JSON if possible, otherwise the raw text.
+   * `undefined` when the error is network-level and no response was received.
+   */
+  data;
+  /**
+   * @param message - Human-readable error description.
+   * @param status  - HTTP status code (use `0` for network errors).
+   * @param url     - URL that triggered the error.
+   * @param data    - Parsed response body, if available.
+   */
+  constructor(message, status, url, data) {
+    super(message);
+    this.name = "CoinGeckoError";
+    this.status = status;
+    this.url = url;
+    this.data = data;
+    Object.setPrototypeOf(this, new.target.prototype);
+  }
+};
+
+// src/client.ts
+var PRO_BASE_URL = "https://pro-api.coingecko.com/api/v3";
+var FREE_BASE_URL = "https://api.coingecko.com/api/v3";
+var DEFAULT_CACHE_TTL = 3e4;
+var DEFAULT_MAX_RETRIES = 3;
+var DEFAULT_RETRY_DELAY = 1e3;
+var DEFAULT_TIMEOUT = 15e3;
+var DEFAULT_RATE_LIMIT_PRO = 500;
+var DEFAULT_RATE_LIMIT_FREE = 30;
+var RETRYABLE_STATUSES = /* @__PURE__ */ new Set([429, 503]);
+var CoinGeckoClient = class {
+  baseUrl;
+  apiKey;
+  cacheTtl;
+  maxRetries;
+  retryDelay;
+  timeout;
+  onRequest;
+  onResponse;
+  onError;
+  cache;
+  rateLimiter;
+  /**
+   * @param config - Optional configuration. See {@link CoinGeckoClientConfig}.
+   */
+  constructor(config) {
+    this.apiKey = config?.apiKey;
+    this.baseUrl = config?.baseUrl ?? (this.apiKey ? PRO_BASE_URL : FREE_BASE_URL);
+    this.cacheTtl = config?.cacheTtl ?? DEFAULT_CACHE_TTL;
+    this.maxRetries = config?.maxRetries ?? DEFAULT_MAX_RETRIES;
+    this.retryDelay = config?.retryDelay ?? DEFAULT_RETRY_DELAY;
+    this.timeout = config?.timeout ?? DEFAULT_TIMEOUT;
+    this.onRequest = config?.onRequest;
+    this.onResponse = config?.onResponse;
+    this.onError = config?.onError;
+    const rateLimit = config?.rateLimit ?? (this.apiKey ? DEFAULT_RATE_LIMIT_PRO : DEFAULT_RATE_LIMIT_FREE);
+    this.cache = new TTLCache(this.cacheTtl);
+    this.rateLimiter = new RateLimiter(rateLimit);
+  }
+  // -------------------------------------------------------------------------
+  // Public API
+  // -------------------------------------------------------------------------
+  /**
+   * Performs a GET request to the given API path.
+   *
+   * Results are cached by default. Pass `options.cacheTtl = 0` to bypass
+   * caching for a specific call.
+   *
+   * @template T      - Expected shape of the response body.
+   * @param path      - API endpoint path, e.g. `/coins/markets`.
+   * @param params    - Query parameters. `undefined`/`null` values are omitted.
+   * @param options   - Per-call overrides.
+   * @returns Parsed JSON response body cast to `T`.
+   * @throws {@link CoinGeckoError} on non-2xx responses or network failures.
+   */
+  async get(path, params, options) {
+    const url = buildUrl(this.baseUrl, path, params);
+    const ttl = options?.cacheTtl ?? this.cacheTtl;
+    if (ttl > 0) {
+      const cached = this.cache.get(url);
+      if (cached !== void 0) {
+        return cached;
+      }
+    }
+    await this.rateLimiter.acquire();
+    this.onRequest?.(url);
+    let lastError;
+    for (let attempt = 0; attempt <= this.maxRetries; attempt++) {
+      if (attempt > 0) {
+        const backoff = this.retryDelay * Math.pow(2, attempt - 1);
+        await new Promise((resolve) => setTimeout(resolve, backoff));
+        await this.rateLimiter.acquire();
+      }
+      const startMs = Date.now();
+      try {
+        const result = await this.fetchWithTimeout(url, startMs, ttl);
+        return result;
+      } catch (err) {
+        const error = err instanceof Error ? err : new Error(String(err));
+        lastError = error;
+        if (err instanceof CoinGeckoError && !RETRYABLE_STATUSES.has(err.status) && err.status !== 0) {
+          this.onError?.(url, error);
+          throw err;
+        }
+        if (attempt === this.maxRetries) {
+          break;
+        }
+      }
+    }
+    const finalError = lastError ?? new CoinGeckoError("Unknown error", 0, url);
+    this.onError?.(url, finalError);
+    throw finalError;
+  }
+  // -------------------------------------------------------------------------
+  // Private helpers
+  // -------------------------------------------------------------------------
+  /**
+   * Performs a single fetch with an AbortController timeout, then handles
+   * caching and lifecycle hooks.
+   */
+  async fetchWithTimeout(url, startMs, ttl) {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), this.timeout);
+    let response;
+    try {
+      const headers = {
+        "Accept": "application/json"
+      };
+      if (this.apiKey) {
+        headers["x-cg-pro-api-key"] = this.apiKey;
+      }
+      response = await fetch(url, {
+        method: "GET",
+        headers,
+        signal: controller.signal
+      });
+    } catch (err) {
+      clearTimeout(timer);
+      const elapsed2 = Date.now() - startMs;
+      if (err instanceof Error && err.name === "AbortError") {
+        const timeoutError = new CoinGeckoError(
+          `Request timed out after ${this.timeout}ms`,
+          0,
+          url
+        );
+        this.onError?.(url, timeoutError);
+        throw timeoutError;
+      }
+      const networkError = new CoinGeckoError(
+        err instanceof Error ? err.message : String(err),
+        0,
+        url
+      );
+      this.onResponse?.(url, 0, elapsed2);
+      throw networkError;
+    }
+    clearTimeout(timer);
+    const elapsed = Date.now() - startMs;
+    this.onResponse?.(url, response.status, elapsed);
+    if (!response.ok) {
+      let data;
+      let message = `HTTP ${response.status}`;
+      try {
+        data = await response.json();
+        if (data !== null && typeof data === "object" && "error" in data && typeof data["error"] === "string") {
+          message = data["error"];
+        }
+      } catch {
+        try {
+          data = await response.text();
+        } catch {
+        }
+      }
+      throw new CoinGeckoError(message, response.status, url, data);
+    }
+    const json = await response.json();
+    if (ttl > 0) {
+      this.cache.set(url, json, ttl);
+    }
+    return json;
+  }
+};
+
+// src/endpoints/coins.ts
+var CoinsEndpoints = class {
+  constructor(client) {
+    this.client = client;
+  }
+  // -------------------------------------------------------------------------
+  // Simple price
+  // -------------------------------------------------------------------------
+  /**
+   * @description Get the current price of one or more coins in the requested
+   * vs-currencies. Optionally include market cap, 24h volume, 24h change, and
+   * last-updated timestamp in the response.
+   *
+   * @param params - Query parameters including required `ids` and
+   *   `vs_currencies` plus optional data flags.
+   * @returns A map of coin ID → currency code → numeric value.
+   *
+   * @example
+   * ```ts
+   * const prices = await coins.price({
+   *   ids: 'bitcoin,ethereum',
+   *   vs_currencies: 'usd,eur',
+   *   include_market_cap: true,
+   * });
+   * // { bitcoin: { usd: 69840, usd_market_cap: 1.38e12 }, ethereum: { usd: 3700 } }
+   * ```
+   */
+  async price(params) {
+    return this.client.get("/simple/price", params);
+  }
+  /**
+   * @description Get the current price of one or more ERC-20/token contract
+   * addresses on a given asset platform (e.g. `ethereum`).
+   *
+   * @param platformId - Asset platform ID (e.g. `'ethereum'`, `'polygon-pos'`).
+   * @param params - Query parameters including required `contract_addresses` and
+   *   `vs_currencies`.
+   * @returns A map of contract address → currency code → numeric value.
+   *
+   * @remarks Requires Analyst+ plan for more than one address per request.
+   *
+   * @example
+   * ```ts
+   * const tokenPrices = await coins.tokenPrice('ethereum', {
+   *   contract_addresses: '0xdac17f958d2ee523a2206206994597c13d831ec7',
+   *   vs_currencies: 'usd',
+   * });
+   * ```
+   */
+  async tokenPrice(platformId, params) {
+    return this.client.get(
+      `/simple/token_price/${platformId}`,
+      params
+    );
+  }
+  /**
+   * @description Get the full list of vs-currency codes supported by CoinGecko
+   * (e.g. `'usd'`, `'eur'`, `'btc'`).
+   *
+   * @returns An array of currency code strings.
+   *
+   * @example
+   * ```ts
+   * const currencies = await coins.supportedVsCurrencies();
+   * // ['btc', 'eth', 'usd', 'eur', ...]
+   * ```
+   */
+  async supportedVsCurrencies() {
+    return this.client.get("/simple/supported_vs_currencies");
+  }
+  // -------------------------------------------------------------------------
+  // Coin list & markets
+  // -------------------------------------------------------------------------
+  /**
+   * @description Get the full list of coins available on CoinGecko, including
+   * their IDs, symbols, and names.  Optionally include contract addresses per
+   * platform.
+   *
+   * @param params - Optional query parameters.
+   * @returns An array of minimal coin entries.
+   *
+   * @example
+   * ```ts
+   * const coins = await coins.list({ include_platform: true });
+   * // [{ id: 'bitcoin', symbol: 'btc', name: 'Bitcoin', platforms: {} }, ...]
+   * ```
+   */
+  async list(params) {
+    return this.client.get("/coins/list", params);
+  }
+  /**
+   * @description Get coin market data (price, market cap, volume, etc.) for
+   * all or a filtered set of coins ordered by market cap.
+   *
+   * @param params - Query parameters including required `vs_currency`.
+   * @returns An array of `MarketCoin` objects with full market statistics.
+   *
+   * @example
+   * ```ts
+   * const top10 = await coins.markets({ vs_currency: 'usd', per_page: 10 });
+   * ```
+   */
+  async markets(params) {
+    return this.client.get("/coins/markets", params);
+  }
+  /**
+   * @description Get the top 30 gaining and top 30 losing coins over a given
+   * time duration, filtered by the requested vs-currency.
+   *
+   * @param params - Optional query parameters including `vs_currency`,
+   *   `duration`, and `top_coins` filter.
+   * @returns An object with `top_gainers` and `top_losers` arrays.
+   *
+   * @remarks Requires Analyst+ plan.
+   *
+   * @example
+   * ```ts
+   * const movers = await coins.topGainersLosers({ vs_currency: 'usd', duration: '24h' });
+   * console.log(movers.top_gainers[0]);
+   * ```
+   */
+  async topGainersLosers(params) {
+    return this.client.get(
+      "/coins/top_gainers_losers",
+      params
+    );
+  }
+  /**
+   * @description Get a list of the 200 most recently listed coins on CoinGecko,
+   * ordered by listing date descending.
+   *
+   * @returns An array of `NewCoin` entries with activation timestamps.
+   *
+   * @remarks Requires Analyst+ plan.
+   *
+   * @example
+   * ```ts
+   * const newCoins = await coins.listNew();
+   * console.log(newCoins[0].activated_at);
+   * ```
+   */
+  async listNew() {
+    return this.client.get("/coins/list/new");
+  }
+  // -------------------------------------------------------------------------
+  // Coin by ID
+  // -------------------------------------------------------------------------
+  /**
+   * @description Get comprehensive data for a specific coin by its CoinGecko
+   * ID, including market data, links, community stats, developer activity, and
+   * more.
+   *
+   * @param id - CoinGecko coin ID (e.g. `'bitcoin'`).
+   * @param params - Optional flags controlling which data blocks to include.
+   * @returns A `CoinDetail` object with all available metadata.
+   *
+   * @example
+   * ```ts
+   * const bitcoin = await coins.getById('bitcoin', { market_data: true, tickers: false });
+   * console.log(bitcoin.market_data?.current_price?.usd);
+   * ```
+   */
+  async getById(id, params) {
+    return this.client.get(`/coins/${id}`, params);
+  }
+  /**
+   * @description Get the exchange tickers for a specific coin, optionally
+   * filtered by exchange.
+   *
+   * @param id - CoinGecko coin ID (e.g. `'bitcoin'`).
+   * @param params - Optional pagination, exchange filter, and sort params.
+   * @returns A `CoinTickersResponse` wrapping the coin name and ticker array.
+   *
+   * @example
+   * ```ts
+   * const { tickers } = await coins.tickers('bitcoin', { exchange_ids: 'binance' });
+   * ```
+   */
+  async tickers(id, params) {
+    return this.client.get(
+      `/coins/${id}/tickers`,
+      params
+    );
+  }
+  /**
+   * @description Get historical snapshot data for a coin on a specific past
+   * date, including price, market cap, and volume.
+   *
+   * @param id - CoinGecko coin ID (e.g. `'bitcoin'`).
+   * @param params - Query parameters including required `date` (`dd-mm-yyyy`).
+   * @returns A `CoinHistoricalData` snapshot object.
+   *
+   * @example
+   * ```ts
+   * const snapshot = await coins.history('bitcoin', { date: '30-12-2022' });
+   * console.log(snapshot.market_data?.current_price?.usd);
+   * ```
+   */
+  async history(id, params) {
+    return this.client.get(`/coins/${id}/history`, params);
+  }
+  /**
+   * @description Get historical market chart data (price, market cap, and
+   * volume) for a coin over a given number of days.  Data granularity is
+   * automatically selected unless `interval` is specified.
+   *
+   * @param id - CoinGecko coin ID (e.g. `'ethereum'`).
+   * @param params - Query parameters including required `vs_currency` and
+   *   `days`.
+   * @returns A `MarketChartResponse` containing price, market cap, and volume
+   *   time series.
+   *
+   * @example
+   * ```ts
+   * const chart = await coins.marketChart('ethereum', { vs_currency: 'usd', days: 30 });
+   * const [ts, price] = chart.prices[0];
+   * ```
+   */
+  async marketChart(id, params) {
+    return this.client.get(
+      `/coins/${id}/market_chart`,
+      params
+    );
+  }
+  /**
+   * @description Get historical market chart data (price, market cap, and
+   * volume) for a coin within a UNIX timestamp range.
+   *
+   * @param id - CoinGecko coin ID.
+   * @param params - Query parameters including `vs_currency`, `from`, and `to`
+   *   UNIX timestamps (seconds).
+   * @returns A `MarketChartResponse` containing price, market cap, and volume
+   *   time series.
+   *
+   * @example
+   * ```ts
+   * const chart = await coins.marketChartRange('bitcoin', {
+   *   vs_currency: 'usd',
+   *   from: 1640995200,
+   *   to: 1672531200,
+   * });
+   * ```
+   */
+  async marketChartRange(id, params) {
+    return this.client.get(
+      `/coins/${id}/market_chart/range`,
+      params
+    );
+  }
+  /**
+   * @description Get OHLC (open, high, low, close) candlestick data for a coin
+   * over a given number of days.
+   *
+   * @param id - CoinGecko coin ID.
+   * @param params - Query parameters including required `vs_currency` and
+   *   `days`.
+   * @returns An array of OHLC data points, each formatted as
+   *   `[timestamp_ms, open, high, low, close]`.
+   *
+   * @remarks Requires Analyst+ plan.
+   *
+   * @example
+   * ```ts
+   * const candles = await coins.ohlc('bitcoin', { vs_currency: 'usd', days: 7 });
+   * const [ts, open, high, low, close] = candles[0];
+   * ```
+   */
+  async ohlc(id, params) {
+    return this.client.get(`/coins/${id}/ohlc`, params);
+  }
+  /**
+   * @description Get OHLC (open, high, low, close) candlestick data for a coin
+   * within a UNIX timestamp range.
+   *
+   * @param id - CoinGecko coin ID.
+   * @param params - Query parameters including required `vs_currency`, `from`,
+   *   and `to` UNIX timestamps (seconds).
+   * @returns An array of OHLC data points, each formatted as
+   *   `[timestamp_ms, open, high, low, close]`.
+   *
+   * @remarks Requires Analyst+ plan.
+   *
+   * @example
+   * ```ts
+   * const candles = await coins.ohlcRange('bitcoin', {
+   *   vs_currency: 'usd',
+   *   from: 1640995200,
+   *   to: 1672531200,
+   * });
+   * ```
+   */
+  async ohlcRange(id, params) {
+    return this.client.get(
+      `/coins/${id}/ohlc/range`,
+      params
+    );
+  }
+  // -------------------------------------------------------------------------
+  // Supply charts (Enterprise)
+  // -------------------------------------------------------------------------
+  /**
+   * @description Get the historical circulating supply chart for a coin over a
+   * given number of days.
+   *
+   * @param id - CoinGecko coin ID.
+   * @param params - Query parameters including required `days`.
+   * @returns An array of `[timestamp_ms, supply_value]` data points.
+   *
+   * @remarks Requires Enterprise plan.
+   *
+   * @example
+   * ```ts
+   * const supply = await coins.circulatingSupplyChart('bitcoin', { days: 365 });
+   * const [ts, value] = supply[0];
+   * ```
+   */
+  async circulatingSupplyChart(id, params) {
+    return this.client.get(
+      `/coins/${id}/circulating_supply_chart`,
+      params
+    );
+  }
+  /**
+   * @description Get the historical circulating supply chart for a coin within
+   * a UNIX timestamp range.
+   *
+   * @param id - CoinGecko coin ID.
+   * @param params - Query parameters including required `from` and `to` UNIX
+   *   timestamps (seconds).
+   * @returns An array of `[timestamp_ms, supply_value]` data points.
+   *
+   * @remarks Requires Enterprise plan.
+   *
+   * @example
+   * ```ts
+   * const supply = await coins.circulatingSupplyChartRange('bitcoin', {
+   *   from: 1640995200,
+   *   to: 1672531200,
+   * });
+   * ```
+   */
+  async circulatingSupplyChartRange(id, params) {
+    return this.client.get(
+      `/coins/${id}/circulating_supply_chart/range`,
+      params
+    );
+  }
+  /**
+   * @description Get the historical total supply chart for a coin over a given
+   * number of days.
+   *
+   * @param id - CoinGecko coin ID.
+   * @param params - Query parameters including required `days`.
+   * @returns An array of `[timestamp_ms, supply_value]` data points.
+   *
+   * @remarks Requires Enterprise plan.
+   *
+   * @example
+   * ```ts
+   * const supply = await coins.totalSupplyChart('ethereum', { days: 90 });
+   * ```
+   */
+  async totalSupplyChart(id, params) {
+    return this.client.get(
+      `/coins/${id}/total_supply_chart`,
+      params
+    );
+  }
+  /**
+   * @description Get the historical total supply chart for a coin within a
+   * UNIX timestamp range.
+   *
+   * @param id - CoinGecko coin ID.
+   * @param params - Query parameters including required `from` and `to` UNIX
+   *   timestamps (seconds).
+   * @returns An array of `[timestamp_ms, supply_value]` data points.
+   *
+   * @remarks Requires Enterprise plan.
+   *
+   * @example
+   * ```ts
+   * const supply = await coins.totalSupplyChartRange('ethereum', {
+   *   from: 1640995200,
+   *   to: 1672531200,
+   * });
+   * ```
+   */
+  async totalSupplyChartRange(id, params) {
+    return this.client.get(
+      `/coins/${id}/total_supply_chart/range`,
+      params
+    );
+  }
+  // -------------------------------------------------------------------------
+  // Contract address
+  // -------------------------------------------------------------------------
+  /**
+   * @description Get full coin data for a token by its smart contract address
+   * on a given asset platform.
+   *
+   * @param platformId - Asset platform ID (e.g. `'ethereum'`, `'binance-smart-chain'`).
+   * @param contractAddress - Token contract address (e.g. `'0xdac17f…'`).
+   * @returns A `CoinDetail` object equivalent to `/coins/{id}`.
+   *
+   * @example
+   * ```ts
+   * const usdt = await coins.getByContract(
+   *   'ethereum',
+   *   '0xdac17f958d2ee523a2206206994597c13d831ec7',
+   * );
+   * console.log(usdt.name); // 'Tether'
+   * ```
+   */
+  async getByContract(platformId, contractAddress) {
+    return this.client.get(`/coins/${platformId}/contract/${contractAddress}`);
+  }
+  /**
+   * @description Get historical market chart data (price, market cap, volume)
+   * for a token identified by its contract address on a given asset platform.
+   *
+   * @param platformId - Asset platform ID (e.g. `'ethereum'`).
+   * @param contractAddress - Token contract address.
+   * @param params - Query parameters including required `vs_currency` and
+   *   `days`.
+   * @returns A `MarketChartResponse` with price, market cap, and volume time
+   *   series.
+   *
+   * @example
+   * ```ts
+   * const chart = await coins.contractMarketChart(
+   *   'ethereum',
+   *   '0xdac17f958d2ee523a2206206994597c13d831ec7',
+   *   { vs_currency: 'usd', days: 30 },
+   * );
+   * ```
+   */
+  async contractMarketChart(platformId, contractAddress, params) {
+    return this.client.get(
+      `/coins/${platformId}/contract/${contractAddress}/market_chart`,
+      params
+    );
+  }
+  /**
+   * @description Get historical market chart data for a token identified by
+   * its contract address, within a UNIX timestamp range.
+   *
+   * @param platformId - Asset platform ID (e.g. `'ethereum'`).
+   * @param contractAddress - Token contract address.
+   * @param params - Query parameters including required `vs_currency`, `from`,
+   *   and `to` UNIX timestamps (seconds).
+   * @returns A `MarketChartResponse` with price, market cap, and volume time
+   *   series.
+   *
+   * @example
+   * ```ts
+   * const chart = await coins.contractMarketChartRange(
+   *   'ethereum',
+   *   '0xdac17f958d2ee523a2206206994597c13d831ec7',
+   *   { vs_currency: 'usd', from: 1640995200, to: 1672531200 },
+   * );
+   * ```
+   */
+  async contractMarketChartRange(platformId, contractAddress, params) {
+    return this.client.get(
+      `/coins/${platformId}/contract/${contractAddress}/market_chart/range`,
+      params
+    );
+  }
+  // -------------------------------------------------------------------------
+  // Categories
+  // -------------------------------------------------------------------------
+  /**
+   * @description Get a flat list of all coin categories available on
+   * CoinGecko, returning only the category ID and name.
+   *
+   * @returns An array of `CategoryListEntry` items with `category_id` and
+   *   `name`.
+   *
+   * @example
+   * ```ts
+   * const list = await coins.categoriesList();
+   * // [{ category_id: 'decentralized-finance-defi', name: 'DeFi' }, ...]
+   * ```
+   */
+  async categoriesList() {
+    return this.client.get("/coins/categories/list");
+  }
+  /**
+   * @description Get all coin categories with market data (market cap, 24h
+   * change, volume, top coins), optionally sorted.
+   *
+   * @param params - Optional query parameters for sort order.
+   * @returns An array of `Category` objects with market statistics.
+   *
+   * @example
+   * ```ts
+   * const categories = await coins.categories({ order: 'market_cap_desc' });
+   * console.log(categories[0].name, categories[0].market_cap);
+   * ```
+   */
+  async categories(params) {
+    return this.client.get(
+      "/coins/categories",
+      params
+    );
+  }
+};
+
+// src/endpoints/exchanges.ts
+var ExchangesEndpoints = class {
+  constructor(client) {
+    this.client = client;
+  }
+  // ---------------------------------------------------------------------------
+  // /exchanges
+  // ---------------------------------------------------------------------------
+  /**
+   * Returns a paginated list of all active exchanges with market data.
+   *
+   * @param params - Optional pagination parameters (`per_page`, `page`).
+   * @returns Array of {@link Exchange} objects ordered by trust score rank.
+   *
+   * @example
+   * ```ts
+   * const page1 = await exchanges.list({ per_page: 50, page: 1 });
+   * ```
+   */
+  async list(params) {
+    return this.client.get("/exchanges", params);
+  }
+  // ---------------------------------------------------------------------------
+  // /exchanges/list
+  // ---------------------------------------------------------------------------
+  /**
+   * Returns a lightweight list of all exchange IDs and names.
+   *
+   * Use this endpoint to resolve exchange API IDs for subsequent calls
+   * rather than fetching full exchange data.
+   *
+   * @returns Array of {@link ExchangeListEntry} objects (`id` + `name` only).
+   *
+   * @example
+   * ```ts
+   * const ids = await exchanges.listAll();
+   * // [{ id: 'binance', name: 'Binance' }, ...]
+   * ```
+   */
+  async listAll() {
+    return this.client.get("/exchanges/list");
+  }
+  // ---------------------------------------------------------------------------
+  // /exchanges/{id}
+  // ---------------------------------------------------------------------------
+  /**
+   * Returns full details for a single exchange by its API ID.
+   *
+   * @param id - Exchange API ID (e.g. `"binance"`). Use {@link listAll} to
+   *   discover valid IDs.
+   * @returns {@link ExchangeDetail} including social links, trust score, and
+   *   top 100 tickers.
+   *
+   * @example
+   * ```ts
+   * const binance = await exchanges.getById('binance');
+   * console.log(binance.trust_score); // 10
+   * ```
+   */
+  async getById(id) {
+    return this.client.get(`/exchanges/${encodeURIComponent(id)}`);
+  }
+  // ---------------------------------------------------------------------------
+  // /exchanges/{id}/tickers
+  // ---------------------------------------------------------------------------
+  /**
+   * Returns paginated tickers for a specific exchange.
+   *
+   * @param id     - Exchange API ID (e.g. `"binance"`).
+   * @param params - Optional filter/sort/pagination parameters.
+   * @returns {@link ExchangeTickersResponse} containing the exchange name and
+   *   an array of tickers.
+   *
+   * @example
+   * ```ts
+   * const result = await exchanges.tickers('binance', {
+   *   coin_ids: 'bitcoin,ethereum',
+   *   order: 'trust_score_desc',
+   * });
+   * console.log(result.tickers.length);
+   * ```
+   */
+  async tickers(id, params) {
+    return this.client.get(
+      `/exchanges/${encodeURIComponent(id)}/tickers`,
+      params
+    );
+  }
+  // ---------------------------------------------------------------------------
+  // /exchanges/{id}/volume_chart
+  // ---------------------------------------------------------------------------
+  /**
+   * Returns BTC-denominated volume chart data for a specific exchange.
+   *
+   * @param id     - Exchange API ID (e.g. `"binance"`).
+   * @param params - Required query parameters, including `days`.
+   * @returns {@link VolumeChartResponse} — array of `[timestamp_ms, volume_btc]`
+   *   tuples. Volume is returned as a string to preserve precision.
+   *
+   * @example
+   * ```ts
+   * const chart = await exchanges.volumeChart('binance', { days: '30' });
+   * // [[1711792200000, '306800.051794'], ...]
+   * ```
+   */
+  async volumeChart(id, params) {
+    return this.client.get(
+      `/exchanges/${encodeURIComponent(id)}/volume_chart`,
+      params
+    );
+  }
+  // ---------------------------------------------------------------------------
+  // /exchanges/{id}/volume_chart/range (Analyst+)
+  // ---------------------------------------------------------------------------
+  /**
+   * Returns BTC-denominated volume chart data for an exchange over a custom
+   * Unix timestamp range.
+   *
+   * @param id     - Exchange API ID (e.g. `"binance"`).
+   * @param params - Required `from` and `to` Unix timestamps (seconds).
+   * @returns {@link VolumeChartResponse} — array of `[timestamp_ms, volume_btc]`
+   *   tuples.
+   *
+   * @remarks Requires **Analyst+** plan.
+   *
+   * @example
+   * ```ts
+   * const chart = await exchanges.volumeChartRange('binance', {
+   *   from: 1711670400,
+   *   to:   1712275200,
+   * });
+   * ```
+   */
+  async volumeChartRange(id, params) {
+    return this.client.get(
+      `/exchanges/${encodeURIComponent(id)}/volume_chart/range`,
+      params
+    );
+  }
+};
+
+// src/endpoints/derivatives.ts
+var DerivativesEndpoints = class {
+  constructor(client) {
+    this.client = client;
+  }
+  // ---------------------------------------------------------------------------
+  // /derivatives
+  // ---------------------------------------------------------------------------
+  /**
+   * Returns a list of all derivative tickers across all derivatives exchanges.
+   *
+   * @param params - Optional filter parameters.
+   * @param params.include_tickers - Whether to include tickers.
+   *   `"all"` returns all tickers; `"unexpired"` excludes expired contracts.
+   * @returns Array of {@link DerivativeTicker} objects.
+   *
+   * @example
+   * ```ts
+   * const allTickers = await deriv.tickers({ include_tickers: 'unexpired' });
+   * ```
+   */
+  async tickers(params) {
+    return this.client.get("/derivatives", params);
+  }
+  // ---------------------------------------------------------------------------
+  // /derivatives/exchanges
+  // ---------------------------------------------------------------------------
+  /**
+   * Returns a paginated list of all derivatives exchanges.
+   *
+   * @param params - Optional sort and pagination parameters.
+   * @returns Array of {@link DerivativeExchange} objects.
+   *
+   * @example
+   * ```ts
+   * const top = await deriv.exchanges({
+   *   order: 'open_interest_btc_desc',
+   *   per_page: 10,
+   * });
+   * ```
+   */
+  async exchanges(params) {
+    return this.client.get(
+      "/derivatives/exchanges",
+      params
+    );
+  }
+  // ---------------------------------------------------------------------------
+  // /derivatives/exchanges/{id}
+  // ---------------------------------------------------------------------------
+  /**
+   * Returns detailed data for a single derivatives exchange by its API ID.
+   *
+   * @param id     - Derivatives exchange API ID (e.g. `"binance_futures"`).
+   * @param params - Optional parameters to include ticker data.
+   * @returns {@link DerivativeExchangeDetail} with optional tickers array.
+   *
+   * @example
+   * ```ts
+   * const detail = await deriv.exchangeById('binance_futures', {
+   *   include_tickers: 'unexpired',
+   * });
+   * console.log(detail.open_interest_btc);
+   * ```
+   */
+  async exchangeById(id, params) {
+    return this.client.get(
+      `/derivatives/exchanges/${encodeURIComponent(id)}`,
+      params
+    );
+  }
+  // ---------------------------------------------------------------------------
+  // /derivatives/exchanges/list
+  // ---------------------------------------------------------------------------
+  /**
+   * Returns a lightweight list of all derivatives exchange IDs and names.
+   *
+   * Use this to resolve exchange API IDs for subsequent calls.
+   *
+   * @returns Array of {@link ExchangeListEntry} objects (`id` + `name` only).
+   *
+   * @example
+   * ```ts
+   * const ids = await deriv.exchangesList();
+   * // [{ id: 'binance_futures', name: 'Binance (Futures)' }, ...]
+   * ```
+   */
+  async exchangesList() {
+    return this.client.get("/derivatives/exchanges/list");
+  }
+};
+
+// src/endpoints/nfts.ts
+var NftsEndpoints = class {
+  constructor(client) {
+    this.client = client;
+  }
+  // ---------------------------------------------------------------------------
+  // /nfts/list
+  // ---------------------------------------------------------------------------
+  /**
+   * Returns a paginated list of all NFT collections supported by CoinGecko.
+   *
+   * @param params - Optional pagination parameters (`per_page`, `page`).
+   * @returns Array of {@link NftListEntry} objects with minimal metadata.
+   *
+   * @example
+   * ```ts
+   * const collections = await nfts.list({ per_page: 100, page: 1 });
+   * ```
+   */
+  async list(params) {
+    return this.client.get("/nfts/list", params);
+  }
+  // ---------------------------------------------------------------------------
+  // /nfts/{id}
+  // ---------------------------------------------------------------------------
+  /**
+   * Returns full data for a single NFT collection by its CoinGecko API ID.
+   *
+   * @param id - NFT collection API ID (e.g. `"pudgy-penguins"`). Use
+   *   {@link list} to discover valid IDs.
+   * @returns {@link NftCollection} with floor price, market cap, volume, and
+   *   other collection metadata.
+   *
+   * @example
+   * ```ts
+   * const penguins = await nfts.getById('pudgy-penguins');
+   * console.log(penguins.floor_price?.usd);
+   * ```
+   */
+  async getById(id) {
+    return this.client.get(`/nfts/${encodeURIComponent(id)}`);
+  }
+  // ---------------------------------------------------------------------------
+  // /nfts/{platformId}/contract/{address}
+  // ---------------------------------------------------------------------------
+  /**
+   * Returns full data for a single NFT collection identified by its contract
+   * address on a specific asset platform.
+   *
+   * @param platformId - Asset platform ID (e.g. `"ethereum"`).
+   * @param address    - Token contract address (e.g. `"0xBd3531..."`).
+   * @returns {@link NftCollection} with the same fields as {@link getById}.
+   *
+   * @example
+   * ```ts
+   * const collection = await nfts.getByContract(
+   *   'ethereum',
+   *   '0xBd3531dA5CF5857e7CfAA92426877b022e612cf8',
+   * );
+   * ```
+   */
+  async getByContract(platformId, address) {
+    return this.client.get(
+      `/nfts/${encodeURIComponent(platformId)}/contract/${encodeURIComponent(address)}`
+    );
+  }
+  // ---------------------------------------------------------------------------
+  // /nfts/markets (Analyst+)
+  // ---------------------------------------------------------------------------
+  /**
+   * Returns a paginated list of NFT collections with market data.
+   *
+   * @param params - Optional filter and sort parameters.
+   * @returns Array of {@link NftCollection} objects with market data.
+   *
+   * @remarks Requires **Analyst+** plan.
+   *
+   * @example
+   * ```ts
+   * const markets = await nfts.markets({
+   *   asset_platform_id: 'ethereum',
+   *   order: 'market_cap_usd_desc',
+   *   per_page: 50,
+   * });
+   * ```
+   */
+  async markets(params) {
+    return this.client.get("/nfts/markets", params);
+  }
+  // ---------------------------------------------------------------------------
+  // /nfts/{id}/market_chart (Analyst+)
+  // ---------------------------------------------------------------------------
+  /**
+   * Returns historical market chart data for a single NFT collection.
+   *
+   * @param id     - NFT collection API ID (e.g. `"pudgy-penguins"`).
+   * @param params - Optional query parameters, including `days`.
+   * @returns {@link NftMarketChart} with floor price, market cap, and volume
+   *   time series.
+   *
+   * @remarks Requires **Analyst+** plan.
+   *
+   * @example
+   * ```ts
+   * const chart = await nfts.marketChart('pudgy-penguins', { days: 30 });
+   * console.log(chart.floor_price_usd);
+   * ```
+   */
+  async marketChart(id, params) {
+    return this.client.get(
+      `/nfts/${encodeURIComponent(id)}/market_chart`,
+      params
+    );
+  }
+  // ---------------------------------------------------------------------------
+  // /nfts/{platformId}/contract/{address}/market_chart (Analyst+)
+  // ---------------------------------------------------------------------------
+  /**
+   * Returns historical market chart data for an NFT collection identified by
+   * its contract address on a specific asset platform.
+   *
+   * @param platformId - Asset platform ID (e.g. `"ethereum"`).
+   * @param address    - Token contract address.
+   * @param params     - Optional query parameters, including `days`.
+   * @returns {@link NftMarketChart} with floor price, market cap, and volume
+   *   time series.
+   *
+   * @remarks Requires **Analyst+** plan.
+   *
+   * @example
+   * ```ts
+   * const chart = await nfts.contractMarketChart(
+   *   'ethereum',
+   *   '0xBd3531dA5CF5857e7CfAA92426877b022e612cf8',
+   *   { days: 14 },
+   * );
+   * ```
+   */
+  async contractMarketChart(platformId, address, params) {
+    return this.client.get(
+      `/nfts/${encodeURIComponent(platformId)}/contract/${encodeURIComponent(address)}/market_chart`,
+      params
+    );
+  }
+  // ---------------------------------------------------------------------------
+  // /nfts/{id}/tickers (Analyst+)
+  // ---------------------------------------------------------------------------
+  /**
+   * Returns marketplace tickers (floor price, volume) for a single NFT
+   * collection across all supported NFT marketplaces.
+   *
+   * @param id - NFT collection API ID (e.g. `"pudgy-penguins"`).
+   * @returns {@link NftTickersResponse} with an array of marketplace tickers.
+   *
+   * @remarks Requires **Analyst+** plan.
+   *
+   * @example
+   * ```ts
+   * const result = await nfts.tickers('pudgy-penguins');
+   * result.tickers.forEach(t => console.log(t.name, t.floor_price_in_native_currency));
+   * ```
+   */
+  async tickers(id) {
+    return this.client.get(`/nfts/${encodeURIComponent(id)}/tickers`);
+  }
+};
+
+// src/endpoints/onchain.ts
+var OnchainEndpoints = class {
+  constructor(client) {
+    this.client = client;
+  }
+  // -------------------------------------------------------------------------
+  // Simple
+  // -------------------------------------------------------------------------
+  /**
+   * Returns the current USD (or other currency) price of one or more tokens
+   * on a given network.
+   *
+   * @param network   - Network ID (e.g. `"eth"`, `"bsc"`).
+   * @param addresses - Token contract address or array of addresses.
+   * @returns A map of address → { usd: "price" } (or whichever currencies were requested).
+   *
+   * @example
+   * ```ts
+   * const prices = await onchain.tokenPrice('eth', [
+   *   '0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48',
+   *   '0xdac17f958d2ee523a2206206994597c13d831ec7',
+   * ]);
+   * // { '0xa0b8...': { usd: '1.001' }, '0xdac1...': { usd: '0.9998' } }
+   * ```
+   */
+  tokenPrice(network, addresses) {
+    const addressParam = Array.isArray(addresses) ? addresses.join(",") : addresses;
+    return this.client.get(
+      `/onchain/simple/networks/${network}/token_price/${addressParam}`
+    );
+  }
+  // -------------------------------------------------------------------------
+  // Networks & DEXes
+  // -------------------------------------------------------------------------
+  /**
+   * Returns the list of all supported networks (blockchains) on GeckoTerminal.
+   *
+   * @param params - Optional pagination parameters.
+   * @returns Paginated list of network resources.
+   *
+   * @example
+   * ```ts
+   * const { data } = await onchain.networks();
+   * data.forEach(n => console.log(n.id, n.attributes.name));
+   * ```
+   */
+  networks(params) {
+    return this.client.get("/onchain/networks", params);
+  }
+  /**
+   * Returns the list of DEXes available on a given network.
+   *
+   * @param network - Network ID (e.g. `"eth"`).
+   * @param params  - Optional pagination parameters.
+   * @returns Paginated list of DEX resources.
+   *
+   * @example
+   * ```ts
+   * const { data } = await onchain.dexes('eth');
+   * data.forEach(d => console.log(d.id, d.attributes.name));
+   * ```
+   */
+  dexes(network, params) {
+    return this.client.get(
+      `/onchain/networks/${network}/dexes`,
+      params
+    );
+  }
+  // -------------------------------------------------------------------------
+  // Pools
+  // -------------------------------------------------------------------------
+  /**
+   * Returns detailed data for a single pool by contract address.
+   *
+   * @param network - Network ID (e.g. `"eth"`).
+   * @param address - Pool contract address.
+   * @returns Single pool resource (JSON:API envelope).
+   *
+   * @example
+   * ```ts
+   * const { data } = await onchain.pool('eth', '0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640');
+   * console.log(data.attributes.name, data.attributes.reserve_in_usd);
+   * ```
+   */
+  pool(network, address) {
+    return this.client.get(
+      `/onchain/networks/${network}/pools/${address}`
+    );
+  }
+  /**
+   * Returns data for multiple pools by contract addresses in one request.
+   *
+   * @param network   - Network ID (e.g. `"eth"`).
+   * @param addresses - Array of pool contract addresses (joined as comma-separated path segment).
+   * @returns List of pool resources (JSON:API envelope).
+   *
+   * @example
+   * ```ts
+   * const { data } = await onchain.pools('eth', [
+   *   '0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640',
+   *   '0x8ad599c3a0ff1de082011efddc58f1908eb6e6d8',
+   * ]);
+   * ```
+   */
+  pools(network, addresses) {
+    return this.client.get(
+      `/onchain/networks/${network}/pools/multi/${addresses.join(",")}`
+    );
+  }
+  /**
+   * Returns the top pools on a given network ranked by volume or liquidity.
+   *
+   * @param network - Network ID (e.g. `"eth"`).
+   * @param params  - Optional pagination parameters.
+   * @returns Paginated list of pool resources.
+   *
+   * @example
+   * ```ts
+   * const { data } = await onchain.topPools('eth', { page: 1 });
+   * ```
+   */
+  topPools(network, params) {
+    return this.client.get(
+      `/onchain/networks/${network}/pools`,
+      params
+    );
+  }
+  /**
+   * Returns the top pools for a specific DEX on a given network.
+   *
+   * @param network - Network ID (e.g. `"eth"`).
+   * @param dex     - DEX ID (e.g. `"uniswap_v3"`).
+   * @param params  - Optional pagination parameters.
+   * @returns Paginated list of pool resources.
+   *
+   * @example
+   * ```ts
+   * const { data } = await onchain.topPoolsByDex('eth', 'uniswap_v3');
+   * ```
+   */
+  topPoolsByDex(network, dex, params) {
+    return this.client.get(
+      `/onchain/networks/${network}/dexes/${dex}/pools`,
+      params
+    );
+  }
+  /**
+   * Returns trending pools, either globally or filtered to a specific network.
+   *
+   * When `network` is omitted, the global trending pools endpoint is used:
+   * `GET /onchain/networks/trending_pools`.
+   * When `network` is provided: `GET /onchain/networks/{network}/trending_pools`.
+   *
+   * @param network - Optional network ID to scope results.
+   * @param params  - Optional pagination parameters.
+   * @returns Paginated list of trending pool resources.
+   *
+   * @example
+   * ```ts
+   * // Global trending
+   * const { data } = await onchain.trendingPools();
+   *
+   * // Network-scoped trending
+   * const { data: ethTrending } = await onchain.trendingPools('eth');
+   * ```
+   */
+  trendingPools(network, params) {
+    const path = network ? `/onchain/networks/${network}/trending_pools` : "/onchain/networks/trending_pools";
+    return this.client.get(path, params);
+  }
+  /**
+   * Returns newly created pools, either globally or filtered to a specific network.
+   *
+   * When `network` is omitted, the global new pools endpoint is used:
+   * `GET /onchain/networks/new_pools`.
+   * When `network` is provided: `GET /onchain/networks/{network}/new_pools`.
+   *
+   * @param network - Optional network ID to scope results.
+   * @param params  - Optional pagination parameters.
+   * @returns Paginated list of new pool resources.
+   *
+   * @example
+   * ```ts
+   * // All new pools across all networks
+   * const { data } = await onchain.newPools();
+   *
+   * // New pools on Solana only
+   * const { data: solNew } = await onchain.newPools('solana');
+   * ```
+   */
+  newPools(network, params) {
+    const path = network ? `/onchain/networks/${network}/new_pools` : "/onchain/networks/new_pools";
+    return this.client.get(path, params);
+  }
+  /**
+   * Returns pools matching advanced filter criteria (megafilter).
+   *
+   * @remarks
+   * **Requires Analyst+ (💼) plan.** Calls are rejected with HTTP 403 on
+   * lower-tier keys.
+   *
+   * @param params - Filter, sort, and pagination parameters.
+   * @returns Paginated list of pool resources matching the criteria.
+   *
+   * @example
+   * ```ts
+   * const { data } = await onchain.megafilter({
+   *   network: 'eth',
+   *   reserve_in_usd_gte: 100_000,
+   *   sort: 'h24_volume_usd',
+   *   page: 1,
+   * });
+   * ```
+   */
+  megafilter(params) {
+    return this.client.get(
+      "/onchain/pools/megafilter",
+      params
+    );
+  }
+  /**
+   * Searches for pools matching a text query across all networks or a
+   * specific network.
+   *
+   * @param query  - Search query string (token name, symbol, or pool address).
+   * @param params - Optional network filter and pagination parameters.
+   * @returns Paginated list of matching pool resources.
+   *
+   * @example
+   * ```ts
+   * const { data } = await onchain.searchPools('PEPE');
+   * const { data: ethPepe } = await onchain.searchPools('PEPE', { network: 'eth' });
+   * ```
+   */
+  searchPools(query, params) {
+    return this.client.get(
+      "/onchain/search/pools",
+      { query, ...params }
+    );
+  }
+  /**
+   * Returns pools that are currently trending in search on GeckoTerminal.
+   *
+   * @remarks
+   * **Requires Analyst+ (💼) plan.** Calls are rejected with HTTP 403 on
+   * lower-tier keys.
+   *
+   * @returns List of trending-search pool resources.
+   *
+   * @example
+   * ```ts
+   * const { data } = await onchain.trendingSearchPools();
+   * ```
+   */
+  trendingSearchPools() {
+    return this.client.get(
+      "/onchain/pools/trending_search"
+    );
+  }
+  /**
+   * Returns rich metadata / info for a single pool.
+   *
+   * @param network     - Network ID (e.g. `"eth"`).
+   * @param poolAddress - Pool contract address.
+   * @returns Single pool info resource (JSON:API envelope).
+   *
+   * @example
+   * ```ts
+   * const { data } = await onchain.poolInfo('eth', '0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640');
+   * ```
+   */
+  poolInfo(network, poolAddress) {
+    return this.client.get(
+      `/onchain/networks/${network}/pools/${poolAddress}/info`
+    );
+  }
+  /**
+   * Returns OHLCV (candlestick) data for a pool.
+   *
+   * @param network     - Network ID (e.g. `"eth"`).
+   * @param poolAddress - Pool contract address.
+   * @param timeframe   - Candle timeframe: `"minute"`, `"hour"`, or `"day"`.
+   * @param params      - Optional OHLCV query parameters (aggregate, limit, etc.).
+   * @returns OHLCV response containing an array of candles and token metadata.
+   *
+   * @example
+   * ```ts
+   * const ohlcv = await onchain.poolOhlcv(
+   *   'eth',
+   *   '0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640',
+   *   'hour',
+   *   { aggregate: '4', limit: 200 },
+   * );
+   * ohlcv.data?.attributes?.ohlcv_list?.forEach(([ts, o, h, l, c, v]) => {
+   *   console.log(new Date(ts * 1000).toISOString(), c);
+   * });
+   * ```
+   */
+  poolOhlcv(network, poolAddress, timeframe, params) {
+    return this.client.get(
+      `/onchain/networks/${network}/pools/${poolAddress}/ohlcv/${timeframe}`,
+      params
+    );
+  }
+  /**
+   * Returns recent trades for a pool.
+   *
+   * @param network     - Network ID (e.g. `"eth"`).
+   * @param poolAddress - Pool contract address.
+   * @param params      - Optional query parameters (e.g. `trade_volume_in_usd_greater_than`).
+   * @returns Trades response containing an array of trade objects.
+   *
+   * @example
+   * ```ts
+   * const trades = await onchain.poolTrades(
+   *   'eth',
+   *   '0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640',
+   * );
+   * ```
+   */
+  poolTrades(network, poolAddress, params) {
+    return this.client.get(
+      `/onchain/networks/${network}/pools/${poolAddress}/trades`,
+      params
+    );
+  }
+  // -------------------------------------------------------------------------
+  // Tokens
+  // -------------------------------------------------------------------------
+  /**
+   * Returns price and market data for a single token by contract address.
+   *
+   * @param network - Network ID (e.g. `"eth"`).
+   * @param address - Token contract address.
+   * @returns Single token resource (JSON:API envelope).
+   *
+   * @example
+   * ```ts
+   * const { data } = await onchain.token(
+   *   'eth',
+   *   '0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48',
+   * );
+   * console.log(data.attributes.symbol, data.attributes.price_usd);
+   * ```
+   */
+  token(network, address) {
+    return this.client.get(
+      `/onchain/networks/${network}/tokens/${address}`
+    );
+  }
+  /**
+   * Returns price and market data for multiple tokens in one request.
+   *
+   * @param network   - Network ID (e.g. `"eth"`).
+   * @param addresses - Array of token contract addresses (joined as comma-separated path segment).
+   * @returns List of token resources (JSON:API envelope).
+   *
+   * @example
+   * ```ts
+   * const { data } = await onchain.tokens('eth', [
+   *   '0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48',
+   *   '0xdac17f958d2ee523a2206206994597c13d831ec7',
+   * ]);
+   * ```
+   */
+  tokens(network, addresses) {
+    return this.client.get(
+      `/onchain/networks/${network}/tokens/multi/${addresses.join(",")}`
+    );
+  }
+  /**
+   * Returns rich metadata (socials, description, security flags) for a token.
+   *
+   * @param network - Network ID (e.g. `"eth"`).
+   * @param address - Token contract address.
+   * @returns Token info resource (JSON:API envelope).
+   *
+   * @example
+   * ```ts
+   * const { data } = await onchain.tokenInfo(
+   *   'eth',
+   *   '0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48',
+   * );
+   * console.log(data.attributes.description, data.attributes.gt_score);
+   * ```
+   */
+  tokenInfo(network, address) {
+    return this.client.get(
+      `/onchain/networks/${network}/tokens/${address}/info`
+    );
+  }
+  /**
+   * Returns the list of pools that include a given token.
+   *
+   * @param network - Network ID (e.g. `"eth"`).
+   * @param address - Token contract address.
+   * @param params  - Optional pagination parameters.
+   * @returns Paginated list of pool resources containing the token.
+   *
+   * @example
+   * ```ts
+   * const { data } = await onchain.tokenPools(
+   *   'eth',
+   *   '0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48',
+   * );
+   * ```
+   */
+  tokenPools(network, address, params) {
+    return this.client.get(
+      `/onchain/networks/${network}/tokens/${address}/pools`,
+      params
+    );
+  }
+  /**
+   * Returns OHLCV (candlestick) data for a token.
+   *
+   * @remarks
+   * **Requires Analyst+ (💼) plan.** Calls are rejected with HTTP 403 on
+   * lower-tier keys.
+   *
+   * @param network   - Network ID (e.g. `"eth"`).
+   * @param address   - Token contract address.
+   * @param timeframe - Candle timeframe: `"minute"`, `"hour"`, or `"day"`.
+   * @param params    - Optional OHLCV query parameters (aggregate, limit, etc.).
+   * @returns OHLCV response containing an array of candles and token metadata.
+   *
+   * @example
+   * ```ts
+   * const ohlcv = await onchain.tokenOhlcv(
+   *   'eth',
+   *   '0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48',
+   *   'day',
+   *   { limit: 30 },
+   * );
+   * ```
+   */
+  tokenOhlcv(network, address, timeframe, params) {
+    return this.client.get(
+      `/onchain/networks/${network}/tokens/${address}/ohlcv/${timeframe}`,
+      params
+    );
+  }
+  /**
+   * Returns recent trades involving a specific token.
+   *
+   * @remarks
+   * **Requires Analyst+ (💼) plan.** Calls are rejected with HTTP 403 on
+   * lower-tier keys.
+   *
+   * @param network - Network ID (e.g. `"eth"`).
+   * @param address - Token contract address.
+   * @param params  - Optional query parameters.
+   * @returns Trades response containing recent trade objects for the token.
+   *
+   * @example
+   * ```ts
+   * const trades = await onchain.tokenTrades(
+   *   'eth',
+   *   '0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48',
+   * );
+   * ```
+   */
+  tokenTrades(network, address, params) {
+    return this.client.get(
+      `/onchain/networks/${network}/tokens/${address}/trades`,
+      params
+    );
+  }
+  /**
+   * Returns the top traders for a specific token over the last 24 hours.
+   *
+   * @remarks
+   * **Requires Analyst+ (💼) plan.** Calls are rejected with HTTP 403 on
+   * lower-tier keys.
+   *
+   * @param network - Network ID (e.g. `"eth"`).
+   * @param address - Token contract address.
+   * @returns List response containing top trader entries.
+   *
+   * @example
+   * ```ts
+   * const result = await onchain.topTraders(
+   *   'eth',
+   *   '0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48',
+   * );
+   * ```
+   */
+  topTraders(network, address) {
+    return this.client.get(
+      `/onchain/networks/${network}/tokens/${address}/top_traders`
+    );
+  }
+  /**
+   * Returns the top holders (largest wallets) for a specific token.
+   *
+   * @remarks
+   * **Requires Analyst+ (💼) plan.** Calls are rejected with HTTP 403 on
+   * lower-tier keys.
+   *
+   * @param network - Network ID (e.g. `"eth"`).
+   * @param address - Token contract address.
+   * @returns List response containing top holder entries.
+   *
+   * @example
+   * ```ts
+   * const result = await onchain.topHolders(
+   *   'eth',
+   *   '0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48',
+   * );
+   * ```
+   */
+  topHolders(network, address) {
+    return this.client.get(
+      `/onchain/networks/${network}/tokens/${address}/top_holders`
+    );
+  }
+  /**
+   * Returns a time-series chart of holder count for a specific token.
+   *
+   * @remarks
+   * **Requires Analyst+ (💼) plan.** Calls are rejected with HTTP 403 on
+   * lower-tier keys.
+   *
+   * @param network - Network ID (e.g. `"eth"`).
+   * @param address - Token contract address.
+   * @returns Holder chart response with an array of `[timestamp, count]` data points.
+   *
+   * @example
+   * ```ts
+   * const chart = await onchain.holdersChart(
+   *   'eth',
+   *   '0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48',
+   * );
+   * chart.data?.attributes?.holders_chart?.forEach(([ts, count]) => {
+   *   console.log(new Date(ts * 1000).toISOString(), count);
+   * });
+   * ```
+   */
+  holdersChart(network, address) {
+    return this.client.get(
+      `/onchain/networks/${network}/tokens/${address}/holders_chart`
+    );
+  }
+  /**
+   * Returns a list of tokens whose info was recently updated on GeckoTerminal.
+   *
+   * Useful for syncing token metadata caches.
+   *
+   * @returns List of recently-updated token info resources (JSON:API).
+   *
+   * @example
+   * ```ts
+   * const { data } = await onchain.recentlyUpdatedTokens();
+   * data.forEach(t => console.log(t.attributes.symbol, t.attributes.coingecko_coin_id));
+   * ```
+   */
+  recentlyUpdatedTokens() {
+    return this.client.get(
+      "/onchain/tokens/info_recently_updated"
+    );
+  }
+  // -------------------------------------------------------------------------
+  // Categories (Analyst+)
+  // -------------------------------------------------------------------------
+  /**
+   * Returns the list of GeckoTerminal onchain categories.
+   *
+   * @remarks
+   * **Requires Analyst+ (💼) plan.** Calls are rejected with HTTP 403 on
+   * lower-tier keys.
+   *
+   * @returns Response containing an array of category objects.
+   *
+   * @example
+   * ```ts
+   * const { data } = await onchain.categories();
+   * data.forEach(c => console.log(c.id, c.attributes?.name));
+   * ```
+   */
+  categories() {
+    return this.client.get("/onchain/categories");
+  }
+  /**
+   * Returns pools belonging to a specific GeckoTerminal onchain category.
+   *
+   * @remarks
+   * **Requires Analyst+ (💼) plan.** Calls are rejected with HTTP 403 on
+   * lower-tier keys.
+   *
+   * @param categoryId - Category ID (e.g. `"defi"`, `"meme"`).
+   * @param params     - Optional pagination parameters.
+   * @returns Paginated list of pool resources in the category.
+   *
+   * @example
+   * ```ts
+   * const { data } = await onchain.categoryPools('meme', { page: 1, per_page: 50 });
+   * data.forEach(p => console.log(p.attributes.name, p.attributes.volume_usd?.h24));
+   * ```
+   */
+  categoryPools(categoryId, params) {
+    return this.client.get(
+      `/onchain/categories/${categoryId}/pools`,
+      params
+    );
+  }
+};
+
+// src/endpoints/global.ts
+var GlobalEndpoints = class {
+  constructor(client) {
+    this.client = client;
+  }
+  // ---------------------------------------------------------------------------
+  // /global
+  // ---------------------------------------------------------------------------
+  /**
+   * Returns global cryptocurrency market data, including total market cap,
+   * volume, dominance, and number of active coins and exchanges.
+   *
+   * @returns {@link GlobalData} wrapping a {@link GlobalDataPayload}.
+   *
+   * @example
+   * ```ts
+   * const { data } = await global.global();
+   * console.log(data.market_cap_percentage?.btc); // BTC dominance %
+   * ```
+   */
+  async global() {
+    return this.client.get("/global");
+  }
+  // ---------------------------------------------------------------------------
+  // /global/decentralized_finance_defi
+  // ---------------------------------------------------------------------------
+  /**
+   * Returns global DeFi market data, including total DeFi market cap, ETH
+   * market cap, DeFi dominance, and trading volume.
+   *
+   * @returns {@link GlobalDefiData} wrapping a {@link GlobalDefiPayload}.
+   *
+   * @example
+   * ```ts
+   * const { data } = await global.globalDefi();
+   * console.log(data.defi_market_cap);
+   * ```
+   */
+  async globalDefi() {
+    return this.client.get("/global/decentralized_finance_defi");
+  }
+  // ---------------------------------------------------------------------------
+  // /global/market_cap_chart (Analyst+)
+  // ---------------------------------------------------------------------------
+  /**
+   * Returns historical global market cap and volume chart data.
+   *
+   * @param params - Required query parameters, including `days`.
+   * @returns {@link GlobalMarketCapChartResponse} with `market_cap` and
+   *   `volume` time series arrays.
+   *
+   * @remarks Requires **Analyst+** plan.
+   *
+   * @example
+   * ```ts
+   * const chart = await global.globalMarketCapChart({ days: 30 });
+   * console.log(chart.market_cap_chart.market_cap[0]); // [timestamp_ms, value]
+   * ```
+   */
+  async globalMarketCapChart(params) {
+    return this.client.get(
+      "/global/market_cap_chart",
+      params
+    );
+  }
+  // ---------------------------------------------------------------------------
+  // /search
+  // ---------------------------------------------------------------------------
+  /**
+   * Searches for coins, exchanges, categories, and NFT collections by a
+   * free-text query string.
+   *
+   * @param query - Search term (e.g. `"bitcoin"`, `"uni"`).
+   * @returns {@link SearchResponse} with matched coins, exchanges, categories,
+   *   and NFTs.
+   *
+   * @example
+   * ```ts
+   * const results = await global.search('uniswap');
+   * results.coins.forEach(c => console.log(c.id, c.name));
+   * ```
+   */
+  async search(query) {
+    return this.client.get("/search", { query });
+  }
+  // ---------------------------------------------------------------------------
+  // /search/trending
+  // ---------------------------------------------------------------------------
+  /**
+   * Returns the top trending coins, NFTs, and categories on CoinGecko in the
+   * last 24 hours, determined by search volume.
+   *
+   * @returns {@link TrendingResponse} with arrays of trending coins, NFTs, and
+   *   categories.
+   *
+   * @example
+   * ```ts
+   * const { coins } = await global.trending();
+   * coins.forEach(({ item }) => console.log(item.name));
+   * ```
+   */
+  async trending() {
+    return this.client.get("/search/trending");
+  }
+  // ---------------------------------------------------------------------------
+  // /exchange_rates
+  // ---------------------------------------------------------------------------
+  /**
+   * Returns BTC exchange rates against fiat currencies, crypto assets, and
+   * commodities.
+   *
+   * @returns {@link ExchangeRatesResponse} mapping currency codes to rate data.
+   *
+   * @example
+   * ```ts
+   * const { rates } = await global.exchangeRates();
+   * console.log(rates['usd']?.value); // BTC price in USD
+   * ```
+   */
+  async exchangeRates() {
+    return this.client.get("/exchange_rates");
+  }
+  // ---------------------------------------------------------------------------
+  // /asset_platforms
+  // ---------------------------------------------------------------------------
+  /**
+   * Returns a list of all asset platforms (blockchain networks) supported by
+   * CoinGecko.
+   *
+   * @param params - Optional filter parameters (e.g. `filter: 'nft'`).
+   * @returns Array of {@link AssetPlatform} objects.
+   *
+   * @example
+   * ```ts
+   * const platforms = await global.assetPlatforms({ filter: 'nft' });
+   * ```
+   */
+  async assetPlatforms(params) {
+    return this.client.get(
+      "/asset_platforms",
+      params
+    );
+  }
+  // ---------------------------------------------------------------------------
+  // /token_lists/{platformId}/all.json
+  // ---------------------------------------------------------------------------
+  /**
+   * Returns a Uniswap-compatible token list for all tokens on a given asset
+   * platform.
+   *
+   * @param platformId - Asset platform ID (e.g. `"ethereum"`).
+   * @returns Token list object in the standard Uniswap token list format.
+   *   The exact shape depends on the platform; typed as `unknown` for
+   *   flexibility.
+   *
+   * @example
+   * ```ts
+   * const list = await global.tokenLists('ethereum');
+   * ```
+   */
+  async tokenLists(platformId) {
+    return this.client.get(
+      `/token_lists/${encodeURIComponent(platformId)}/all.json`
+    );
+  }
+};
+
+// src/endpoints/treasury.ts
+var TreasuryEndpoints = class {
+  constructor(client) {
+    this.client = client;
+  }
+  // ---------------------------------------------------------------------------
+  // /entities/list
+  // ---------------------------------------------------------------------------
+  /**
+   * Returns a list of all public entities (companies and governments) tracked
+   * in CoinGecko's public treasury database.
+   *
+   * @returns Array of {@link Entity} objects with `id`, `name`, `symbol`, and
+   *   `country`.
+   *
+   * @example
+   * ```ts
+   * const entities = await treasury.entitiesList();
+   * entities.forEach(e => console.log(e.id, e.name));
+   * ```
+   */
+  async entitiesList() {
+    return this.client.get("/entities/list");
+  }
+  // ---------------------------------------------------------------------------
+  // /companies/public_treasury/{coinId}
+  // ---------------------------------------------------------------------------
+  /**
+   * Returns public company Bitcoin or Ethereum treasury holdings, including
+   * aggregate totals and per-company breakdowns.
+   *
+   * @param coinId - Coin API ID to query holdings for.
+   *   Currently supported values: `"bitcoin"`, `"ethereum"`.
+   * @returns {@link CompanyTreasuryResponse} with aggregate totals and a
+   *   `companies` array.
+   *
+   * @example
+   * ```ts
+   * const holdings = await treasury.companyHoldings('bitcoin');
+   * console.log(holdings.total_holdings);
+   * holdings.companies.forEach(c => console.log(c.name, c.total_holdings));
+   * ```
+   */
+  async companyHoldings(coinId) {
+    return this.client.get(
+      `/companies/public_treasury/${encodeURIComponent(coinId)}`
+    );
+  }
+  // ---------------------------------------------------------------------------
+  // /public_treasury/{entityId}
+  // ---------------------------------------------------------------------------
+  /**
+   * Returns the full treasury profile for a single public entity, including
+   * all cryptocurrency holdings and financial metrics.
+   *
+   * @param entityId - Entity API ID (e.g. `"strategy"`, `"tesla"`). Use
+   *   {@link entitiesList} to discover valid IDs.
+   * @returns {@link PublicTreasuryEntity} with holdings, valuation, and PnL.
+   *
+   * @example
+   * ```ts
+   * const profile = await treasury.entityHoldings('strategy');
+   * console.log(profile.total_treasury_value_usd);
+   * profile.holdings?.forEach(h => console.log(h.coin_id, h.amount));
+   * ```
+   */
+  async entityHoldings(entityId) {
+    return this.client.get(
+      `/public_treasury/${encodeURIComponent(entityId)}`
+    );
+  }
+  // ---------------------------------------------------------------------------
+  // /public_treasury/{entityId}/{coinId}/holding_chart
+  // ---------------------------------------------------------------------------
+  /**
+   * Returns historical holding amount and USD value chart data for a specific
+   * coin in an entity's treasury.
+   *
+   * @param entityId - Entity API ID (e.g. `"strategy"`).
+   * @param coinId   - Coin API ID (e.g. `"bitcoin"`).
+   * @param params   - Required query parameters, including `days`.
+   * @returns {@link TreasuryHoldingChartResponse} with `holdings` and
+   *   `holding_value_in_usd` time series.
+   *
+   * @example
+   * ```ts
+   * const chart = await treasury.entityHoldingChart('strategy', 'bitcoin', {
+   *   days: '365',
+   * });
+   * chart.holdings?.forEach(([ts, amount]) => console.log(ts, amount));
+   * ```
+   */
+  async entityHoldingChart(entityId, coinId, params) {
+    return this.client.get(
+      `/public_treasury/${encodeURIComponent(entityId)}/${encodeURIComponent(coinId)}/holding_chart`,
+      params
+    );
+  }
+  // ---------------------------------------------------------------------------
+  // /public_treasury/{entityId}/transaction_history
+  // ---------------------------------------------------------------------------
+  /**
+   * Returns the paginated transaction history for a public treasury entity,
+   * including buy/sell events with price and value data.
+   *
+   * @param entityId - Entity API ID (e.g. `"strategy"`).
+   * @param params   - Optional pagination and coin filter parameters.
+   * @returns {@link TreasuryTransactionHistoryResponse} with a `data` array of
+   *   {@link TreasuryTransaction} records.
+   *
+   * @example
+   * ```ts
+   * const history = await treasury.entityTransactions('strategy', {
+   *   coin_ids: 'bitcoin',
+   *   per_page: 50,
+   * });
+   * history.data?.forEach(tx => console.log(tx.date, tx.transaction_type, tx.amount));
+   * ```
+   */
+  async entityTransactions(entityId, params) {
+    return this.client.get(
+      `/public_treasury/${encodeURIComponent(entityId)}/transaction_history`,
+      params
+    );
+  }
+};
+
+// src/endpoints/meta.ts
+var MetaEndpoints = class {
+  constructor(client) {
+    this.client = client;
+  }
+  // ---------------------------------------------------------------------------
+  // /ping
+  // ---------------------------------------------------------------------------
+  /**
+   * Checks the API server status. Use this as a lightweight connectivity test
+   * before making heavier requests.
+   *
+   * @returns {@link PingResponse} containing a `gecko_says` status string
+   *   (e.g. `"(V3) To the Moon!"`).
+   *
+   * @example
+   * ```ts
+   * const { gecko_says } = await meta.ping();
+   * console.log(gecko_says); // "(V3) To the Moon!"
+   * ```
+   */
+  async ping() {
+    return this.client.get("/ping");
+  }
+  // ---------------------------------------------------------------------------
+  // /key (Analyst+)
+  // ---------------------------------------------------------------------------
+  /**
+   * Returns usage statistics and plan information for the current Pro API key.
+   *
+   * @returns {@link ApiUsageResponse} with plan name, rate limit, monthly
+   *   credit usage, and remaining credits.
+   *
+   * @remarks Requires a valid **Pro API key** (Analyst+ plan). Returns 401 for
+   *   free-tier or unauthenticated requests.
+   *
+   * @example
+   * ```ts
+   * const usage = await meta.apiUsage();
+   * console.log(usage.plan);                             // "Analyst"
+   * console.log(usage.current_remaining_monthly_calls); // remaining credits
+   * ```
+   */
+  async apiUsage() {
+    return this.client.get("/key");
+  }
+};
+
+// src/index.ts
+var CoinGecko = class {
+  /** Coin prices, market data, charts, OHLC, supply, categories, and contract lookups. */
+  coins;
+  /** Exchange listings, details, tickers, and volume charts. */
+  exchanges;
+  /** Derivatives tickers and exchange data. */
+  derivatives;
+  /** NFT collections, market data, charts, and tickers. */
+  nfts;
+  /** On-chain DEX data (GeckoTerminal): pools, tokens, trades, OHLCV, top traders/holders. */
+  onchain;
+  /** Global market data, search, trending, exchange rates, and asset platforms. */
+  global;
+  /** Public treasury holdings, charts, and transaction history. */
+  treasury;
+  meta;
+  /**
+   * Creates a new CoinGecko SDK instance.
+   *
+   * @param config - Optional configuration for the underlying HTTP client.
+   *   See {@link CoinGeckoClientConfig} for all available options.
+   */
+  constructor(config) {
+    const client = new CoinGeckoClient(config);
+    this.coins = new CoinsEndpoints(client);
+    this.exchanges = new ExchangesEndpoints(client);
+    this.derivatives = new DerivativesEndpoints(client);
+    this.nfts = new NftsEndpoints(client);
+    this.onchain = new OnchainEndpoints(client);
+    this.global = new GlobalEndpoints(client);
+    this.treasury = new TreasuryEndpoints(client);
+    this.meta = new MetaEndpoints(client);
+  }
+  /**
+   * Checks the CoinGecko API server status.
+   *
+   * Use this as a lightweight connectivity and authentication test.
+   *
+   * @returns Object containing the server status message
+   *   (`{ gecko_says: "(V3) To the Moon!" }`).
+   *
+   * @example
+   * ```typescript
+   * const { gecko_says } = await cg.ping();
+   * console.log(gecko_says); // "(V3) To the Moon!"
+   * ```
+   */
+  async ping() {
+    return this.meta.ping();
+  }
+  /**
+   * Returns API key usage statistics and plan information.
+   *
+   * @remarks Requires a valid **Pro API key** (Analyst+ plan). Returns 401 on
+   *   free-tier or unauthenticated requests.
+   *
+   * @returns Usage data including plan name, rate limits, and remaining credits.
+   *
+   * @example
+   * ```typescript
+   * const usage = await cg.apiUsage();
+   * console.log(usage.plan, usage.current_remaining_monthly_calls);
+   * ```
+   */
+  async apiUsage() {
+    return this.meta.apiUsage();
+  }
+};
+
+export { CoinGecko, CoinGeckoClient, CoinGeckoError, CoinsEndpoints, DerivativesEndpoints, ExchangesEndpoints, GlobalEndpoints, MetaEndpoints, NftsEndpoints, OnchainEndpoints, TreasuryEndpoints };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map