README

Unofficial PHP API client library for the Twelve Data API service.

Install

composer require marekskopal/twelvedata

Usage

use MarekSkopal\TwelveData\TwelveData;
use MarekSkopal\TwelveData\Enum\IntervalEnum;

// Create TwelveData instance
$twelveData = new TwelveData('<yourApiKey>');

// Get the one minute time series for the AAPL symbol. Response is in form of strict typed DTO (Data Transfer Object)
$response = $twelveData->coreData->timeSeries(
    symbol: 'AAPL',
    interval: IntervalEnum::OneMinute,
);

// Alternatively, you can use the low level interface
$response = $twelveData->get(
    '/time_series',
    [
        'symbol' => 'AAPL',
        'interval' => '1min',
    ],
);

Covered endpoints

More endpoints will be covered in future versions.

Core Data

Time Series ✅
Time Series Cross ✅
Quote ✅
Latest Price ✅
Edd of Day Price ✅
Market Movers ✅

Reference Data

Asset Catalogs

Stocks ✅
Forex Pairs ✅
Cryptocurrency Pairs ✅
ETFs ✅
Funds ✅
Commodities ✅
Fixed Income ✅
Indices List ✅

Discovery

Symbol Search ✅
Cross listings ✅
Earliest Timestamp ✅

Markets

Exchanges ✅
Exchange schedule ✅
Cryptocurrency Exchanges ✅
Market State ✅

Supporting Metadata

Instrument Type ✅
Countries ✅
Technical Indicators ✅

Fundamentals

Logo ✅
Profile ✅
Dividends ✅
Dividends Calendar ✅
Splits ✅
Splits Calendar ✅
Earnings ✅
Earnings Calendar ✅
IPO Calendar ✅
Statistics ✅
Income Statement ✅
Income Statement Consolidated ✅
Balance Sheet ✅
Balance Sheet Consolidated ✅
Cash Flow ✅
Cash Flow Consolidated ✅
Key Executives ✅
Options Expiration ✅
Options Chain ✅
Market Capitalization ✅
Last changes ✅

Currencies

Exchange Rate ✅
Currency Conversion ✅

ETFs ❌

Mutual Funds ❌

Technical Indicators

Overlap studies

Bollinger bands ✅
High demand ✅
Double exponential moving average ✅
Exponential moving average ✅
High demand ✅
Hilbert transform instantaneous trendline ✅
Ichimoku cloud ✅
Kaufman adaptive moving average ✅
Keltner channel ✅
Moving average ✅
MESA adaptive moving average ✅
McGinley dynamic indicator ✅
Midpoint ✅
Midprice ✅
Pivot points high low ✅
Parabolic stop and reverse ✅
Parabolic stop and reverse extended ✅
Simple moving average ✅
High demand ✅
Triple exponential moving average T3MA ✅
Triple exponential moving average TEMA ✅
Triangular moving average ✅
Volume weighted average price ✅
Weighted moving average ✅

Momentum indicators

Average directional index ✅
High demand ✅
Average directional movement index rating ✅
Absolute price oscillator ✅
Aroon indicator ✅
Aroon oscillator ✅
Balance of power ✅
Commodity channel index ✅
Chande momentum oscillator ✅
Coppock curve ✅
Connors relative strength index ✅
Detrended price oscillator ✅
Directional movement index ✅
Know sure thing ✅
Moving average convergence divergence ✅
High demand ✅
Moving average convergence divergence slope ✅
Moving average convergence divergence extension ✅
Money flow index ✅
Minus directional indicator ✅
Minus directional movement ✅
Momentum ✅
Percent B ✅
High demand ✅
Plus directional indicator ✅
Plus directional movement ✅
Percentage price oscillator ✅
Rate of change ✅
Rate of change percentage ✅
Rate of change ratio ✅
Rate of change ratio 100 ✅
Relative strength index ✅
High demand ✅
Stochastic oscillator ✅
High demand ✅
Stochastic fast ✅
Stochastic relative strength index ✅
Ultimate oscillator endpoint ✅
Williams %R ✅

Volume indicators

Accumulation/distribution ✅
Accumulation/distribution oscillator ✅
On balance volume ✅
Relative volume ✅

Volatility indicators

Average true range ✅
Normalized average true range ✅
Supertrend ✅
Supertrend Heikin Ashi candles ✅
True range ✅

Price transform

Addition ✅
Average ✅
Average price ✅
Ceiling ✅
Division ✅
Exponential ✅
Floor ✅
Heikinashi candles ✅
High, low, close average ✅
Natural logarithm ✅
Base-10 logarithm ✅
Median price ✅
Multiplication ✅
Square root ✅
Subtraction ✅
Summation ✅
Typical price ✅
Weighted close price ✅

Cycle indicators

Hilbert transform dominant cycle period ✅
Hilbert transform dominant cycle phase ✅
Hilbert transform phasor components ✅
Hilbert transform sine wave ✅
Hilbert transform trend vs cycle mode ✅

Statistic functions

Beta indicator ✅
Correlation ✅
Linear regression ✅
Linear regression angle ✅
Linear regression intercept ✅
Linear regression slope ✅
Maximum ✅
Maximum Index ✅
Minimum ✅
Minimum index ✅
Minimum and maximum ✅
Minimum and maximum index ✅
Standard deviation ✅
Time series forecast ✅
Variance ✅

Analysis

Earnings Estimate ✅
Revenue Estimate ✅
EPS Trend ✅
EPS Revisions ✅
Growth Estimates ✅
Recommendations ✅
Price Target ✅
Analyst Ratings Snapshot ✅
Analyst Ratings US Equities ✅

Regulatory

EDGAR Fillings ✅
Insider Transactions ✅
Institutional Holders ✅
Fund Holders ✅
Direct Holders ✅
Tax Information ✅
Sanctioned Entities ✅

Advanced

Complex Data ❌
Usage ✅

WebSocket ❌

Notice

This is NOT an official Twelve Data library, and the authors of this library are not affiliated with Twelve Data in any way, shape or form. Twelve Data APIs and data are Copyright © 2025 Twelve Data Pte. Ltd.

Contributing

If you want to contribute, feel free to submit a pull request.

marekskopal / twelvedata

Maintainers

Details