coingecko_client

CoinGecko API client for Dart

A simple and intuitive package for the CoinGecko REST API Service ( v3 ).

⚔️ Why this ❓🤨🤔

✔️ fully tested ( see test coverage ).
✔️ simple and easy to use.
✔️ almost all results are converted to model/dto/entity ( so you don't need to worry about making your own model classes ).
✔️ fully documented.
✔️ actively being developed and supported.

💡 You can go directly to the examples and see for yourself.

API Version Support
Requirements
Installation
Usage
- Sample Usage
Endpoints
- ping
- coins
- exchanges
- simple
- derivatives
- indexes
- nfts
- contract
- asset_platforms
- categories
- global
- exchange rates
- companies
- trending
- search
Issues / Bugs / Improvements
Contacts

API Version Support

✔️ API v3
✔️ Community

Requirements

✔️ dart sdk: >= 2.19.3

Installation

Add the dependency to your Dart / Flutter project:
( in pubspec.yaml file under the dependencies, add the following )

coingecko_client: ^1.2.2

Go to pub.dev for more details.

Usage

Import the library and initialize the client class.

import 'package:coingecko_client/coingecko_client.dart';

final client = CoinGeckoClient();

Use any of the client properties to access the services. (use coins)
All results are returned from a Future object so async/await is necessary.

final coinHistory = await client.coins.getHistory(
    id: 'bitcoin',
    date: DateTime.now()
);

The following sample just prints the property so just do yours here.
💡 TIP : Most editors(especially VS Code) supports object reflection. You can hover on the result object to conveniently get all the available properties you can use.

print(coinHistory);
print(coinHistory.name);

Result varies depending on the endpoint.
It's recommended to wrap it within a try/catch block to handle the runtime errors - not only because it's part of the package design but also the ideal way to do this.

Sample Usage

import 'package:coingecko_client/coingecko_client.dart';

void main() async {
    try {
        final client = CoinGeckoClient();
        final coinHistory = await client.coins.getHistory(
            id: 'bitcoin',
            date: DateTime.now()
        );
        print(coinHistory);
        print(coinHistory.name);

    } on Exception catch (e, _) {
        /// Exception handling
        /// All runtime exceptions will go here.
        /// All http status code other than 200 will also be here.
        /// [Sample error handling]
        print("error occured");
        if(e is NetworkRequestException) {
            print(e.statusCode);
        } else {
            rethrow;
        }
    }
}

Look at the sample code.
HTTP status code other than 200 will be raised as an exception. i.e. 404 or 429.
Non-error status codes such as >= 201, 3xx or 1xx will still be treated as an exception as the API service does not require methods other than GET request.
This might change in the future but it's not part of their service as of now. (YAGNI)
Check here for more examples.

Endpoints

`Community`

🌐 ping

📤 /ping

client.ping.getResult();

🌐 coins

📤 /coins/list

client.coins.getBasicList();

📤 /coins/{id}/history

client.coins.getHistory(
    id: 'bitcoin',
    date: DateTime.now()
);

📤 /coins/markets

client.coins.getMarketList(
    vsCurrency: Currencies.php
);

📤 /coins/{id}

client.coins.getInfo(id: 'verus-coin');

📤 /coins/{id}/tickers

client.coins.getTickers(id: 'bitcoin');

📤 /coins/{id}/market_chart

client.coins.getMarketHistory(
    id: 'bitcoin',
    vsCurrency: Currencies.php,
    days: DataRange.in1Day,
    interval: 'daily'
);

📤 /coins/{id}/market_chart/range

client.coins.getMarketHistoryWithDateRange(
    id: 'bitcoin',
    vsCurrency: Currencies.php,
    from: DateTime.fromMillisecondsSinceEpoch(1392577232),
    to: DateTime.fromMillisecondsSinceEpoch(1396587232)
);

📤 /coins/{id}/ohlc

client.coins.getOhlcList(
    id: 'bitcoin',
    vsCurrency: Currencies.php,
    days: DataRange.max
);

`💰PRO Endpoints`

📤 /coins/list/new

client.coins.getNewList();

📤 /coins/top_gainers_losers

client.coins.getTopGainersAndLosers(
    vsCurrency: Currencies.php,
    duration: CoinDuration.in14Days,
    topCoins: CoinRanking.top300
);

🌐 exchanges

📤 /exchanges

client.exchanges.getList();

📤 /exchanges/list

client.exchanges.getBasicList();

📤 /exchanges/{id}

client.exchanges.getInfo(id: 'binance');

📤 /exchanges/{id}/tickers

client.exchanges.getTickerList(
    id: 'binance',
    coinIds: ['bitcoin', 'ethereum'],
    includeExchangeLogo: true,
    page: 1,
    depth: true,
    order: ExchangeDataOrdering.trustScoreDesc
);

📤 /exchanges/{id}/volume_chart

client.exchanges.getVolumeChartList(
    id: 'binance',
    days: DataRange.in1Day
);

🌐 simple

📤 /simple/price

client.simple.getCoinPrice(
    ids: ['bitcoin', 'ethereum', 'verus-coin'],
    vsCurrencies: [ Currencies.jpy, Currencies.usd, Currencies.php ],
    includeMarketCap: true,
    include24hrVol: true,
    include24hrChange: true,
    includeLastUpdatedAt: true,
    precision: 18
);

📤 /simple/token_price/{id}

client.simple.getTokenPrice(
    id: 'avalanche',
    contractAddresses: ['0x2098fABE9C82eb5280AF4841a5000f373E99a498'],
    vsCurrencies: [ CryptoCurrencies.btc, CryptoCurrencies.eth ],
    includeMarketCap: true,
    include24hrVol: true,
    include24hrChange: true,
    includeLastUpdatedAt: true,
    precision: 18
);

📤 /simple/supported_vs_currencies

client.simple.getSupportedVsCurrencies();

🌐 derivatives

📤 /derivatives

client.derivatives.getList(
    includeTickers: DerivativesTickers.unexpired
);

📤 /derivatives/exchanges

client.derivatives.getExchangeList(
    order: DerivativesExchangeOrdering.nameAsc,
    perPage: 10,
    page: 2
);

📤 /derivatives/exchanges/{id}

client.derivatives.getExchange(
    id: "bybit",
    includeTickers: DerivativesTickers.unexpired
);

📤 /derivatives/exchanges/list

client.derivatives.getExchangeBasicInfoList();

🌐 indexes

📤 /indexes

client.indexes.getList(
    perPage: 10,
    page: 2
);

📤 /indexes/{market_id}/{id}

client.indexes.getInfo(
    marketId: 'bybit',
    id: 'HOT',
);

📤 /indexes/list

client.indexes.getBasicInfo();

🌐 nfts

📤 /nfts/list

client.nfts.getBasicList(
    perPage: 10,
    page: 2
);

📤 /nfts/{id}

client.nfts.getInfo(
    id: 'meebits',
);

📤 /nfts/{asset_platform_id}/contract/{contract_address}

client.nfts.getContractInfo(
    assetPlatformId: 'ethereum',
    contractAddress: '0x36F379400DE6c6BCDF4408B282F8b685c56adc60',
);

🌐 contract

📤 /coins/{id}/contract/{contract_address}/market_chart

client.contract.getMarketHistory(
    id: 'ethereum',
    contractAddress: '0x1f9840a85d5af5bf1d1762f925bdaddc4201f984',
    vsCurrency: Currencies.jpy,
    days: DataRange.in2Weeks,
);

📤 /coins/{id}/contract/{contract_address}/market_chart/range

client.contract.getMarketHistoryWithDateRange(
    id: 'ethereum',
    contractAddress: '0x1f9840a85d5af5bf1d1762f925bdaddc4201f984',
    vsCurrency: Currencies.php,
    from: DateTime.fromMillisecondsSinceEpoch(1683175446, isUtc: true),
    to: DateTime.fromMillisecondsSinceEpoch(1683262856, isUtc: true),
);

🌐 asset_platforms

📤 /asset_platforms

client.assetPlatforms.getList();

🌐 categories

📤 /coins/categories/list

client.categories.getBasicList();

📤 /coins/categories

client.categories.getList(
    order: CoinCategoriesDataOrdering.marketCapAsc
);

🌐 global

📤 /global

client.global.getCryptoInfo();

📤 /global/decentralized_finance_defi

client.global.getDefiInfo();

🌐 exchange rates

📤 /exchange_rates

client.exchangeRates.getList();

🌐 companies

📤 /companies/public_treasury/{coin_id}

client.companies.getList(
    coinId: 'ethereum'
);

📤 /search/trending

client.trending.getResult();

🌐 search

📤 /search

client.search.getResult(query: 'bybit');

🐞 Issues / Bugs / Improvements

If you found any issues or bugs, please raise it here.
For urgent fix, please chat directly to the discord channel and I'll find time to resolve it.
Should you decide to make your own change, create your own branch and raise a PR to the master branch and ping me.
Any suggestions or concerns, you can contact me directly using discord, twitter or email.

Contacts

pangz.lab@gmail.com

Pangz#4102