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

# Finance::Quote::TwelveData(3pm)

Obtain quotes from https://twelvedata.com

## NAME

Finance::Quote::TwelveData - Obtain quotes from https://twelvedata.com

## SYNOPSIS

```
    use Finance::Quote;

    $q = Finance::Quote->new('TwelveData', twelvedata => {API_KEY => 'your-twelvedata-api-key'});
    %info = $q->fetch('twelvedata', 'IBM', 'AAPL');
```

## DESCRIPTION

This module fetches information from https://twelvedata.com.

This module is loaded by default on a Finance::Quote object. It's also possible to load it explicitly by placing "TwelveData" in the argument list to Finance::Quote-\>**new()**.

This module provides the "twelvedata" fetch method.

## API\_KEY

https://twelvedata.com requires users to register and obtain an API key, which is a secret value written in hexidecimal.

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

### FREE KEY LIMITS

The TwelveData free key limits usage to:

- 800 queries per day

  - 8 queries per minute

  ## LABELS RETURNED

The following labels may be returned by Finance::Quote::TwelveData :\
     symbol name exchange currency isodate currency open high low close last