Go SDK

Install the module

Code
go get github.com/OpenCMC/coinmarketcap-api-go/v5

Create a client

Set your API key from the Developer Portal. For keyless endpoints, use WithEnvironment(coinmarketcap.EnvironmentPublic).

Code
import (
	"log"
	"os"

	"github.com/OpenCMC/coinmarketcap-api-go/v5"
)

cmc, err := coinmarketcap.New(coinmarketcap.WithAPIKey(os.Getenv("CMC_PRO_API_KEY")))
if err != nil {
	log.Fatal(err)
}

Call an endpoint

Endpoints are grouped by category on the client. Optional parameters are pointers; coinmarketcap.String, Int, Float64, Bool and Ptr create them:

Code
quotes, err := cmc.Cryptocurrency.QuotesLatest(ctx, &coinmarketcap.CryptocurrencyQuotesLatestParams{
	ID: coinmarketcap.String("1,1027"),
})
if err != nil {
	log.Fatal(err)
}
for _, coin := range quotes.Data {
	if coin.Name != nil {
		fmt.Println(*coin.Name)
	}
}

Handle errors

HTTP errors come back as typed errors. Use errors.As to inspect them:

Code
var rateLimited *coinmarketcap.RateLimitError
var apiErr *coinmarketcap.CMCError
switch {
case errors.As(err, &rateLimited):
	// 429 - check the Retry-After header
	fmt.Println(rateLimited.Header.Get("Retry-After"))
case errors.As(err, &apiErr):
	// Any HTTP error, with the API's error code and message
	fmt.Println(apiErr.StatusCode, apiErr.ErrorCode, apiErr.Message)
}