README

这些库可以通过单一多态编织来找到最佳汇率并进行交易。

以下方法适用于Poloniex、Bittrex（经典交易所）、Shapeshift、Changer、Changelly、Nexchange、Changenow（即时交易所）。

• getEstimateAmount(AmountInterface $amount, CoinInterface $coin2) : AmountInterface;
• makeDepositAddress(string $clientAddress, AmountInterface $amount, CoinInterface $coin2) : array;
• getExchangeStatus(Status $status) : ?int;
• getMinAmount(CoinInterface $coin, CoinInterface $coin2) : ?int;
• getMaxAmount(CoinInterface $coin, CoinInterface $coin2) : ?int;

以下方法适用于Poloniex和Bittrex（Bitfinex即将推出）等经典交易所。

• exchange(AmountInterface $amount, CoinInterface $coin2);
• buy(string $market, $amount, $rate);
• sell(string $market, $amount, $rate);
• getOrderBook(string $market);
• getMarkets() : array;
• getBalances() : array;
• getOrder(string $id, $market = '') : ?array;
• getBestMake(string $market, $rate, string $direction);
• isMakeBest(string $market, $rate, string $direction) : bool;
• isMakeBroken($orderId, $amount, $market = '') : bool;
• cancelOrder($orderId, $market = '') : bool;
• activeOrderExists($orderId, string $market) : bool;
• getMyActiveOrders(string $market) : array;
• getOrders(string $market) : array;
• getRates(string $market) : array;
• checkDeposit(AmountInterface $amount, int $time);
• checkWithdraw(AmountInterface $amount, $address, int $time);
• checkWithdrawById($id, $coin = null);
• getMinConfirmations(CoinInterface $coin) : ?int;
• getWithdrawalFee(CoinInterface $coin) : ?float;

安装

composer require coinmonkey/exchangers-api @dev

请注意，库处于开发中。不要在生产项目中使用。

生产版本即将推出。

示例

<?php
use \coinmonkey\exchangers\ExchangerFabric;
use \coinmonkey\entities\Coin;
use \coinmonkey\entities\Amount;

$instantExchangers = ['shapeshift', 'changer', 'changelly', 'bittrex', 'poloniex']; //Fabric support these instant exchangers
$exchangers = ['bittrex', 'poloniex']; //Fabric support these exchangers

//Creating fabric with your config
$config = [
    'CHANGER_API_NAME' => env('CHANGER_API_NAME'),
    'CHANGER_API_KEY' => env('CHANGER_API_KEY'),
    'CHANGER_API_SECURE' => env('CHANGER_API_SECURE'),
    'CHANGER_API_NAME' => env('CHANGER_API_NAME'),
    'CHANGER_API_KEY' => env('CHANGER_API_KEY'),
    'CHANGER_API_SECURE' => env('CHANGER_API_SECURE'),
    'CHANGELLY_API_KEY' => env('CHANGELLY_API_KEY'),
    'CHANGELLY_API_SECRET' => env('CHANGELLY_API_SECRET'),
    'SHAPESHIFT_API_KEY' => env('SHAPESHIFT_API_KEY'),
    'SHAPESHIFT_API_SECRET' => env('SHAPESHIFT_API_SECRET'),
    'POLONIEX_API_KEY' => env('POLONIEX_API_KEY'),
    'POLONIEX_API_SECRET' => env('POLONIEX_API_SECRET'),
    'BITTREX_API_KEY' => env('BITTREX_API_KEY'),
    'BITTREX_API_SECRET' => env('BITTREX_API_SECRET'),
    'CHANGENOW_API_KEY' => env('CHANGENOW_API_KEY'),
    'CHANGENOW_API_SECRET' => env('CHANGENOW_API_SECRET'),
];
$fabric = new ExchangerFabric($config);

$coin1 = new Coin('ETH', 'Ether'); //This coin we want to exchange...
$coin2 = new Coin('BTC', 'Bitcoin'); //To this coin
$amount = new Amount(1.3, $coin1); //Creating 1.3 amount of $coin1 for exchanging

//Working with instant exchangers (classic exchangers can work in this mode too)
foreach($instantExchangers as $exchangerName) {
    //Creating exchanger instance by name
    $exchanger = $fabric->buildInstant($exchangerName);
    $estimateAmount = $exchanger->getEstimateAmount($amount, $coin2)->getAmount();
    echo "* $exchangerName estimate is " . $estimateAmount . "\n";
    //If it's OK you can call $order = $exchanger->makeDepositAddress('1JBPkwCuTpwcyEbhBkAKdTfU9K1zRLX5Ym', $amount, $coin2)
    //And check status later by  $exchanger->getStatus($order['id']);
}

//Working with classic exchangers
foreach($exchangers as $exchangerName) {
    $exchanger = $fabric->build($exchangerName);
    $estimateAmount = $exchanger->getEstimateAmount($amount, $coin2)->getAmount();
    echo "* $exchangerName estimate is " . $estimateAmount . "\n";
    echo " - withdrawal fee " .  $exchanger->getWithdrawalFee($coin2) . "\n";
    echo " - min coinfirmations " .  $exchanger->getMinConfirmations($coin1) . "\n";
    //If it's OK you can call $order = $exchanger->makeDepositAddress('1JBPkwCuTpwcyEbhBkAKdTfU9K1zRLX5Ym', $amount, $coin2)
    //In this case we should make CRON checker of deposit status and make exchange and withdrawal "manualy" (example will be later)
}