TypeScript SDK

Full type safety and auto-complete — catch errors at compile time, not runtime.

Prompt for integrating CoinGecko TypeScript SDK

Or set up manually:

Install

npm install @coingecko/coingecko-typescript

bun add @coingecko/coingecko-typescript

View on npm | GitHub

Import and authenticate

import Coingecko from '@coingecko/coingecko-typescript';

const client = new Coingecko({
  proAPIKey: 'YOUR_API_KEY',
  environment: 'pro',
});

import Coingecko from '@coingecko/coingecko-typescript';

const client = new Coingecko({
  demoAPIKey: 'YOUR_API_KEY',
  environment: 'demo',
});

Replace YOUR_API_KEY with your key from the Developer Dashboard.

Make your first request

async function main() {
  const response = await client.simple.price.get({
    vs_currencies: 'usd',
    ids: 'bitcoin',
  });

  console.log(JSON.stringify(response, null, 2));
}

main()

Find the right method

SDK methods map to endpoint paths. For example, /simple/price becomes client.simple.price.get(). Two ways to find the right method:

Every endpoint page includes an SDK Examples section at the bottom with copy-ready code. For example, see the Coin Price by IDs page:
Visit all methods to browse the full list with endpoint mappings.

Found a bug or missing feature? Open an issue.

CoinGecko SDK Python SDK

Get Started

Guides

Resources