https://github.com/hungrybluedev/v_currency_api
Wrapper for the free API for freecurrencyapi.com in the V Programming Language.
https://github.com/hungrybluedev/v_currency_api
Last synced: 5 months ago
JSON representation
Wrapper for the free API for freecurrencyapi.com in the V Programming Language.
- Host: GitHub
- URL: https://github.com/hungrybluedev/v_currency_api
- Owner: hungrybluedev
- License: mit
- Created: 2024-02-25T16:14:34.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2024-04-28T10:11:51.000Z (about 2 years ago)
- Last Synced: 2025-02-14T18:36:24.327Z (over 1 year ago)
- Language: V
- Size: 15.6 KB
- Stars: 4
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Free Currency Converter API for V
## Overview
This 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.
> [!NOTE]
> An API key is required to use the API. It is free to sign
> up and at the time of writing, the free tier allows for 5000 requests per month.
## Installation
This package can be installed using the V package manager.
```bash
v install https://github.com/hungrybluedev/v_currency_api
```
## Usage
```v
import v_currency_api
fn main() {
client := v_currency_api.APIClient{
api_key: ''
}
status := client.get_status() or { panic('Failed to get status with error:\n${err}') }
println(status)
monthly_quota := status.quotas['month'] or { panic('Failed to get monthly quota') }
if monthly_quota.remaining <= 0 {
panic('Monthly quota exhausted.')
}
currencies := client.get_currencies() or {
panic('Failed to get currencies with error:\n${err}')
}
println('Currencies retrieved successfully:\n')
for key, value in currencies {
println('${key}:\n${value}\n')
}
rates := client.get_latest(base_currency: 'GBP', currencies: ['INR', 'USD', 'EUR']) or {
panic('Failed to get latest rates with error:\n${err}')
}
println('Latest rates retrieved successfully:\n${rates}')
}
```
The output for this would be something like:
```
v_currency_api.APIStatus{
account_id: ''
quotas: {'month': v_currency_api.APIQuota{
total: 5000
used: 19
remaining: 4981
}, 'grace': v_currency_api.APIQuota{
total: 0
used: 0
remaining: 0
}}
}
Currencies retrieved successfully:
EUR:
v_currency_api.CurrencyInfo{
symbol: '€'
name: 'Euro'
symbol_native: '€'
decimal_digits: 2
rounding: 0
code: 'EUR'
name_plural: 'Euros'
currency_type: 'fiat'
}
USD:
v_currency_api.CurrencyInfo{
symbol: '$'
name: 'US Dollar'
symbol_native: '$'
decimal_digits: 2
rounding: 0
code: 'USD'
name_plural: 'US dollars'
currency_type: 'fiat'
}
JPY:
v_currency_api.CurrencyInfo{
symbol: '¥'
name: 'Japanese Yen'
symbol_native: '￥'
decimal_digits: 0
rounding: 0
code: 'JPY'
name_plural: 'Japanese yen'
currency_type: 'fiat'
}
...
ZAR:
v_currency_api.CurrencyInfo{
symbol: 'R'
name: 'South African Rand'
symbol_native: 'R'
decimal_digits: 2
rounding: 0
code: 'ZAR'
name_plural: 'South African rand'
currency_type: 'fiat'
}
Latest rates retrieved successfully:
[v_currency_api.ExchangeRatePair{
stamp: 2024-02-25 17:40:59
base_currency: 'GBP'
quote_currency: 'EUR'
rate: 1.170789869
}, v_currency_api.ExchangeRatePair{
stamp: 2024-02-25 17:40:59
base_currency: 'GBP'
quote_currency: 'INR'
rate: 104.963237776
}, v_currency_api.ExchangeRatePair{
stamp: 2024-02-25 17:40:59
base_currency: 'GBP'
quote_currency: 'USD'
rate: 1.267362721
}]
```
## License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
## Support
If you have any urgent requests or need commercial support,
please book a call with me.
[](https://tidycal.com/hungrybluedev)