{"id":15034784,"url":"https://github.com/d6o/gocurrency","last_synced_at":"2026-05-20T05:13:55.000Z","repository":{"id":57486869,"uuid":"85462424","full_name":"d6o/GoCurrency","owner":"d6o","description":"Simple currency converter. Insert an amount, what currency to convert from and what currency to convert to.","archived":true,"fork":false,"pushed_at":"2023-05-17T16:57:33.000Z","size":12,"stargazers_count":31,"open_issues_count":2,"forks_count":7,"subscribers_count":1,"default_branch":"master","last_synced_at":"2024-09-29T21:21:26.537Z","etag":null,"topics":["currencies","currency","currency-api","currency-conversion","currency-converter","go","golang","golang-examples","golang-library","golang-package","golang-sdk","golang-tools","golang-wrapper"],"latest_commit_sha":null,"homepage":"https://disiqueira.github.io/GoCurrency/","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/d6o.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2017-03-19T08:48:40.000Z","updated_at":"2024-07-22T05:03:53.000Z","dependencies_parsed_at":"2024-06-19T00:20:31.394Z","dependency_job_id":"7bc99518-5fb3-42f0-8d60-c51ad84aeaf7","html_url":"https://github.com/d6o/GoCurrency","commit_stats":null,"previous_names":["disiqueira/gocurrency"],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/d6o%2FGoCurrency","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/d6o%2FGoCurrency/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/d6o%2FGoCurrency/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/d6o%2FGoCurrency/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/d6o","download_url":"https://codeload.github.com/d6o/GoCurrency/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":235212731,"owners_count":18953660,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["currencies","currency","currency-api","currency-conversion","currency-converter","go","golang","golang-examples","golang-library","golang-package","golang-sdk","golang-tools","golang-wrapper"],"created_at":"2024-09-24T20:26:19.840Z","updated_at":"2025-10-04T02:31:01.551Z","avatar_url":"https://github.com/d6o.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ![GoCurrency](http://image.prntscr.com/image/e1498265eef040bc956e388c35d8f93a.png)\n\n# GoCurrency ![Language Badge](https://img.shields.io/badge/Language-Go-blue.svg) ![Go Report](https://goreportcard.com/badge/github.com/DiSiqueira/GoCurrency) ![License Badge](https://img.shields.io/badge/License-MIT-blue.svg) ![Status Badge](https://img.shields.io/badge/Status-Beta-brightgreen.svg)\n\nGoCurrency is a Go program made on the top of Kund Nu Currency Converter API.\n\nThe GoCurrency's goal is to be a perfect tool providing a stupidly easy-to-use and fast program to convert values between currencies.\n\n**Table of Contents**\n\n- [Demo](#demo)\n- [Project Status](#project-status)\n- [Features](#features)\n- [Installation](#installation)\n- [Available Currencies](#available-currencies)\n- [Usage](#usage)\n  - [Get all available currencies](#get-all-available-currencies)\n  - [Convert 100 USD to all currencies](#convert-100-USD-to-all-currencies)\n- [Contributing](#contributing)\n  - [Bug Reports \u0026 Feature Requests](#bug-reports--feature-requests)\n  - [Developing](#developing)\n- [Social Coding](#social-coding)\n- [License](#license)\n\n## Demo\n\n[![asciicast](http://image.prntscr.com/image/2f33d4153f794d15bd95d2d533adab98.png)](https://asciinema.org/a/107878?t=10)\n\n## Project Status\n\nGoCurrency is on beta. Pull Requests [are welcome](https://github.com/DiSiqueira/GoCurrency#social-coding)\n\n## Features\n\n- Open source - You can check out our code\n- Secure\n- Always up-to-date\n- Use decimal type\n- 100% satisfaction guaranteed\n- It's perfect to convert amounts between currencies\n- STUPIDLY [EASY TO USE](https://github.com/DiSiqueira/GoCurrency#usage)\n- Very fast start up and response time\n- Uses native libs\n\n## Installation\n\n### Option 1: Go Get\n\n```bash\n$ go get github.com/disiqueira/gocurrency\n```\n\n## Available Currencies\n\n- ATS Austria, shilling\n- AUD Australian, dollar\n- BEF Belgien, franc\n- BRL Brazilien, real\n- CAD Canada, dollar\n- CHF Switzerland, francs\n- CNY China, yuan renminbi\n- CYP Cyprus, pound\n- CZK Czech Republic, koruna\n- DEM Germany, mark\n- DKK Denmark, krone\n- EEK Estonian, kroon\n- ESP Spain, pesetas\n- EUR Euroland, euro\n- FIM Finland, marka\n- FRF France, franc\n- GBP Great Britain, pound\n- GRD Greece, drachmer\n- HKD Hong Kong, dollar\n- HUF Hungary, forint\n- IDR Indonesia, rupiah\n- IEP Ireland, pund\n- INR India, rupee\n- ISK Iceland, kronor\n- ITL Italy, lire\n- JPY Japan, yen\n- KRW South Korea, won\n- KWD Kuwait, dinar\n- LTL Lithuania,  litas\n- LVL Latvia, lat\n- MAD Morocko, dirham\n- MXN Mexico, nuevo peso\n- MYR Malaysia, ringgit\n- NLG Dutchland, guilder\n- NOK Norway, krone\n- NZD New Zealand, dollar\n- PLN Poland, zloty\n- PTE Portugal, escudo\n- RUB Russia, rouble\n- SAR Saudi Arabia, riyal\n- SEK Sweden, kronor\n- SGD Singapore, dollar\n- SIT Slovenia, tolar\n- SKK Slovakia, koruna\n- THB Thailand, baht\n- TRL Turkey, lira\n- TRY Turkey, new lira\n- USD US, dollar\n- ZAR South Africa, rand\n\n## Usage\n\n### Get all available currencies\n\n```golang\npackage main\n\nimport (\n\t\"fmt\"\n\n\t\"github.com/disiqueira/gocurrency\"\n)\n\nfunc main() {\n\tcurList, _ := gocurrency.AvailableCurrencies()\n\n\tfor _, currency := range curList {\n\t\tfmt.Println(currency.Description)\n\t}\n}\n```\n\nOutput:\n```\nSEK Sweden, kronor\nATS Austria, shilling\nAUD Australian, dollar\nBEF Belgien, franc\nBRL Brazilien, real\nCAD Canada, dollar\nCHF Switzerland, francs\nCNY China, yuan renminbi\nCYP Cyprus, pound\nCZK Czech Republic, koruna\nDEM Germany, mark\nDKK Denmark, krone\nEEK Estonian, kroon\nESP Spain, pesetas\nEUR Euroland, euro\nFIM Finland, marka\nFRF France, franc\nGBP Great Britain, pound\nGRD Greece, drachmer\nHKD Hong Kong, dollar\nHUF Hungary, forint\nIDR Indonesia, rupiah\nIEP Ireland, pund\nINR India, rupee\nISK Iceland, kronor\nITL Italy, lire\nJPY Japan, yen\nKRW South Korea, won\nKWD Kuwait, dinar\nLTL Lithuania,  litas\nLVL Latvia, lat\nMAD Morocko, dirham\nMXN Mexico, nuevo peso\nMYR Malaysia, ringgit\nNLG Dutchland, guilder\nNOK Norway, krone\nNZD New Zealand, dollar\nPLN Poland, zloty\nPTE Portugal, escudo\nRUB Russia, rouble\nSAR Saudi Arabia, riyal\nSGD Singapore, dollar\nSIT Slovenia, tolar\nSKK Slovakia, koruna\nTHB Thailand, baht\nTRL Turkey, lira\nTRY Turkey, new lira\nUSD US, dollar\nZAR South Africa, rand\n```\n\n### Convert 100 USD to all currencies\n\n```golang\npackage main\n\nimport (\n\t\"fmt\"\n        \"strconv\"\n\n\t\"github.com/disiqueira/gocurrency\"\n\t\"github.com/shopspring/decimal\"\n)\n\nfunc main() {\n\tcurList, _ := gocurrency.AvailableCurrencies()\n\n\tdollar := gocurrency.NewCurrency(\"USD\")\n        amount := decimal.NewFromFloat(100.00)\n\n\tfor _, currency := range curList {\n\t\tconv, _ := gocurrency.ConvertCurrency(dollar, currency, amount)\n\n\t\tfmt.Printf(\"%-3s %-8s --\u003e %-3s %s\\n\", dollar.ID, amount, currency.ID, conv)\n\t}\n}\n```\n\nOutput:\n```\nUSD 100.00 --\u003e SEK 881.12\nUSD 100.00 --\u003e ATS 1334.36\nUSD 100.00 --\u003e AUD 130.28\nUSD 100.00 --\u003e BEF 3911.85\nUSD 100.00 --\u003e BRL 312.07\nUSD 100.00 --\u003e CAD 133.35\nUSD 100.00 --\u003e CHF 99.59\nUSD 100.00 --\u003e CNY 690.75\nUSD 100.00 --\u003e CYP 54.42\nUSD 100.00 --\u003e CZK 2509.74\nUSD 100.00 --\u003e DEM 189.66\nUSD 100.00 --\u003e DKK 690.54\nUSD 100.00 --\u003e EEK 1531.05\nUSD 100.00 --\u003e ESP 16134.77\nUSD 100.00 --\u003e EUR 92.88\nUSD 100.00 --\u003e FIM 576.57\nUSD 100.00 --\u003e FRF 636.10\nUSD 100.00 --\u003e GBP 80.95\nUSD 100.00 --\u003e GRD 33042.83\nUSD 100.00 --\u003e HKD 776.45\nUSD 100.00 --\u003e HUF 28765.63\nUSD 100.00 --\u003e IDR 1333010.59\nUSD 100.00 --\u003e IEP 76.37\nUSD 100.00 --\u003e INR 6553.27\nUSD 100.00 --\u003e ISK 10876.95\nUSD 100.00 --\u003e ITL 187751.97\nUSD 100.00 --\u003e JPY 11334.92\nUSD 100.00 --\u003e KRW 113239.94\nUSD 100.00 --\u003e KWD 37.74\nUSD 100.00 --\u003e LTL 319.77\nUSD 100.00 --\u003e LVL 69.22\nUSD 100.00 --\u003e MAD 999.46\nUSD 100.00 --\u003e MXN 1924.26\nUSD 100.00 --\u003e MYR 489.51\nUSD 100.00 --\u003e NLG 213.70\nUSD 100.00 --\u003e NOK 848.16\nUSD 100.00 --\u003e NZD 143.12\nUSD 100.00 --\u003e PLN 399.87\nUSD 100.00 --\u003e PTE 19441.33\nUSD 100.00 --\u003e RUB 5790.71\nUSD 100.00 --\u003e SAR 375.02\nUSD 100.00 --\u003e SGD 140.29\nUSD 100.00 --\u003e SIT 23310.05\nUSD 100.00 --\u003e SKK 0.00\nUSD 100.00 --\u003e THB 3490.97\nUSD 100.00 --\u003e TRL 176224000.00\nUSD 100.00 --\u003e TRY 360.64\nUSD 100.00 --\u003e USD 100.00\nUSD 100.00 --\u003e ZAR 1277.17\n```\n\n## Contributing\n\n### Bug Reports \u0026 Feature Requests\n\nPlease use the [issue tracker](https://github.com/DiSiqueira/GoCurrency/issues) to report any bugs or file feature requests.\n\n### Developing\n\nPRs are welcome. To begin developing, do this:\n\n```bash\n$ git clone https://github.com/disiqueira/gocurrency.git gocurrency\n$ cd gocurrency/\n$ go get -v -d \n```\n\n## Social Coding\n\n1. Create an issue to discuss about your idea\n2. [Fork it] (https://github.com/DiSiqueira/GoCurrency/fork)\n3. Create your feature branch (`git checkout -b my-new-feature`)\n4. Commit your changes (`git commit -am 'Add some feature'`)\n5. Push to the branch (`git push origin my-new-feature`)\n6. Create a new Pull Request\n7. Profit! :white_check_mark:\n\n## License\n\nThe MIT License (MIT)\n\nCopyright (c) 2013-2017 Diego Siqueira\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in\nall copies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\nTHE SOFTWARE.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fd6o%2Fgocurrency","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fd6o%2Fgocurrency","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fd6o%2Fgocurrency/lists"}