Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/peterhellberg/fixer
Go client for the Foreign exchange rates and currency conversion API 💰
https://github.com/peterhellberg/fixer
client currencies foreign-exchange-rates go
Last synced: about 10 hours ago
JSON representation
Go client for the Foreign exchange rates and currency conversion API 💰
- Host: GitHub
- URL: https://github.com/peterhellberg/fixer
- Owner: peterhellberg
- License: mit
- Created: 2017-05-24T19:57:30.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2020-04-18T09:32:32.000Z (over 4 years ago)
- Last Synced: 2024-06-19T05:47:21.775Z (5 months ago)
- Topics: client, currencies, foreign-exchange-rates, go
- Language: Go
- Homepage: http://fixer.io/
- Size: 19.5 KB
- Stars: 18
- Watchers: 3
- Forks: 6
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# fixer
[](https://travis-ci.org/peterhellberg/fixer)
[](https://goreportcard.com/report/github.com/peterhellberg/fixer)
[](https://godoc.org/github.com/peterhellberg/fixer)
[](https://github.com/peterhellberg/fixer#license-mit)
Go client for [Fixer.io](https://fixer.io/) (Foreign exchange rates and currency conversion API)
> You need to [register](https://fixer.io/product) for a free access key if using the default Fixer API.
The default client loads its access key from the environment variable `FIXER_ACCESS_KEY`
## Installation
go get -u github.com/peterhellberg/fixer
## Usage examples
**SEK quoted against USD and EUR**
```go
package main
import (
"context"
"encoding/json"
"os"
"github.com/peterhellberg/fixer"
)
func main() {
resp, err := fixer.Latest(context.Background(),
fixer.Base(fixer.SEK),
fixer.Symbols(
fixer.USD,
fixer.EUR,
),
)
if err != nil {
return
}
encode(resp)
}
func encode(v interface{}) {
enc := json.NewEncoder(os.Stdout)
enc.SetEscapeHTML(false)
enc.SetIndent("", " ")
enc.Encode(v)
}
```
```json
{
"base": "SEK",
"date": "2017-05-24T00:00:00Z",
"rates": {
"EUR": 0.10265,
"USD": 0.1149
},
"links": {
"base": "https://api.fixer.io",
"self": "https://api.fixer.io/latest?base=SEK&symbols=EUR%2CUSD"
}
}
```
**Using the [Foreign exchange rates API](https://exchangeratesapi.io/) instead**
```go
package main
import (
"context"
"encoding/json"
"os"
"time"
"github.com/peterhellberg/fixer"
)
func main() {
f := fixer.ExratesClient
resp, err := f.At(context.Background(), time.Now(),
fixer.Base(fixer.GBP),
fixer.Symbols(
fixer.SEK,
fixer.NOK,
),
)
if err != nil {
return
}
encode(resp)
}
func encode(v interface{}) {
enc := json.NewEncoder(os.Stdout)
enc.SetEscapeHTML(false)
enc.SetIndent("", " ")
enc.Encode(v)
}
```
```json
{
"base": "GBP",
"date": "2020-04-17T00:00:00Z",
"rates": {
"NOK": 12.9739704293,
"SEK": 12.4799374554
},
"links": {
"base": "https://api.exchangeratesapi.io",
"self": "https://api.exchangeratesapi.io/2020-04-18?base=GBP&symbols=NOK%2CSEK"
}
}
```
## API documentation
## License (MIT)
Copyright (c) 2017-2020 [Peter Hellberg](https://c7.se/)
> Permission is hereby granted, free of charge, to any person obtaining
> a copy of this software and associated documentation files (the "Software"),
> to deal in the Software without restriction, including without limitation
> the rights to use, copy, modify, merge, publish, distribute, sublicense,
> and/or sell copies of the Software, and to permit persons to whom the
> Software is furnished to do so, subject to the following conditions:
>
> The above copyright notice and this permission notice shall be included
> in all copies or substantial portions of the Software.
>
> THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
> EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
> OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
> IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
> DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
> TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE
> OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.