currencyconverter

package

v0.0.0-...-eb07c7e Latest Latest Go to latest Published: Jul 19, 2019 License: MIT Imports: 9 Imported by: 0

Details

Valid go.mod file

The Go module system was introduced in Go 1.11 and is the official dependency management solution for Go.
Redistributable license

Redistributable licenses place minimal restrictions on how software can be used, modified, and redistributed.
Tagged version

Modules with tagged versions give importers more predictable builds.
Stable version

When a project reaches major version v1 it is considered stable.
Learn more about best practices

Repository

github.com/thrasher-/gocryptotrader

README ¶

GoCryptoTrader package Forexprovider

This forexprovider package is part of the GoCryptoTrader codebase.

This is still in active development

You can track ideas, planned features and what's in progresss on this Trello board: https://trello.com/b/ZAhMhpOy/gocryptotrader.

Join our slack to discuss all things related to GoCryptoTrader! GoCryptoTrader Slack

Current Features for forexprovider

Fetches up to date curency data from Currency Coverter API

How to enable

Enable via configuration
Individual package example below:

import (
"github.com/thrasher-/gocryptotrader/currency/forexprovider/base"
"github.com/thrasher-/gocryptotrader/currency/forexprovider/currencyconverter"
)

c := currencyconverter.CurrencyConverter{}

// Define configuration
newSettings := base.Settings{
  Name: "CurrencyConverter",
	Enabled: true,
	Verbose: false,
	RESTPollingDelay: time.Duration,
	APIKey: "key",
	APIKeyLvl: "keylvl",
	PrimaryProvider: true,
}

c.Setup(newSettings)

mapstringfloat, err := c.GetRates("USD", "EUR,CHY")
// Handle error

Please click GoDocs chevron above to view current GoDoc information for this package

Contribution

Please feel free to submit any pull requests or suggest any desired features to be added.

When submitting a PR, please abide by our coding guidelines:

Code must adhere to the official Go formatting guidelines (i.e. uses gofmt).
Code must be documented adhering to the official Go commentary guidelines.
Code must adhere to our coding style.
Pull requests need to be based on and opened against the master branch.

Donations

If this framework helped you in any way, or you would like to support the developers working on it, please donate Bitcoin to:

1F5zVDgNjorJ51oGebSvNCrSAHpwGkUdDB

Documentation ¶

Constants ¶

View Source

const (
	APIEndpointURL     = "https://currencyconverterapi.com/api/"
	APIEndpointFreeURL = "https://free.currencyconverterapi.com/api/"
	APIEndpointVersion = "v5"

	APIEndpointConvert    = "convert"
	APIEndpointCurrencies = "currencies"
	APIEndpointCountries  = "countries"
	APIEndpointUsage      = "usage"
)

const declarations consist of endpoints

Variables ¶

This section is empty.

Functions ¶

This section is empty.

Types ¶

type Countries ¶

type Countries struct {
	Results map[string]CountryItem
}

Countries stores the country result data

type CountryItem ¶

type CountryItem struct {
	Alpha3         string `json:"alpha3"`
	CurrencyID     string `json:"currencyId"`
	CurrencyName   string `json:"currencyName"`
	CurrencySymbol string `json:"currencySymbol"`
	ID             string `json:"ID"`
	Name           string `json:"Name"`
}

CountryItem stores variables related to the country response

type Currencies ¶

type Currencies struct {
	Results map[string]CurrencyItem
}

Currencies stores the currency result data

type CurrencyConverter ¶

type CurrencyConverter struct {
	base.Base
	Requester *request.Requester
}

CurrencyConverter stores the struct for the CurrencyConverter API

func (*CurrencyConverter) Convert ¶

func (c *CurrencyConverter) Convert(from, to string) (map[string]float64, error)

Convert gets the conversion rate for the supplied currencies

func (*CurrencyConverter) ConvertMany ¶

func (c *CurrencyConverter) ConvertMany(currencies []string) (map[string]float64, error)

ConvertMany takes 2 or more currencies depending on if using the free or paid API

func (*CurrencyConverter) GetCountries ¶

func (c *CurrencyConverter) GetCountries() (map[string]CountryItem, error)

GetCountries returns a list of the supported countries and their symbols

func (*CurrencyConverter) GetRates ¶

func (c *CurrencyConverter) GetRates(baseCurrency, symbols string) (map[string]float64, error)

GetRates is a wrapper function to return rates

func (*CurrencyConverter) GetSupportedCurrencies ¶

func (c *CurrencyConverter) GetSupportedCurrencies() ([]string, error)

GetSupportedCurrencies returns a list of the supported currencies

func (*CurrencyConverter) SendHTTPRequest ¶

func (c *CurrencyConverter) SendHTTPRequest(endPoint string, values url.Values, result interface{}) error

SendHTTPRequest sends a HTTP request, if account is not free it automatically upgrades request to SSL.

func (*CurrencyConverter) Setup ¶

func (c *CurrencyConverter) Setup(config base.Settings) error

Setup sets appropriate values for CurrencyLayer

type CurrencyItem ¶

type CurrencyItem struct {
	CurrencyName   string `json:"currencyName"`
	CurrencySymbol string `json:"currencySymbol"`
	ID             string `json:"ID"`
}

CurrencyItem stores variables related to the currency response

type Error ¶

type Error struct {
	Status int    `json:"status"`
	Error  string `json:"error"`
}

Error stores the error message

Source Files ¶

View all Source files

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL