{"id":18259982,"url":"https://github.com/hungrybluedev/v_currency_api","last_synced_at":"2026-01-24T14:43:04.652Z","repository":{"id":224384737,"uuid":"763124257","full_name":"hungrybluedev/v_currency_api","owner":"hungrybluedev","description":"Wrapper for the free API for freecurrencyapi.com in the V Programming Language.","archived":false,"fork":false,"pushed_at":"2024-04-28T10:11:51.000Z","size":16,"stargazers_count":4,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-02-14T18:36:24.327Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"V","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/hungrybluedev.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":"2024-02-25T16:14:34.000Z","updated_at":"2024-12-19T03:28:13.000Z","dependencies_parsed_at":null,"dependency_job_id":"67046c20-ba2f-45ec-8eb1-259913aad03a","html_url":"https://github.com/hungrybluedev/v_currency_api","commit_stats":null,"previous_names":["hungrybluedev/freecurrencyapi_v","hungrybluedev/v_currency_api"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hungrybluedev%2Fv_currency_api","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hungrybluedev%2Fv_currency_api/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hungrybluedev%2Fv_currency_api/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hungrybluedev%2Fv_currency_api/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hungrybluedev","download_url":"https://codeload.github.com/hungrybluedev/v_currency_api/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247947825,"owners_count":21023058,"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":[],"created_at":"2024-11-05T10:41:23.569Z","updated_at":"2026-01-24T14:43:04.618Z","avatar_url":"https://github.com/hungrybluedev.png","language":"V","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Free Currency Converter API for V\n\n## Overview\n\nThis project is a wrapper for the HTTP API provided by [Free Currency Converter API](https://freecurrencyapi.com/). It provides a simple way to access the API using V.\n\n\u003e [!NOTE]\n\u003e An API key is required to use the API. It is free to sign\n\u003e up and at the time of writing, the free tier allows for 5000 requests per month.\n\n## Installation\n\nThis package can be installed using the V package manager.\n\n```bash\nv install https://github.com/hungrybluedev/v_currency_api\n```\n\n## Usage\n\n```v\nimport v_currency_api\n\nfn main() {\n\tclient := v_currency_api.APIClient{\n\t\tapi_key: '\u003cYOUR API KEY\u003e'\n\t}\n\n\tstatus := client.get_status() or { panic('Failed to get status with error:\\n${err}') }\n\n\tprintln(status)\n\n\tmonthly_quota := status.quotas['month'] or { panic('Failed to get monthly quota') }\n\n\tif monthly_quota.remaining \u003c= 0 {\n\t\tpanic('Monthly quota exhausted.')\n\t}\n\n\tcurrencies := client.get_currencies() or {\n\t\tpanic('Failed to get currencies with error:\\n${err}')\n\t}\n\n\tprintln('Currencies retrieved successfully:\\n')\n\tfor key, value in currencies {\n\t\tprintln('${key}:\\n${value}\\n')\n\t}\n\n\trates := client.get_latest(base_currency: 'GBP', currencies: ['INR', 'USD', 'EUR']) or {\n\t\tpanic('Failed to get latest rates with error:\\n${err}')\n\t}\n\tprintln('Latest rates retrieved successfully:\\n${rates}')\n}\n```\n\nThe output for this would be something like:\n\n```\nv_currency_api.APIStatus{\n    account_id: '\u003cYOUR ACCOUNT ID\u003e'\n    quotas: {'month': v_currency_api.APIQuota{\n        total: 5000\n        used: 19\n        remaining: 4981\n    }, 'grace': v_currency_api.APIQuota{\n        total: 0\n        used: 0\n        remaining: 0\n    }}\n}\nCurrencies retrieved successfully:\n\nEUR:\nv_currency_api.CurrencyInfo{\n    symbol: '€'\n    name: 'Euro'\n    symbol_native: '€'\n    decimal_digits: 2\n    rounding: 0\n    code: 'EUR'\n    name_plural: 'Euros'\n    currency_type: 'fiat'\n}\n\nUSD:\nv_currency_api.CurrencyInfo{\n    symbol: '$'\n    name: 'US Dollar'\n    symbol_native: '$'\n    decimal_digits: 2\n    rounding: 0\n    code: 'USD'\n    name_plural: 'US dollars'\n    currency_type: 'fiat'\n}\n\nJPY:\nv_currency_api.CurrencyInfo{\n    symbol: '¥'\n    name: 'Japanese Yen'\n    symbol_native: '￥'\n    decimal_digits: 0\n    rounding: 0\n    code: 'JPY'\n    name_plural: 'Japanese yen'\n    currency_type: 'fiat'\n}\n\n...\n\nZAR:\nv_currency_api.CurrencyInfo{\n    symbol: 'R'\n    name: 'South African Rand'\n    symbol_native: 'R'\n    decimal_digits: 2\n    rounding: 0\n    code: 'ZAR'\n    name_plural: 'South African rand'\n    currency_type: 'fiat'\n}\n\nLatest rates retrieved successfully:\n[v_currency_api.ExchangeRatePair{\n    stamp: 2024-02-25 17:40:59\n    base_currency: 'GBP'\n    quote_currency: 'EUR'\n    rate: 1.170789869\n}, v_currency_api.ExchangeRatePair{\n    stamp: 2024-02-25 17:40:59\n    base_currency: 'GBP'\n    quote_currency: 'INR'\n    rate: 104.963237776\n}, v_currency_api.ExchangeRatePair{\n    stamp: 2024-02-25 17:40:59\n    base_currency: 'GBP'\n    quote_currency: 'USD'\n    rate: 1.267362721\n}]\n```\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## Support\n\nIf you have any urgent requests or need commercial support,\nplease book a call with me.\n\n[![Book a call](https://img.shields.io/badge/Book%20a%20call-Consulting-blue?style=for-the-badge)](https://tidycal.com/hungrybluedev)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhungrybluedev%2Fv_currency_api","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhungrybluedev%2Fv_currency_api","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhungrybluedev%2Fv_currency_api/lists"}