The go-coinmarketcap from miguelmota

go-coinmarketcap's Introduction

The unofficial CoinMarketCap API client for Go.

Supports the CoinMarketCap API Pro Version, V2 and V1 Public API

Documentation
Install
Getting Started
Examples
Contributing
Development
License

Documentation

https://godoc.org/github.com/miguelmota/go-coinmarketcap

Install

go get -u github.com/miguelmota/go-coinmarketcap

Pro V1 (latest)

Type	Endpoint	Implemented?
Cryptocurrency	/v1/cryptocurrency/info	✓
Cryptocurrency	/v1/cryptocurrency/map	✓
Cryptocurrency	/v1/cryptocurrency/listings/latest	✓
Cryptocurrency	/v1/cryptocurrency/market-pairs/latest	✓
Cryptocurrency	/v1/cryptocurrency/ohlcv/historical	-
Cryptocurrency	/v1/cryptocurrency/quotes/latest	✓
Cryptocurrency	/v1/cryptocurrency/quotes/historical	-
Exchange	/v1/exchange/info	-
Exchange	/v1/exchange/map	-
Exchange	/v1/exchange/listings/latest	-
Exchange	/v1/exchange/market-pairs/latest	-
Exchange	/v1/exchange/quotes/latest	-
Exchange	/v1/exchange/quotes/historical	-
Global Metrics	/v1/global-metrics/quotes/latest	✓
Global Metrics	/v1/global-metrics/quotes/historical	-
Tools	/v1/tools/price-conversion	✓

Note: some endpoints require a paid plan.

Getting started

package main

import (
	"fmt"
	"os"

	cmc "github.com/miguelmota/go-coinmarketcap/pro/v1"
)

func main() {
	client := cmc.NewClient(&cmc.Config{
		ProAPIKey: os.Getenv("CMC_PRO_API_KEY"),
	})

	listings, err := client.Cryptocurrency.LatestListings(&cmc.ListingOptions{
		Limit: 1,
	})
	if err != nil {
		panic(err)
	}

	for _, listing := range listings {
		fmt.Println(listing.Name)               // "Bitcoin"
		fmt.Println(listing.Quote["USD"].Price) // 6316.75736886
	}
}

Examples

For more examples, check out the ./pro/v1/example directory and documentation

V2

NOTE: CoinMarketCap deprecated this API on December 2018

Getting started

package main

import (
	"fmt"
	"log"

	cmc "github.com/miguelmota/go-coinmarketcap/v2"
)

func main() {
	tickers, err := cmc.Tickers(&cmc.TickersOptions{
		Start:   0,
		Limit:   100,
		Convert: "USD",
	})
	if err != nil {
		log.Fatal(err)
	}

	for _, ticker := range tickers {
		fmt.Println(ticker.Symbol, ticker.Quotes["USD"].Price)
	}
}

Examples

For more examples, check out the ./v2/example directory and documentation

V1

NOTE: CoinMarketCap deprecated this API on November 2018

Getting started

package main

import (
	"fmt"
	"log"

	cmc "github.com/miguelmota/go-coinmarketcap/v1"
)

func main() {
	tickers, err := cmc.Tickers(&cmc.TickersOptions{
		Start:   0,
		Limit:   100,
		Convert: "USD",
	})
	if err != nil {
		log.Fatal(err)
	}

	for _, ticker := range tickers {
		fmt.Println(ticker.Symbol, ticker.Quotes["USD"].Price)
	}
}