Note: API v1 is deprecated and will be retired on 31st July 2026, at which point all v1 traffic will be redirected to v2. This SDK (v2.0.0+) targets API v2. If you are on an older version of this SDK, please upgrade.

CurrencyApi.net provides live currency rates via a REST API. A live currency feed for over 166 currencies, including physical (USD, GBP, EUR + more) and cryptos (Bitcoin, Litecoin, Ethereum + more). A JSON and XML currency api updated every 60 seconds.

Features:

• Live exchange rates (updated every 60 seconds).
• 166 world currencies.
• Popular cryptocurrencies included; Bitcoin, Litecoin etc.
• Convert currencies on the fly with the convert endpoint.
• Historical currency rates back to year 2000.
• OHLC (Open, High, Low, Close) candlestick data for technical analysis (Tier 3+).
• Easy to follow documentation

Signup for a free or paid account here.

Golang wrapper for CurrencyApi.net endpoints.

For an easy to following developer guide, check out our Golang Developer Guide.

Alternatively keep reading below.

• Minimum Go 1.21
• Working on Go 1.26
• Free or Paid account with CurrencyApi.net

• 100% coverage

go get github.com/houseofapis/currencyapi-go

then import the package with:

import (
    ...
	"github.com/houseofapis/currencyapi-go"
	...
)

client := currencyapi.Client("API_KEY")

params := map[string]string{
    "output": "JSON",
    "base":   "USD",
}

body, err := client.Rates(params)

Available params for rates endpoint

params := map[string]string{
    "output": "XML"
}

body, err := client.Currencies(params)

Available methods for currencies endpoint

params := map[string]string{
    "output": "JSON",
    "from": "USD",
    "to": "GBP",
    "amount": 15.99,
}

body, err := client.Convert(params)

Available methods for convert endpoint

params := map[string]string{
    "output": "JSON",
    "base": "GBP",
    "date": "2019-01-01"
}

body, err := client.History(params)

Available methods for historical endpoint

params := map[string]string{
    "output": "JSON",
    "base": "GBP",
    "start_date": "2019-01-01"
    "end_date": "2019-01-05"
}

body, err := client.Timeframe(params)

Available methods for timeframe endpoint

params := map[string]string{
    "quote":    "EUR",
    "date":     "2023-12-25",
    "interval": "1h",
}

body, err := client.Ohlc(params)

Available params for OHLC endpoint

Note: The OHLC endpoint requires a Tier 3 (Professional) subscription.