Twelve Data API client library for PHP

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',
    ],
);

Batch Requests

Execute multiple API calls in a single HTTP request using the batch endpoint:

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

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

// Build requests without executing them
$requests = [
    'ts'   => $twelveData->coreData->timeSeriesRequest(symbol: 'AAPL', interval: IntervalEnum::OneMinute),
    'q'    => $twelveData->coreData->quoteRequest(symbol: 'TSLA'),
    'rate' => $twelveData->currencies->exchangeRateRequest(symbol: 'USD/EUR'),
];

// Execute all requests in a single batch call
$response = $twelveData->executeBatch($requests);

// Retrieve typed results
$timeSeries  = $response->get('ts');   // TimeSeries
$quote       = $response->get('q');    // Quote
$exchangeRate = $response->get('rate'); // ExchangeRate

// Check for per-request errors
if ($response->isError('ts')) {
    $error = $response->getError('ts'); // BatchItemError
}

Every API method has a *Request() companion (e.g. timeSeries() → timeSeriesRequest()) that returns a BatchableRequest which can be passed to executeBatch().

WebSocket Real-time Price

Stream real-time price updates via WebSocket. The library ships with a built-in adapter for phrity/websocket:

composer require phrity/websocket

use MarekSkopal\TwelveData\TwelveData;
use MarekSkopal\TwelveData\Config\Config;
use MarekSkopal\TwelveData\Dto\WebSocket\PriceEvent;
use MarekSkopal\TwelveData\WebSocket\PhrityWebSocketClient;

$twelveData = new TwelveData(new Config(apiKey: '<yourApiKey>'));
$realTimePrice = $twelveData->createRealTimePrice(new PhrityWebSocketClient());

$realTimePrice->connect();
$realTimePrice->subscribe(['AAPL', 'EUR/USD', 'BTC/USD']);

while ($realTimePrice->isConnected()) {
    $event = $realTimePrice->receive();

    if ($event instanceof PriceEvent) {
        echo "{$event->symbol}: {$event->price}\n";
    }
}

$realTimePrice->disconnect();

You can also use any other WebSocket library by implementing WebSocketClientInterface.

Covered endpoints

Core Data

• Time Series ✅
• Time Series Cross ✅
• Quote ✅
• Latest Price ✅
• End 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 ✅
• Market Capitalization ✅
• Press Releases ✅
• Last changes ✅

Currencies

• Exchange Rate ✅
• Currency Conversion ✅

ETFs

• ETFs Directory ✅
• ETF Full Data ✅
• Summary ✅
• Performance ✅
• Risk ✅
• Composition ✅
• ETFs Families ✅
• ETFs Types ✅

Mutual Funds

• MFs Directory ✅
• MF Full Data ✅
• Summary ✅
• Performance ✅
• Risk ✅
• Ratings ✅
• Composition ✅
• Purchase Info ✅
• Sustainability ✅
• MFs Families ✅
• MFs Types ✅

Technical Indicators

Overlap studies

• Bollinger bands ✅
• Double exponential moving average ✅
• Exponential moving average ✅
• 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 ✅
• 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 ✅
• 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 ✅
• Moving average convergence divergence slope ✅
• Moving average convergence divergence extension ✅
• Money flow index ✅
• Minus directional indicator ✅
• Minus directional movement ✅
• Momentum ✅
• Percent B ✅
• 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 ✅
• Stochastic oscillator ✅
• 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

• Batch Requests ✅
• Usage ✅

WebSocket

• Real-time Price ✅

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.