radicalloop/eodhistoricaldata

Wrapper for eodhistoricaldata.com

8.0.1 2024-10-15 10:14 UTC

Requires

• guzzlehttp/guzzle: ^7.0.1
• illuminate/contracts: ^8.0|^9.0|^10.0|^11.0
• illuminate/support: ^8.0|^9.0|^10.0|^11.0

Requires (Dev)

• ext-json: *
• mikey179/vfsstream: ^1.6
• phpunit/phpunit: ^10.0
• vlucas/phpdotenv: ^5.6

MIT

• Jignesh Solanki

README

Installation

To install this package via the composer require command:

$ composer require radicalloop/eodhistoricaldata

## Laravel
No configuration required for Laravel >= 5.5+, It will use the auto-discovery function.

In Laravel <= 5.4 (or if you are not using auto-discovery) register the service provider by adding it to the `providers` key in `config/app.php`. Also register the facade by adding it to the `aliases` key in `config/app.php`.

```php
'providers' => [
    ...
    RadicalLoop\Eod\EodServiceProvider::class,
],

'aliases' => [
    ...
    'Eod' => RadicalLoop\Eod\Facades\Eod::class,
]

Configuration

To get started, you'll need to publish all vendor assets:

$ php artisan vendor:publish --provider="RadicalLoop\Eod\EodServiceProvider"

This will create a config/eod.php file in your app that you can modify to set your configuration.

Set your Eod historical data API token in the file:

return [
    'api_token' => 'put your token here'
];

Usage

Here you can see an example of just how simple this package is to use.

Stocks API

use Eod;

$stock = Eod::stock();

// JSON 
$stock->realTime('AAPL.US')->json();
$stock->eod('AAPL.US')->json();

// Download CSV 
$stock->realTime('AAPL.US' ['s' => ['VTI','EUR','FX']])->download();
$stock->eod('AAPL.US')->download();

// Save CSV to specific path
$stock->realTime('AAPL.US')->save('path/to/save/csv/stock.csv');

// For other parameters, for ex. dividend api with other params
$stock->dividend('AAPL.US', ['from' => '2017-01-01'])->json();

To check other Stock API usages, refer Test Cases here.

Exchanges API

use Eod;

$exchange = Eod::exchange();

// JSON 
$exchange->symbol('US')->json();
$exchange->multipleTicker('US')->json();
$exchange->details('US')->json();

// Download CSV 
$exchange->symbol('US')->download();
$exchange->multipleTicker('US')->download();

// Save CSV to specific path
$exchange->symbol('US')->save('path/to/save/csv/stock.csv');

To check other Exchanges API usages, refer Test Cases here.

PHP

For PHP you can create an object like below.

use RadicalLoop\Eod\Config;
use RadicalLoop\Eod\Eod;

$stock    = (new Eod(new Config($apiToken)))->stock();
$exchange = (new Eod(new Config($apiToken)))->exchange();

Support

Contact: www.radicalloop.com — [e-mail]