NAME¶

Finance::Quote::CurrencyRates::TwelveData - Obtain currency rates from https://api.twelvedata.com/exchange_rate

SYNOPSIS¶

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

DESCRIPTION¶

This module fetches currency rates from https://api.twelvedata.com/exchange_rate 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. It can be utilized by setting the environment variable FQ_CURRENCY=TwelveData.

API_KEY¶

https://api.twelvedata.com/exchange_rate requires users to register and obtain an API key.

The API key can be set by setting the Environment variable "TWELVEDATA_API_KEY" or providing a 'twelvedata' hash inside the 'currency_rates' hash to Finance::Quote->new as in the above example.

Terms & Conditions¶

Use of https://api.twelvedata.com/exchange_rate 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.