Download the PHP package kevinrider/laravel-etrade without Composer

Laravel client for the E*TRADE v1 API. This is a rewrite of phpetrade that uses Laravel conventions, Guzzle, Carbon, and complete data transfer object (DTO) coverage for E*TRADE API request and response objects.

Disclosure

This package is not affiliated with, endorsed by, or supported by E*TRADE or any of its affiliates or owners. Use at your own risk and review the E*TRADE API terms before use.

The developer is not responsible for any losses incurred from the use of this code. Laravel-etrade comes with absolutely no warranty and should not be used in actual trading unless you (the user) can read and understand the source code. Orders placed with this code (in production mode) will submit trades that will be advertised on the open market and will immediately be filled if a counterparty is present, regardless of whether you made a mistake or not. It is your responsibility to understand, test (in the sandbox), and refine your trades and the code where necessary before using in a live market environment.

Use the sandbox environment before moving to production, especially if you are going to place orders! When starting in the production environment you should create and test your trades and code. This can include submitting orders when the regular market session is closed and setting the marketSession to REGULAR. You can also submit trades with a limit price that is far below the market bid if going long or well above the ask if you are going short. Do not use priceType=MARKET trades unless you want an immediate fill on the order. MARKET trades are definitely not recommended for options, especially those on low liquidity symbols or on strike prices that are deep OTM.

Features

• Access your E*TRADE accounts within a Laravel app!
• Guzzle-powered OAuth 1.0a flow and request signing
• DTOs for request/response payloads
• Order builder for previewing and placing orders
• Encrypted token storage and management via Laravel cache
• Interactive Artisan demo against your E*TRADE account

Key files

• EtradeApiClient: Full E*TRADE API coverage
  • Authorization: request/renew/revoke access tokens
  • Accounts: list, balance, transactions, transaction details, portfolio
  • Alerts: list, details, delete
  • Market: quotes, lookup, option chains, option expirations
  • Orders: list, preview, place, change preview, place change, cancel
• EtradeOrderBuilder: Quickly and easily compose complex orders
• LaravelEtradeDemo: Interactive CLI command with extensive EtradeApiClient and EtradeOrderBuilder example usage

Requirements

• PHP 8.3+
• Laravel 10+
• Guzzle 7.10+
• E*TRADE API keys
• Configured Laravel cache driver

Installation

Install via Composer:

Publish the config file:

You should consider locking to a specific laravel-etrade version in composer.json. For example, in the composer.json require section:

will prevent updates and lock to version 1.0.0. If newer versions are released you can test and then release to your Laravel app as needed.

Configuration

The package is configured in config/laravel-etrade.php. Most likely the only variable you will change is setting production to true when you are ready to use your live E*TRADE account.

• app_key and app_secret: E*TRADE application credentials
• oauth_request_token_key: cache key for the OAuth request token
• oauth_access_token_key: cache key for the OAuth access token
• inactive_buffer_in_seconds: auto-renew token buffer
• production: true for live, false for sandbox

The default app_key and app_secret config pulls from env. This means you can either set them in your .env file:

OR

Copy the following into your .bashrc (assuming you're using bash), updating as needed for your specific config:

Don't forget to apply the bash profile changes:

When approved by E*TRADE for API access, you will be issued two sets of keys, one for production and one for the sandbox. You must copy your sandbox key and secret into ETRADE_APP_KEY and ETRADE_APP_SECRET when using the sandbox and vice versa when switching to production.

Authorization flow

The flow uses "out of band" (OOB) verification:

1. Call getAuthorizationUrl() to retrieve the login URL.
2. Log in to E*TRADE, approve the app, and copy the verifier code.
3. Paste the verifier code into requestAccessTokenAndStore().
4. The access token is stored in cache and used automatically.

Usage

EtradeApiClient

Resolve the client through the Laravel container:

EtradeOrderBuilder

Use the builder to generate preview/place order request DTOs:

Exceptions

• EtradeAuthException: thrown when tokens are missing or expired in cache.
• EtradeApiException: thrown on non-2XX responses, includes status and headers.
• Illuminate\Validation\ValidationException: thrown on incomplete/invalid request params.
• InvalidArgumentException: thrown on incomplete/invalid orders.

Examples and demo

LaravelEtradeDemo serves as a demonstration of all E*TRADE API endpoints and as EtradeApiClient and EtradeOrderBuilder example code in a variety of scenarios and trade types.

Run the interactive demo via artisan:

It walks through OAuth, read-only endpoints, and order flows with warnings before any destructive actions or placing any orders.

Be careful! LaravelEtradeDemo will place live orders if production mode is used!

Testing

If you installed with dev dependencies, the following will run all tests:

Further reading

• phpetrade: Additional notes and FAQ that may be useful.
• E*TRADE Developer: E*TRADE API documentation