Finance...cyFreaks(3)

💖 Finance::Quote::CurrencyRates::CurrencyFreaks 💖

okay so bestie, welcome to the Finance::Quote::CurrencyRates::CurrencyFreaks page — it's part of the User Contributed Perl Documentation for Finance...cyFreaks(3), and honestly? it's giving "small module, big job." let's get into it 🫶

---

✨ NAME ✨

Finance::Quote::CurrencyRates::CurrencyFreaks — literally just here to obtain currency rates from CurrencyFreaks. no cap, that's the whole gig 💅

---

🌸 SYNOPSIS 🌸

here's the vibe in code form, copy it exactly bestie:

use Finance::Quote;
$q = Finance::Quote->new(currency_rates =>
    {order => ['CurrencyFreaks'], currencyfreaks => {API_KEY => ...} } );
$value = $q->currency('18.99 EUR', 'USD');

so you spin up a Finance::Quote, tell it to order CurrencyFreaks in the currency_rates hash (with a currencyfreaks hash holding your API_KEY), and then $q->currency('18.99 EUR', 'USD') does the conversion. slay 🎀

---

🦋 DESCRIPTION 🦋

this module fetches currency rates from https://currencyfreaks.com/ and feeds that data to Finance::Quote so it can convert the first argument into the equivalent value in the currency you name as the second argument. it's giving translator energy ✨

🚨 heads up: this module is not the default currency conversion module for a Finance::Quote object. you gotta ask for it, iykyk.

---

💅 API_KEY 💅

https://currencyfreaks.com/ requires users to register and obtain an API key — which is also called a token, so bestie, same thing, don't let the terminology jump-scare you 🙈

you can set that API key in either of these two iconic ways:

1. provide a currencyfreaks hash inside the currency_rates hash that you pass to Finance::Quote->new, exactly like the example up in the synopsis 👆
2. set the environment variable CURRENCYFREAKS_API_KEY 🌈

both work, pick your fighter 💜

---

🧚 Terms & Conditions 🧚

use of https://currencyfreaks.com/ is governed by any terms & conditions of that site. not ours to mess with, so go read them 🍓

Finance::Quote is released under the GNU General Public License, version 2, which explicitly carries a "No Warranty" clause. like, fr fr, no warranty — say it with me 📢

---

💀 the whole "no warranty" thing is real, not a vibe check you can skip. keep it in mind, bestie.

---

and that's the page!! mwah 💖 written by the perl docs girlies, source perl v5.32.1, dated 2026-10-26 — catch you on the next Finance...cyFreaks(3) 💫👑