tarikhagustia / laravel-mt5 Goto Github PK

View Code? Open in Web Editor NEW

27.0 8.0 27.0 113 KB

A Metatrader 5 Web API Wrapper for Laravel

PHP 100.00%

metatrader5 mt5 mt5webapi

laravel-mt5's Introduction

Laravel MT5

This is Laravel 6.x package wrapper library for Metatrader 5 Web API

Official MT5 Web Api Documentation.

Documentation

Installing

To install the package, in terminal:

composer require tarikhagustia/laravel-mt5

Configure

If you don't use auto-discovery, add the ServiceProvider to the providers array in config/app.php

Tarikhagustia\LaravelMt5\LaravelMt5Provider::class,

Copy the package config to your local config with the publish command:

php artisan vendor:publish --provider="Tarikhagustia\LaravelMt5\LaravelMt5Provider"

and then you can configure connection information to MT5 with this .env value

MT5_SERVER_IP=
MT5_SERVER_PORT=
MT5_SERVER_WEB_LOGIN=
MT5_SERVER_WEB_PASSWORD=

Usage

Create Deposit

use Tarikhagustia\LaravelMt5\Entities\Trade;
use Tarikhagustia\LaravelMt5\LaravelMt5;

$api = new LaravelMt5();
$trade = new Trade();
$trade->setLogin(6000189);
$trade->setAmount(100);
$trade->setComment("Deposit");
$trade->setType(Trade::DEAL_BALANCE);
$result = $api->trade($trade);

The result variable will return Trade class with ticket information, you can grab ticket number by calling $result->getTicket()

Create User

use Tarikhagustia\LaravelMt5\Entities\User;
use Tarikhagustia\LaravelMt5\LaravelMt5;

$api = new LaravelMt5();
$user = new User();
$user->setName("John Due");
$user->setEmail("[email protected]");
$user->setGroup("demo\demoforex");
$user->setLeverage("50");
$user->setPhone("0856123456");
$user->setAddress("Sukabumi");
$user->setCity("Sukabumi");
$user->setState("Jawa Barat");
$user->setCountry("Indonesia");
$user->setZipCode(1470);
$user->setMainPassword("Secure123");
$user->setInvestorPassword("NotSecure123");
$user->setPhonePassword("NotSecure123");

$result = $api->createUser($user);

Get Trading Account Information

use Tarikhagustia\LaravelMt5\LaravelMt5;

$api = new LaravelMt5();
$user = $api->getTradingAccounts($login);

$balance = $user->Balance;
$equity = $user->Equity;
$freeMargin = $user->MarginFree;

Get Trading History By Login Number

use Tarikhagustia\LaravelMt5\LaravelMt5;

$api = new LaravelMt5();
// Get Closed Order Total and pagination
$total = $api->getOrderHistoryTotal($exampleLogin, $timestampfrom, $timestampto);
$trades = $api->getOrderHistoryPagination($exampleLogin, $timestampfrom, $timestampto, 0, $total);
foreach ($trades as $trade) {
    // see class MTOrder
    echo "LOGIN : ".$trade->Login.PHP_EOL;
    echo "TICKET : ".$trade->Order.PHP_EOL;
}

Open Order

use Tarikhagustia\LaravelMt5\LaravelMt5;
$api = new LaravelMt5();
$api->dealerSend([
    'Login' => 8113,
    'Symbol' => 'XAUUSD',
    'Volume' => 100,
    'Type' => 0
});

The result variable will return User class with login information, you can grab login number by calling $result->getLogin()

Todo

Contributing

Thank you for considering contributing to the Laravel MT5! you can fork this repository and make pull request.

Security Vulnerabilities

If you discover a security vulnerability within Laravel MT5, please send an e-mail to Tarikh Agustia via [email protected]. All security vulnerabilities will be promptly addressed.

License

The Laravel framework is open-source software licensed under the MIT license.

laravel-mt5's People

Contributors

Stargazers

Watchers

laravel-mt5's Issues

Not enough permission in create trade user account

I follow your steps , but Not enough permission in create user,
why happen ?

need to register mt5 account by myself first and need to use this credientials in env?
why?

 public function store(Request $request)
    {
        $api = new LaravelMt5();
$user = new User();
$user->setName("John Due");
$user->setEmail("[email protected]");
$user->setGroup("demo\demoforex");
$user->setLeverage("50");
$user->setPhone("0856123456");
$user->setAddress("Sukabumi");
$user->setCity("Sukabumi");
$user->setState("Jawa Barat");
$user->setCountry("Indonesia");
$user->setZipCode(1470);
$user->setMainPassword("Secure123");
$user->setInvestorPassword("NotSecure123");
$user->setPhonePassword("NotSecure123");

$result = $api->createUser($user);


 dd($result);

can you please help me.

tarikh/php-mt5 is unavaiable and we cant install the package

Failed to execute git clone --mirror -- 'https://ghp...ebI:[email protected]/tarikhagustia/php-mt5.git' '/home/sahandi81/.cache/composer/vcs/https---gith
ub.com-tarikhagustia-php-mt5.git/'

Cloning into bare repository '/home/sahandi81/.cache/composer/vcs/https---github.com-tarikhagustia-php-mt5.git'...
remote: Repository unavailable due to DMCA takedown.
remote: See the takedown notice for more details:
remote: https://github.com/github/dmca/blob/master/2023/10/2023-10-11-metatrader.md.
fatal: unable to access 'https://github.com/tarikhagustia/php-mt5.git/': The requested URL returned error: 403

php index.php

in terminal