# phpman > man > Finance::Quote::CurrencyRates::AlphaVantage

## NAME
    [Finance::Quote::CurrencyRates::AlphaVantage](https://www.chedong.com/phpMan.php/perldoc/Finance%3A%3AQuote%3A%3ACurrencyRates%3A%3AAlphaVantage/markdown) - Obtain currency rates from
    <https://www.alphavantage.co>

## SYNOPSIS
        use [Finance::Quote](https://www.chedong.com/phpMan.php/perldoc/Finance%3A%3AQuote/markdown);

        $q = [Finance::Quote](https://www.chedong.com/phpMan.php/perldoc/Finance%3A%3AQuote/markdown)->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](https://www.chedong.com/phpMan.php/perldoc/Finance%3A%3AQuote/markdown) 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](https://www.chedong.com/phpMan.php/perldoc/Finance%3A%3AQuote/markdown) object.

## APIKEY
    <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](https://www.chedong.com/phpMan.php/perldoc/Finance%3A%3AQuote/markdown)->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](https://www.chedong.com/phpMan.php/perldoc/Finance%3A%3AQuote/markdown) is released under the GNU General Public License, version 2, which explicitly
    carries a "No Warranty" clause.