coderoll/xtb-api-client

XTB API 客户端

0.2.1 2022-10-12 17:37 UTC

This package is auto-updated.

Last update: 2024-09-12 21:47:24 UTC


README

PHP 库,用于使用 X-Trade Broker websocket API。

注意:此项目仍在开发中!

目前仅提供以下命令

  • 获取符号
  • 获取交易
  • 登录
  • 登出
  • 交易事务
  • 交易事务状态

还缺少错误处理。

安装

composer require coderoll/xtb-api-client

您还需要 WebSocket 客户端。建议使用

composer require textalk/websocket

示例

<?php

require_once 'vendor/autoload.php';

use Coderoll\XtbApiClient\Payload\GetTrades;
use Coderoll\XtbApiClient\Payload\Login;
use Coderoll\XtbApiClient\Payload\Logout;
use Coderoll\XtbApiClient\Response\GetTradesResponse;
use Coderoll\XtbApiClient\Response\LoginResponse;
use Coderoll\XtbApiClient\Response\LogoutResponse;

// Create WebSocket client for demo
// For real account use: wss://ws.xtb.com/real
$client = new WebSocket\Client("wss://ws.xtb.com/demo");

// Prepare and send login credentials
$login = new Login('[ACCOUNT ID]', '[ACCOUNT PASSWORD]');
$client->text($login);

// Get Login response
$loginResponse = LoginResponse::createFromJson($client->receive());

// GetTrades command
$getTrades = new GetTrades(true);
$client->text($getTrades);

// var_dump of GetTrades data
$getTradesResponse = GetTradesResponse::createFromJson($client->receive());
var_dump($getTradesResponse->getReturnData());

// TradeTransaction command
$tradeTransInfo = new TradeTransInfo();
$tradeTransInfo
    ->setCmd(TradeTransInfo::CMD_BUY)
    ->setSymbol('EURUSD')
    ->setVolume(0.01)
    ->setPrice(0.01) // I think it's ignored on CMD_BUY
;
$tradeTransaction = new TradeTransaction($tradeTransInfo);
$client->text($tradeTransaction);
$tradeTransactionResponse = TradeTransactionResponse::createFromJson($client->receive());
var_dump($tradeTransactionResponse);

// Logout
$logout = new Logout();
$client->text($logout);
$logoutResponse = LogoutResponse::createFromJson($client->receive());

// If connection can't be closed by XTB, it can to be closed by client
if ($logoutResponse->isStatus() === false) {
    $client->close();
}