Overview
Features
Retry logic with exponential backoff
Automatically retries transient failures by default (2 retries) with exponential backoff; configurable maxRetries.
Configurable timeouts
Default 1 minute timeout with per-request overrides; per-request timeout supported.
Comprehensive error handling
APIError family with specific error types for common HTTP errors (e.g., BadRequestError, AuthenticationError, etc.).
Raw Response access
Access the raw fetch Response via asResponse() and withResponse() helpers.
Type-safe request/response definitions
TypeScript definitions for all request parameters and responses, with hover documentation.
Flexible fetch customization
Support custom fetch implementations, fetchOptions, and proxy configurations for different runtimes.
Undocumented endpoints support
Make calls to undocumented endpoints or parameters; extra values pass through without runtime validation.
Configurable logging
Control log output via COINGECKO_LOG or logLevel; optional custom logger support.
Who Is This For?
- Developers:Build server-side apps in TypeScript/JavaScript to access CoinGecko price and market data via REST API.
- API integrators:Integrate CoinGecko data into dashboards and services with typed parameters.
- Backend engineers:Ensure resilient API calls with retries, timeouts, and customizable fetch.




