---
name: "Finance::Quote::CurrencyRates::FinanceAPI"
section: "3pm"
platform: "linux"
package: "libfinance-quote-perl"
version: "1.65-1+deb13u1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/Finance::Quote::CurrencyRates::FinanceAPI"
---

# Finance::Quote::CurrencyRates::FinanceAPI(3pm)

Obtain currency rates from https://yfapi.net/v8/finance/chart/.

## NAME

Finance::Quote::CurrencyRates::FinanceAPI - Obtain currency rates from https://yfapi.net/v8/finance/chart/.

## SYNOPSIS

```
    use Finance::Quote;

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

## DESCRIPTION

This module fetches currency rates from https://yfapi.net/v8/finance/chart/ provides data to Finance::Quote to convert the first argument to the equivalent value in the currency indicated by the second argument.

This module is not the default currency conversion module for a Finance::Quote object.

## API\_KEY

https://financeapi.net requires users to register and obtain an API key.

The API key can be set by setting the Environment variable "FINANCEAPI\_API\_KEY" or providing a 'financeapi' hash inside the 'currency\_rates' hash to Finance::Quote-\>new as in the above example.

## Terms & Conditions

Use of https://yfapi.net/v8/finance/chart/ is governed by any terms & conditions of that site.

Finance::Quote is released under the GNU General Public License, version 2, which explicitly carries a "No Warranty" clause.