README

Laravel implementation of the Binance Spot trading API.

Requirements

• PHP 8.1+
• Laravel 10, 11, or 12

Install

composer require adman9000/laravel-binance

Publish the config file:

php artisan vendor:publish --provider="adman9000\binance\BinanceServiceProvider"

Add your credentials to .env:

BINANCE_KEY=your-api-key
BINANCE_SECRET=your-api-secret

Usage

Via facade

use Binance;

$balances = Binance::getBalances();
$price    = Binance::getTickers('BTCUSDT');

Via dependency injection

use adman9000\binance\BinanceAPI;

class TradingService
{
    public function __construct(private BinanceAPI $binance) {}
}

Direct instantiation

$binance = new BinanceAPI([
    'auth'     => ['key' => 'your-key', 'secret' => 'your-secret'],
    'urls'     => ['api' => 'https://api.binance.com/api/', 'sapi' => 'https://api.binance.com/sapi/'],
    'settings' => ['timing' => 5000, 'timeout' => 30, 'connect_timeout' => 10],
]);

Available Methods

Public (no authentication required)

Valid $interval values: 1s, 1m, 3m, 5m, 15m, 30m, 1h, 2h, 4h, 6h, 8h, 12h, 1d, 3d, 1w, 1M

Private (API key + secret required)

Configuration

// config/binance.php
return [
    'auth' => [
        'key'    => env('BINANCE_KEY', ''),
        'secret' => env('BINANCE_SECRET', ''),
    ],
    'urls' => [
        'api'  => env('BINANCE_API_URL', 'https://api.binance.com/api/'),
        'sapi' => env('BINANCE_SAPI_URL', 'https://api.binance.com/sapi/'),
    ],
    'settings' => [
        'timing'          => env('BINANCE_TIMING', 5000),         // recvWindow in ms
        'timeout'         => env('BINANCE_TIMEOUT', 30),          // request timeout in seconds
        'connect_timeout' => env('BINANCE_CONNECT_TIMEOUT', 10),  // connection timeout in seconds
    ],
];

Testnet

To use the Binance testnet, add to your .env:

BINANCE_API_URL=https://testnet.binance.vision/api/
BINANCE_SAPI_URL=https://testnet.binance.vision/sapi/

Binance US

BINANCE_API_URL=https://api.binance.us/api/
BINANCE_SAPI_URL=https://api.binance.us/sapi/

Error handling

All API errors throw adman9000\binance\Exceptions\BinanceApiException:

use adman9000\binance\Exceptions\BinanceApiException;

try {
    $order = Binance::limitBuy('BTCUSDT', '0.001', 1.0);
} catch (BinanceApiException $e) {
    // $e->getMessage() — Binance error message
    // $e->getResponse() — full response array including error code
}

Upgrading from v1

• getTicker($symbol) is deprecated — use getTickers($symbol) instead
• getCurrencies() has been removed (it returned false)
• depositAddress($symbol) now takes a coin ticker as $coin (same value, renamed parameter)
• wapi config URL removed — replaced by sapi (https://api.binance.com/sapi/)
• ext-curl is no longer required
• Errors now throw BinanceApiException instead of \Exception

Running tests

composer install
./vendor/bin/phpunit

Licence

MIT