---
name: "Finance::Quote::CurrencyRates::AlphaVantage"
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::AlphaVantage"
---

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

Obtain currency rates from https://www.alphavantage.co

## NAME

Finance::Quote::CurrencyRates::AlphaVantage - Obtain currency rates from https://www.alphavantage.co

## SYNOPSIS

```
    use Finance::Quote;

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

## DESCRIPTION

This module fetches currency rates from https://www.alphavantage.co and 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 the default currency conversion module for a Finance::Quote object.

## API\_KEY

https://www.alphavantage.co requires users to register and obtain an API key, which is also called a token.

The API key may be set by either providing a alphavantage hash inside the currency\_rates hash to Finance::Quote-\>new as in the above example, or by setting the environment variable ALPHAVANTAGE\_API\_KEY.

## Terms & Conditions

Use of https://www.alphavantage.co 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.