Finance...nanceAPI(3)

💖 Finance::Quote::CurrencyRates::FinanceAPI 💖

okay so picture this: a User Contributed Perl Documentation page (that's the manual name bestie, it's a Perl manpage fr fr) about grabbing currency rates off the internet. sit down, we're doing this together 🫶

---

✨ NAME ✨

Finance::Quote::CurrencyRates::FinanceAPI — the module that goes and gets you currency rates from https://yfapi.net/v8/finance/chart/ 👑 no cap, that's literally its whole job.

---

🌸 SYNOPSIS 🌸

okay so here's the vibe, copy-paste style:

use Finance::Quote;

$q = Finance::Quote->new(currency_rates =>
     {order => ['FinanceAPI'],
      financeapi => {API_KEY => ...}
     });

$value = $q->currency('18.99 EUR', 'USD');

like yes, that's it, that's the whole thing 💅

---

🦋 DESCRIPTION 🦋

so this module fetches currency rates from https://yfapi.net/v8/finance/chart/ and feeds that data to Finance::Quote so it can convert the first argument into the equivalent value in whatever currency the second argument names. slay. conversion icon behaviour honestly ✨

🚨 important vibe check: this module is not the default currency conversion module for a Finance::Quote object. like, it does not come pre-installed in the driver's seat, you gotta pick it yourself. iykyk.

---

🎀 API_KEY 🎀

okay bestie here's the part where you have to register 😭 https://financeapi.net requires users to register and obtain an API key. yes, an actual signup. no shortcuts, no cap.

you've got two ways to hand that key over:

• set the environment variable FINANCEAPI_API_KEY 🌈
• drop a 'financeapi' hash inside the 'currency_rates' hash you pass to Finance::Quote->new, just like the example up in the synopsis 💖

either one, your choice, both iconic.

---

💜 Terms & Conditions 💜

use of https://yfapi.net/v8/finance/chart/ is governed by any terms & conditions of that site. not our rules, their rules 🙈 read 'em.

Finance::Quote is released under the GNU General Public License, version 2, which explicitly carries a "No Warranty" clause. periodt. translate: no warranty, so don't come for us if the rates do something weird 💀

---

and that's the page!! tysm for reading, mwah 🍓

sign-off cuteness: this was perl v5.32.1, dated 2026-10-26, and the page title is Finance...nanceAPI(3) because terminal headers are dramatic like that 🧚