Trade Copier Web API Documentation

Get a full list of your account(s) existing in your Trade Copier cockpit

URL: https://www.trade-copier.com/webservice/account/getAccounts.php
The request may specify an optional filter object containing a single account_id that you want to select, or an array of IDs. If the filter is empty or absent, it will select all your accounts.

Response: JSON object list

PHP example

<?php

echo "<link rel='stylesheet' type='text/css' href='https://www.trade-copier.com/webservice/example.css'>";

$url="https://www.trade-copier.com/webservice/account/getAccounts.php";
$headers =  array(
	'Content-Type: application/x-www-form-urlencoded',
	'Auth-Username: username',
	'Auth-Token: key',
);

// Open connection
$ch = curl_init();

// Setting the options
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_POST, false);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$filter = ['account_id' => '190792'];
//$filter = ['account_id' => ['190792', '190793']];
//$filter = [];

curl_setopt($ch, CURLOPT_POST, count($filter));
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($filter));

// Execute request
$json = json_decode(curl_exec($ch));

// Close connection
curl_close($ch);

//We access the existing account(s) list
if(array_key_exists('accounts', $json))
{
	echo '<table id="api_data">';

	foreach($json->accounts as $row) {
		foreach($row as $key => $val) {
			echo '<th>'.$key.'</th>';
		}
		break;
	}

	foreach($json->accounts as $subscription)
	{
		echo '<tr>';
		foreach($subscription as $key => $val)
		{
			echo '<td>'.$val.'</td>';
		}
		echo '</tr>';
	}

	echo '</table>';
}
else
{
	//This is an error message that can be access like this:
	//echo $json->code." ".$json->error;
	echo json_encode($json);
}

?>

Add a Master or a Slave account in your Trade Copier cockpit

URL: https://www.trade-copier.com/webservice/account/addAccount.php

Response: JSON object with the account_id unique identifier

PHP example

<?php

	$url="https://www.trade-copier.com/webservice/account/addAccount.php";
	$headers =  array(
		'Content-Type: application/x-www-form-urlencoded',
		'Auth-Username: username',
		'Auth-Token: key',
	);
	
	// Open connection
	$ch = curl_init();
	
	// Setting the options
	curl_setopt($ch, CURLOPT_URL, $url);
	curl_setopt($ch, CURLOPT_POST, true);
	curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
	curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

	//We define the Risk Factor's group, you can get the existing groups with the "getGroups.php" webservice
	$group = '2Lots';//Group's name
	//$group = '';//No group
	
	//We define the subscription for the account, you can get available subscriptions with the "getSubscriptions.php" webservice
	$subscription = 'auto';//Automaticaly select an available subscription
	//$subscription = ['name' => 'Unlimited Pack (5)', 'expiration_date' => '2019-03-10 19:10:43'];//Subscription's name and expiration_date
	//$subscription = '';//No subscription
	
		
	// Adding data to POST
	$account = [
	  'type' => 1,//0=Master, 1=Slave
	  'name' => 'name',//Custom name for your account
	  'broker' => 'ctrader',//ctrader, lmax, fxcm_fc
	  'login' => 'login12',
	  'password' => 'password',
	  'server' => 'fxpro.com',
	  'environment' => 'Demo', //Demo, Real
	  'status' => '0',//The account is 0=disabled, 1=enabled
	  'group' => $group,//Always an EMPTY string for Master
	  'subscription' => $subscription,//Always an EMPTY string for Master.
	  'pending' => '0',//0=disabled, 1=enabled
	  'stop_loss' => '0',//0=disabled, 1=enabled
	  'take_profit' => '0',//0=disabled, 1=enabled
	  'comment' => '',
	  'alert_email' => '0',//0=disabled, 1=enabled
	  'alert_sms' => '0'//0=disabled, 1=enabled
	];

	//echo http_build_query($account);
	
	curl_setopt($ch, CURLOPT_POST, count($account));
	curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($account));
			
	// Execute request
	$json = json_decode(curl_exec($ch));

	// Close connection
	curl_close($ch);

	if(array_key_exists('account', $json))
	{
		//We access the added account data
		echo "New account added: ".$json->account->account_id." ".$json->account->name.
		" ".$json->account->login." ".$json->account->server;
	}
	else
	{
		//This is an error message that can be access like this:
		//echo $json->code." ".$json->error;
		echo json_encode($json);
	}
?>
                                                        

To update a Master or Slave account of your Trade Copier cockpit

URL: https://www.trade-copier.com/webservice/account/updateAccount.php

Response: JSON object with the account_id unique identifier

Fields noted with a * are optional

PHP example

<?php

	$url="https://www.trade-copier.com/webservice/account/updateAccount.php";
	$headers =  array(
		'Content-Type: application/x-www-form-urlencoded',
		'Auth-Username: username',
		'Auth-Token: key',
	);

	// Open connection
	$ch = curl_init();

	// Setting the options
	curl_setopt($ch, CURLOPT_URL, $url);
	curl_setopt($ch, CURLOPT_POST, true);
	curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
	curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

	//If needed, we update the Risk Factor's group, you can get the existing groups with the "getGroups.php" webservice
	$group = '2Lots';//Group's name
	//$group = '';//No group
	
	//If needed, we update the subscription for the account, you can get available subscriptions with the "getSubscriptions.php" webservice
	$subscription = 'auto';//Automaticaly select an available subscription
	//$subscription = ['name' => 'Free v1', 'expiration_date' => '0000-00-00 00:00:00'];
	//$subscription = "";//NULL string to remove the subscription
	
	// Account data to be updated
	$account = [
	  'account_id' => '41613',//Mandatory
	  'name' => 'nameZZ',
	  'broker' => 'ctrader',//ctrader, lmax, fxcm_fc
	  'login' => 'login111',
	  'password' => 'password',
	  'group' => $group,
	  'subscription' => $subscription,
	  'alert_sms' => '0'
	];

	curl_setopt($ch, CURLOPT_POST, count($account));
	curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($account));
			
	// Execute request
	$json = json_decode(curl_exec($ch));

	// Close connection
	curl_close($ch);

	//We access the updated account data
	if(array_key_exists('account', $json))
	{
		//We access the added account data
		echo "Account ".$json->account->account_id." updated: ".$json->account->name." ".$json->account->login." ".$json->account->server;
	}
	else
	{
		//This is an error message that can be access like this:
		//echo $json->code." ".$json->error;
		echo json_encode($json);
	}
?>
                                                        

To delete a Master or Slave account from your Trade Copier cockpit

URL: https://www.trade-copier.com/webservice/account/deleteAccount.php

Response: JSON object with the account_id unique identifier

PHP example

<?php

	$url="https://www.trade-copier.com/webservice/account/deleteAccount.php";
	$headers =  array(
		'Content-Type: application/x-www-form-urlencoded',
		'Auth-Username: username',
		'Auth-Token: key',
	);

	// Open connection
	$ch = curl_init();

	// Setting the options
	curl_setopt($ch, CURLOPT_URL, $url);
	curl_setopt($ch, CURLOPT_POST, true);
	curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
	curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

	// Account ID to be removed
	$account = [
	  'account_id' => '41607'
	];

	curl_setopt($ch, CURLOPT_POST, count($account));
	curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($account));
			
	// Execute request
	$json = json_decode(curl_exec($ch));
	
	// Close connection
	curl_close($ch);
	
	if(array_key_exists('account', $json))
	{
		//We access the deleted account data
		echo "Account ".$json->account->account_id." has been deleted!";
	}
	else
	{
		//This is an error message that can be access like this:
		//echo $json->code." ".$json->error;
		echo json_encode($json);
	}

?>
                                                        

Get a full list of servers name that you can use based on your broker/technology

URL: https://www.trade-copier.com/webservice/account/getServersList.php
The request must contain a filter object containing the broker/technology for which you want to get the possible server name. It can be "fxcm_fc", "lmax", etc.

Response: JSON array

PHP example

<?php

	$url="https://www.trade-copier.com/webservice/account/getServersList.php";
	$headers =  array(
		'Content-Type: application/x-www-form-urlencoded',
		'Auth-Username: username',
		'Auth-Token: key',
	);

	// Open connection
	$ch = curl_init();

	// Setting the options
	curl_setopt($ch, CURLOPT_URL, $url);
	curl_setopt($ch, CURLOPT_POST, false);
	curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
	curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

	$filter = ['broker' => 'lmax'];//lmax, fxcm_fc,...

	curl_setopt($ch, CURLOPT_POST, count($filter));
	curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($filter));
	
	// Execute request
	$json = json_decode(curl_exec($ch));

	// Close connection
	curl_close($ch);

	//We access the existing account(s) list
	if(array_key_exists('servers', $json))
	{
		echo "Servers list:";
		foreach($json->servers as $server)
		{
			echo $server."";
		}
	}
	else
	{
		//This is an error message that can be access like this:
		//echo $json->code." ".$json->error;
		echo json_encode($json);
	}

?>
                                                        

Get a full list of your active subscriptions

URL: https://www.trade-copier.com/webservice/subscription/getSubscriptions_v2.php

Response: JSON object {"subscriptions":"..." }:
Example: {"subscriptions":[{"name":"Flexible Pack","available":"1","expiration_date":"2019-03-10 19:10:43"},{"name":"Free v2","available":"1","expiration_date":"0000-00-00 00:00:00"}]}

PHP example

<?php

	echo "<link rel='stylesheet' type='text/css' href='https://www.trade-copier.com/webservice/example.css'>";
	
	$url="https://www.trade-copier.com/webservice/subscription/getSubscriptions_v2.php";
	$headers =  array(
		'Content-Type: application/x-www-form-urlencoded',
		'Auth-Username: username',
		'Auth-Token: key',
	);

	// Open connection
	$ch = curl_init();

	// Setting the options
	curl_setopt($ch, CURLOPT_URL, $url);
	curl_setopt($ch, CURLOPT_POST, false);
	curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
	curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

	// Execute request
	$json = json_decode(curl_exec($ch));

	// Close connection
	curl_close($ch);
	
	//We access the existing Slaves subscription(s) list
	if(array_key_exists('subscriptions', $json))
	{
		echo '<table id="api_data">';
		
			foreach($json->subscriptions as $row) {
				foreach($row as $key => $val) {
					echo '<th>'.$key.'</th>';
				}
				break;
			}
			
			foreach($json->subscriptions as $subscription)
			{
				echo '<tr>';			
					foreach($subscription as $key => $val) 
					{
						echo '<td>'.$val.'</td>';
					}				
				echo '</tr>';
			}
		
		echo '</table>';
	}
	else
	{
		//This is an error message that can be access like this:
		//echo $json->code." ".$json->error;
		echo json_encode($json);
	}

?>
                                                        

Get a full list of your Slave/Group Settings' existing in your trade copier cockpit

URL: https://www.trade-copier.com/webservice/settings/getSettings.php
The request may specify an optional filter object containing the slave_id/group_id and/or master_id

Response: JSON object list
Repsonse is a "settingslist" array of Slave/Group Settings optionally filtered by slave_id/group_id and/or master_id

PHP example

<?php

	echo "<link rel='stylesheet' type='text/css' href='https://www.trade-copier.com/webservice/example.css'>";
	
	$url="https://www.trade-copier.com/webservice/settings/getSettings.php";
	$headers =  array(
		'Content-Type: application/x-www-form-urlencoded',
		'Auth-Username: username',
		'Auth-Token: key',
	);

	// Open connection
	$ch = curl_init();

	// Setting the options
	curl_setopt($ch, CURLOPT_URL, $url);
	curl_setopt($ch, CURLOPT_POST, false);
	curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
	curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

	// slave_id and master_id filter
	$filter = [
	  //'slave_id' => '29516',//Optional => Not defined to show the settings for all your Slaves
	  'group_id' => '3626',//Optional =>  Not defined to show the settings for all your Groups
	  //'master_id' => '',//Optional => Not defined to show the settings for all your Masters or emtpy String for settings that apply to "all your Masters"
	];

	curl_setopt($ch, CURLOPT_POST, count($filter));
	curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($filter));
	
	// Execute request
	$json = json_decode(curl_exec($ch));

	// Close connection
	curl_close($ch);
	
	//We access the existing symbolssetting(s) list
	if(array_key_exists('settingslist', $json))
	{
		echo '<table id="api_data">';
		
			foreach($json->settingslist as $row) {
				foreach($row as $key => $val) {
					echo '<th>'.$key.'</th>';
				}
				break;
			}
			
			foreach($json->settingslist as $setting)
			{
				echo '<tr>';			
					foreach($setting as $key => $val) 
					{
						echo '<td>'.$val.'</td>';
					}				
				echo '</tr>';
			}
		
		echo '</table>';
	}
	else
	{
		//This is an error message that can be access like this:
		//echo $json->code." ".$json->error;
		echo json_encode($json);
	}

?>
                                                        

Set (add, update or remove) an Slave/Group Settings' list

URL: https://www.trade-copier.com/webservice/settings/setSettings.php
request: array of Slave/Group Settings object

Response: JSON object list with success code 200

PHP example

<?php

	echo "<link rel='stylesheet' type='text/css' href='https://www.trade-copier.com/webservice/example.css'>";
	
	$url="https://www.trade-copier.com/webservice/settings/setSettings.php";
	$headers =  array(
		'Content-Type: application/x-www-form-urlencoded',
		'Auth-Username: username',
		'Auth-Token: key',
	);

	// Open connection
	$ch = curl_init();

	// Setting the options
	curl_setopt($ch, CURLOPT_URL, $url);
	curl_setopt($ch, CURLOPT_POST, false);
	curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
	curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

	// Slave/Group Settings list to be added, updated or removed
	$settings = [
	  ['slave_id' => '29524', 'master_id' => '33934', 'risk_factor_value' => '0.11', 'risk_factor_type' => '3', 'max_order_size' => '1.23', 'copier_status' => '0'],
	  ['slave_id' => '29524', 'risk_factor_value' => '0.99', 'risk_factor_type' => '4', 'max_order_size' => '0.12', 'copier_status' => '1'],
	  ['group_id' => '4735', 'risk_factor_value' => '1.02', 'risk_factor_type' => '5', 'max_order_size' => '0.12'],
	];

	curl_setopt($ch, CURLOPT_POST, count($settings));
	curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($settings));
	
	// Execute request
	$json = json_decode(curl_exec($ch));

	// Close connection
	curl_close($ch);
	
	//If updated is successful, we use the getRiskFactors webservice to check the new value
	if(array_key_exists('success', $json))
	{
		echo $json->code."-".$json->success;
	}
	else
	{
		//This is an error message that can be access like this:
		//echo $json->code." ".$json->error;
		echo json_encode($json);
	}

?>
                                                        

Get a full list of your Symbol Settings existing in your Trade Copier cockpit

URL: https://www.trade-copier.com/webservice/settings/getSymbolSettings.php
The request may specify an optional filter object containing the slave_id, group_id, master_id, symbol and/or symbol_master filters

Response: JSON object list
repsonse is a "symbolsettingslist" array of SymbolSettings optionally filtered by slave_id, group_id, master_id, symbol and/or symbol_master

PHP example

<?php
	
    echo "<link rel='stylesheet' type='text/css' href='https://www.trade-copier.com/webservice/example.css'>";
	
	$url="https://www.trade-copier.com/webservice/settings/getSymbolSettings.php";
	$headers =  array(
		'Content-Type: application/x-www-form-urlencoded',
		'Auth-Username: username',
		'Auth-Token: key',
	);
	
	// Open connection
	$ch = curl_init();

	// Setting the options
	curl_setopt($ch, CURLOPT_URL, $url);
	curl_setopt($ch, CURLOPT_POST, false);
	curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
	curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

	// slave_id, group_id, master_id, symbol and/or symbol_master filters
	$filter = [
		//'slave_id' => '29524',//Optional => Not defined to show the settings for all your Slaves
		//'group_id' => '538',//Optional =>  Not defined to show the settings for all your Groups		
		//'master_id' => '33934',//Optional => Not defined to show the settings for all your Masters or emtpy String for settings that apply to "all your Masters"	
		//'symbol' => 'XAUUSD',//Optional => Not defined for all
	    //'symbol_master' => 'GOLD',//Optional => Not defined for all
	];

	curl_setopt($ch, CURLOPT_POST, count($filter));
	curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($filter));
	
	// Execute request
	$json = json_decode(curl_exec($ch));

	// Close connection
	curl_close($ch);
	
	//We access the existing symbolssetting(s) list
	if(array_key_exists('symbolsettingslist', $json))
	{
		echo '<table id="api_data">';
		
			foreach($json->symbolsettingslist as $row) {
				foreach($row as $key => $val) {
					echo '<th>'.$key.'</th>';
				}
				break;
			}
			
			foreach($json->symbolsettingslist as $setting)
			{
				echo '<tr>';			
					foreach($setting as $key => $val) 
					{
						echo '<td>'.$val.'</td>';
					}				
				echo '</tr>';
			}
		
		echo '</table>';
	}
	else
	{
		//This is an error message that can be access like this:
		//echo $json->code." ".$json->error;
		echo json_encode($json);
	}

?>
                                                        

Set (add, update or remove) a SymbolSettings' list

URL: https://www.trade-copier.com/webservice/settings/setSymbolSettings.php
request: array of SymbolSettings object

Response: JSON object list with success code 200

PHP example

<?php
	
	echo "<link rel='stylesheet' type='text/css' href='http://www.trade-copier.com/webservice/example.css'>";
	
	$url="https://www.trade-copier.com/webservice/settings/setSymbolSettings.php";
	$headers =  array(
		'Content-Type: application/x-www-form-urlencoded',
		'Auth-Username: username',
		'Auth-Token: key',
	);

	// Open connection
	$ch = curl_init();

	// Setting the options
	curl_setopt($ch, CURLOPT_URL, $url);
	curl_setopt($ch, CURLOPT_POST, false);
	curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
	curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

	// SymbolSettings list to be added or updated
	// To remove a SymbolSettings, please define (slave_id or group_id) and (symbol and/or (symbol_master and master_id)) and leave empty risk_factor_type, risk_factor_value, max_order_size and copier_status
	$riskFactors = [
	  [	
		'slave_id' => '29524',
		//'group_id' => '538', 
		'master_id' => '43765',
		'symbol' => 'EURUSD',
		'symbol_master' => 'EURUSDi',
		'risk_factor_type' => '7',
		'risk_factor_value' => '0.11',		
		//'max_order_size' => '1.23',
		'copier_status' => '1'
	  ],
	  [	
		//'slave_id' => '29524',
		'group_id' => '538',
		//'master_id' => '44625',
		'symbol' => 'GOLD',
		//'symbol_master' => '',
		//'risk_factor_type' => '4',
		//'risk_factor_value' => '0.99',
		//'max_order_size' => '3.21',
		'copier_status' => '0'
	  ],
	];

	curl_setopt($ch, CURLOPT_POST, count($riskFactors));
	curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($riskFactors));
	
	// Execute request
	$json = json_decode(curl_exec($ch));

	// Close connection
	curl_close($ch);
	
	//We check if the request is successful
	if(array_key_exists('success', $json))
	{
		echo $json->code."-".$json->success;
	}
	else
	{
		//This is an error message that can be access like this:
		//echo $json->code." ".$json->error;
		echo json_encode($json);
	}

?>
                                                        

Get a full list of your Slave(s) Global Protection

URL: https://www.trade-copier.com/webservice/protection/getGlobalProtection.php
request: the request may specify an optional filter object containing the slave_id(s)

Response: JSON object list with success code 200

PHP example

<?php

	echo "<link rel='stylesheet' type='text/css' href='https://www.trade-copier.com/webservice/example.css'>";
	
	$url="https://www.trade-copier.com/webservice/protection/getGlobalProtection.php";
	$headers =  array(
		'Content-Type: application/x-www-form-urlencoded',
		'Auth-Username: username',
		'Auth-Token: key',
	);

	// Open connection
	$ch = curl_init();

	// Setting the options
	curl_setopt($ch, CURLOPT_URL, $url);
	curl_setopt($ch, CURLOPT_POST, false);
	curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
	curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

	$filter = ['slave_id' => '29524'];//Optional => Not defined to show the settings for all your Slaves

	curl_setopt($ch, CURLOPT_POST, count($filter));
	curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($filter));
	
	// Execute request
	$json = json_decode(curl_exec($ch));

	// Close connection
	curl_close($ch);

	//We access the existing account(s) list
	if(array_key_exists('globalprotections', $json))
	{
		echo "Global Protection list:<BR>";
		echo '<table id="api_data">';
			
			echo '<th>slave_id</th><th>stoploss_status</th><th>stoploss_type</th><th>stoploss_value</th><th>takeprofit_status</th><th>takeprofit_type</th><th>takeprofit_value</th>';
			
			foreach($json->globalprotections as $protection)
			{
				echo '<tr>';
					echo '<td>'.$protection->slave_id.'</td><td>'.$protection->stoploss_status.'</td><td>'.$protection->stoploss_type.'</td><td>'.$protection->stoploss_value.'</td><td>'.$protection->takeprofit_status.'</td><td>'.$protection->takeprofit_type.'</td><td>'.$protection->takeprofit_value.'</td>';
				echo '</tr>';
			}
			
		echo '</table>';
	}
	else
	{
		//This is an error message that can be access like this:
		//echo $json->code." ".$json->error;
		echo json_encode($json);
	}

?>
                                                        

Set (add, update or remove) the Global StopLoss and/or TakeProfit to protect the account equity.

URL: https://www.trade-copier.com/webservice/protection/setGlobalProtection.php
request: array of Slave(s) GlobalProtection object

Response: JSON object list with success code 200

PHP example

<?php

	echo "<link rel='stylesheet' type='text/css' href='https://www.trade-copier.com/webservice/example.css'>";
	
	$url="https://www.trade-copier.com/webservice/protection/setGlobalProtection.php";
	$headers =  array(
		'Content-Type: application/x-www-form-urlencoded',
		'Auth-Username: username',
		'Auth-Token: key',
	);

	// Open connection
	$ch = curl_init();

	// Setting the options
	curl_setopt($ch, CURLOPT_URL, $url);
	curl_setopt($ch, CURLOPT_POST, false);
	curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
	curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

	// Slave(s) GlobalProtection list to be added, updated or removed
	$protections = [
	  ['slave_id' => '29517', 'stoploss_status' => '0', 'stoploss_type' => '0', 'stoploss_value' => '5000', 'takeprofit_status' => '1', 'takeprofit_type' => '3', 'takeprofit_value' => '3000'],
	  ['slave_id' => '29524', 'stoploss_status' => '0', 'stoploss_type' => '1', 'stoploss_value' => '6000', 'takeprofit_status' => '1', 'takeprofit_type' => '2', 'takeprofit_value' => '4000'],
	  ['slave_id' => '30649', 'stoploss_status' => '0', 'stoploss_type' => '2', 'stoploss_value' => '7000', 'takeprofit_status' => '1', 'takeprofit_type' => '1', 'takeprofit_value' => '5000'],
	];

	curl_setopt($ch, CURLOPT_POST, count($protections));
	curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($protections));
	
	// Execute request
	$json = json_decode(curl_exec($ch));

	// Close connection
	curl_close($ch);
	
	//If updated is successful, we use the getRiskFactors webservice to check the new value
	if(array_key_exists('success', $json))
	{
		echo $json->code."-".$json->success;
	}
	else
	{
		//This is an error message that can be access like this:
		//echo $json->code." ".$json->error;
		echo json_encode($json);
	}

?>
                                                        

Get a full list of your Groups of Risk Factor(s) existing in your trade copier cockpit

URL: https://www.trade-copier.com/webservice/group/getGroups.php

Response: JSON object list

PHP example

<?php

	$url="https://www.trade-copier.com/webservice/group/getGroups.php";
	$headers =  array(
		'Content-Type: application/x-www-form-urlencoded',
		'Auth-Username: username',
		'Auth-Token: key',
	);

	// Open connection
	$ch = curl_init();

	// Setting the options
	curl_setopt($ch, CURLOPT_URL, $url);
	curl_setopt($ch, CURLOPT_POST, false);
	curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
	curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

	// Execute request
	$json = json_decode(curl_exec($ch));

	// Close connection
	curl_close($ch);

	//We access the existing group(s) list
	if(array_key_exists('groups', $json))
	{
		echo "Groups list:<BR>";
		foreach($json->groups as $group)
		{
			echo $group->group_id." - ".$group->name."<BR>";
		}
	}
	else
	{
		//This is an error message that can be access like this:
		//echo $json->code." ".$json->error;
		echo json_encode($json);
	}

?>
                                                        

Get open positions filtered by "account_id", "from" and/or "to" date

URL: https://www.trade-copier.com/webservice/position/getOpenPositions.php
The request may specify an optional filter object containing the account_id, from and/or to date

Response: JSON object

PHP example

<?php

	$url="https://www.trade-copier.com/webservice/position/getOpenPositions.php";
	$headers =  array(
		'Content-Type: application/x-www-form-urlencoded',
		'Auth-Username: username',
		'Auth-Token: key',
	);

	// Open connection
	$ch = curl_init();

	// Setting the options
	curl_setopt($ch, CURLOPT_URL, $url);
	curl_setopt($ch, CURLOPT_POST, false);
	curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
	curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
	
	$filter = ['account_id' => '42169', 'from' => '2017-06-09 09:48:58', 'to' => '2017-06-19 20:00:46'];
	//$filter = ['account_id' => '42169', 'from' => '2017-06-01 09:37:57'];
	//$filter = ['account_id' => '42169'];
	//$filter = [];

	curl_setopt($ch, CURLOPT_POST, count($filter));
	curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($filter));

	// Execute request
	$json = json_decode(curl_exec($ch));

	// Close connection
	curl_close($ch);

	//We access the open position(s) list
	if(array_key_exists('positions', $json))
	{
		echo "Open Positions list:<BR>";
		foreach($json->positions as $position)
		{
			echo $position->account_id." ".$position->ticket." ".$position->openTime." ".$position->side." ".$position->amountLot." ".$position->symbol." ".$position->openPrice." ".$position->stopPrice." ".$position->limitPrice." ".$position->stopLoss." ".$position->takeProfit."<BR>";
		}
	}
	else
	{
		//This is an error message that can be access like this:
		//echo $json->code." ".$json->error;
		echo json_encode($json);
	}

?>
                                                        

Get closed positions filtered by "account_id", "from" and/or "to" date

URL: https://www.trade-copier.com/webservice/position/getClosedPositions.php
The request may specify an optional filter object containing the account_id, from and/or to date

Response: JSON object (a maximum of 1'000 positions can be retrieved per request)

PHP example

<?php

	$url="https://www.trade-copier.com/webservice/position/getClosedPositions.php";
	$headers =  array(
		'Content-Type: application/x-www-form-urlencoded',
		'Auth-Username: username',
		'Auth-Token: key',
	);

	// Open connection
	$ch = curl_init();

	// Setting the options
	curl_setopt($ch, CURLOPT_URL, $url);
	curl_setopt($ch, CURLOPT_POST, false);
	curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
	curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
	
	$filter = ['account_id' => '42169', 'from' => '2017-06-09 09:48:58', 'to' => '2017-06-19 20:00:46'];
	//$filter = ['account_id' => '42169', 'from' => '2017-06-10 09:37:57'];
	//$filter = ['account_id' => '42169'];
	//$filter = [];
	
	curl_setopt($ch, CURLOPT_POST, count($filter));
	curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($filter));

	// Execute request
	$json = json_decode(curl_exec($ch));

	// Close connection
	curl_close($ch);

	//We access the closed position(s) list
	if(array_key_exists('positions', $json))
	{
		echo "Closed Positions list:<BR>";
		foreach($json->positions as $position)
		{
			echo $position->account_id." ".$position->ticket." ".$position->openTime." ".$position->side." ".$position->amountLot." ".$position->symbol." ".$position->openPrice." ".$position->stopPrice." ".$position->limitPrice." ".$position->stopLoss." ".$position->takeProfit." ".$position->closeTime." ".$position->closePrice." ".$position->profit_ccy." ".$position->ccy."<BR>";
		}
	}
	else
	{
		//This is an error message that can be access like this:
		//echo $json->code." ".$json->error;
		echo json_encode($json);
	}

?>
                                                        

Get orders filtered by "from" and/or "to" date

URL: https://www.trade-copier.com/webservice/position/getOrders.php
The request may specify an optional filter object containing master_id, account_id, error_only, from and/or to date. You can also limit the number of row in the result by adding a limit filter.

Response: JSON object (a maximum of 1'000 orders can be retrieved per request)

PHP example

<?php

	echo "<link rel='stylesheet' type='text/css' href='https://www.trade-copier.com/webservice/example.css'>";

	$url="https://www.trade-copier.com/webservice/order/getOrders.php";
	$headers =  array(
		'Content-Type: application/x-www-form-urlencoded',
		'Auth-Username: username',
		'Auth-Token: key',
	);
	
	// Open connection
	$ch = curl_init();

	// Setting the options
	curl_setopt($ch, CURLOPT_URL, $url);
	curl_setopt($ch, CURLOPT_POST, false);
	curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
	curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
	
    $filter = ['master_id' => '58989','account_id' => '72496', 'from' => '2019-03-26 09:48:58', 'to' => '2019-04-10 20:00:46'];
	//$filter = ['from' => '2019-03-26 09:48:58', 'to' => '2019-04-10 20:00:46'];
	//$filter = ['from' => '2019-03-26 09:48:58'];
	//$filter = ['to' => '2019-03-27 20:00:46'];
	//$filter = ['error_only' => '0', 'limit' => '10'];
	//$filter = [];
	
	curl_setopt($ch, CURLOPT_POST, count($filter));
	curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($filter));

	// Execute request
	$json = json_decode(curl_exec($ch));

	// Close connection
	curl_close($ch);

	//We access the closed position(s) list
	if(array_key_exists('orders', $json))
	{
		echo '<table id="api_data">';
			
			echo '<th>timestamp</th><th>master_id</th><th>ticketMaster</th><th>account_id</th><th>side</th><th>action</th><th>symbol</th><th>quantityOrder</th><th>quantityExecuted</th><th>status_id</th><th>statusName</th>';
			
			foreach($json->orders as $order)
			{
				echo '<tr>';
					echo '<td>'.$order->timestamp.'</td><td>'.$order->master_id.'</td><td>'.$order->ticketMaster.'</td><td>'.$order->account_id.'</td><td>'.$order->side.'</td><td>'.$order->action.'</td><td>'.$order->symbol.'</td><td>'.$order->quantityOrder.'</td><td>'.$order->quantityExecuted.'</td><td>'.$order->status_id.'</td><td>'.$order->statusName.'</td>';
				echo '</tr>';
			}
			
		echo '</table>';
	}
	else
	{
		//This is an error message that can be access like this:
		//echo $json->code." ".$json->error;
		echo json_encode($json);
	}

?>​