1Finance::Quote::AlphaVaUnsteargeC(o3n)tributed Perl DocuFmiennatnactei:o:nQuote::AlphaVantage(3)
2
3
4
6 Finance::Quote::AlphaVantage - Obtain quotes from https://iexcloud.io
7
9 use Finance::Quote;
10
11 $q = Finance::Quote->new('AlphaVantage', alphavantage => {API_KEY => 'your-alphavantage-api-key'});
12
13 %info = $q->fetch('alphavantage', 'IBM', 'AAPL');
14
16 This module fetches information from https://www.alphavantage.co.
17
18 This module is loaded by default on a Finance::Quote object. It's also
19 possible to load it explicitly by placing "AlphaVantage" in the
20 argument list to Finance::Quote->new().
21
22 This module provides the "alphavantage" fetch method.
23
25 https://www.alphavantage.co requires users to register and obtain an
26 API key, which is also called a token. The token is a sequence of
27 random characters.
28
29 The API key may be set by either providing a module specific hash to
30 Finance::Quote->new as in the above example, or by setting the
31 environment variable ALPHAVANTAGE_API_KEY.
32
34 The following labels may be returned by Finance::Quote::AlphaVantage :
35 symbol, open, close, high, low, last, volume, method, isodate,
36 currency.
37
39 Since the JSON returned by the GLOBAL_QUOTE API does not specify the
40 currency of the price data, there is no way to determine the correct
41 currency without an additional call to the SYMBOL_SEARCH API. To avoid
42 even slower throttling, this module expects the user to know which
43 securties from certain countries may be traded in the non-ISO4217
44 currency.
45
46 An example are London Stock Exchange traded GBP.L (Global Petroleum
47 Limited) and GBPG.L (Goldman Sachs Access UK Gilts 1-10 Years UCITS ETF
48 CLASS GBP (Dist)). GBP.L is traded in GBX, which is also known as GBp
49 (Great Britain Pence), and GBPG.L is traded in the iso-4217 currency
50 GBP (Great Britain Pounds). The user will need to add ".X" to symbols
51 to return GBX priced securities as GBP. For the example above the user
52 would use the symbol GBP.L.X in the call to the alphavantage method for
53 the prices to be output as GBP.
54
55
56
57perl v5.36.1 2023-08-13 Finance::Quote::AlphaVantage(3)