MetatraderAccount (cloud.metaapi.sdk:metaapi-java-sdk 8.0.2 API)

java.lang.Object
- cloud.metaapi.sdk.meta_api.MetatraderAccount

public class MetatraderAccount
extends Object

Implements a MetaTrader account entity

Constructor Summary

Constructors
Constructor and Description
`MetatraderAccount(MetatraderAccountDto data, MetatraderAccountClient metatraderAccountClient, MetaApiWebsocketClient metaApiWebsocketClient, ConnectionRegistry connectionRegistry)` Constructs a MetaTrader account entity

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`CompletableFuture<MetaApiConnection>`	`connect()` Connects to MetaApi with default history storage.
`CompletableFuture<MetaApiConnection>`	`connect(HistoryStorage historyStorage)` Connects to MetaApi.
`CompletableFuture<MetaApiConnection>`	`connect(HistoryStorage historyStorage, IsoTime historyStartTime)` Connects to MetaApi.
`CompletableFuture<Void>`	`deploy()` Schedules account for deployment.
`String`	`getAccessToken()` Returns authorization access token to be used for accessing single account data.
`String`	`getApplication()` Returns application name to connect the account to.
`MetatraderAccountDto.ConnectionStatus`	`getConnectionStatus()` Returns terminal and broker connection status
`String`	`getId()` Returns account id
`String`	`getLogin()` Returns account login
`int`	`getMagic()` Returns MetaTrader magic to place trades using
`String`	`getName()` Returns account name
`String`	`getProvisioningProfileId()` Returns id of the account's provisioning profile
`String`	`getServer()` Returns MetaTrader server which hosts the account
`MetatraderAccountDto.DeploymentState`	`getState()` Returns account deployment state
`String`	`getType()` Returns account type.
`boolean`	`isManualTrades()` Returns flag indicating if trades should be placed as manual trades on this account
`CompletableFuture<Void>`	`redeploy()` Schedules account for redeployment.
`CompletableFuture<Void>`	`reload()` Reloads MetaTrader account from API
`CompletableFuture<Void>`	`remove()` Removes MetaTrader account.
`CompletableFuture<Void>`	`undeploy()` Schedules account for undeployment.
`CompletableFuture<Void>`	`update(MetatraderAccountUpdateDto account)` Updates MetaTrader account data
`CompletableFuture<Void>`	`waitConnected()` Waits until API server has connected to the terminal and terminal has connected to the broker.
`CompletableFuture<Void>`	`waitConnected(Integer timeoutInSeconds, Integer intervalInMilliseconds)` Waits until API server has connected to the terminal and terminal has connected to the broker.
`CompletableFuture<Void>`	`waitDeployed(Integer timeoutInSeconds, Integer intervalInMilliseconds)` Waits until API server has finished deployment and account reached the DEPLOYED state.
`CompletableFuture<Void>`	`waitRemoved(Integer timeoutInSeconds, Integer intervalInMilliseconds)` Waits until account has been deleted.
`CompletableFuture<Void>`	`waitUndeployed(Integer timeoutInSeconds, Integer intervalInMilliseconds)` Waits until API server has finished undeployment and account reached the UNDEPLOYED state.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - MetatraderAccount
```
public MetatraderAccount(MetatraderAccountDto data,
                         MetatraderAccountClient metatraderAccountClient,
                         MetaApiWebsocketClient metaApiWebsocketClient,
                         ConnectionRegistry connectionRegistry)
```
    Constructs a MetaTrader account entity
    
    Parameters:
    
    data - MetaTrader account data
    
    metatraderAccountClient - MetaTrader account REST API client
    
    metaApiWebsocketClient - MetaApi websocket client
    
    connectionRegistry - metatrader account connection registry
- Method Detail
  - getId
```
public String getId()
```
    Returns account id
    
    Returns:
    
    account id
  - getName
```
public String getName()
```
    Returns account name
    
    Returns:
    
    account name
  - getType
```
public String getType()
```
    Returns account type. Possible values are cloud and self-hosted.
    
    Returns:
    
    account type
  - getLogin
```
public String getLogin()
```
    Returns account login
    
    Returns:
    
    account login
  - getServer
```
public String getServer()
```
    Returns MetaTrader server which hosts the account
    
    Returns:
    
    MetaTrader server which hosts the account
  - getProvisioningProfileId
```
public String getProvisioningProfileId()
```
    Returns id of the account's provisioning profile
    
    Returns:
    
    id of the account's provisioning profile
  - getApplication
```
public String getApplication()
```
    Returns application name to connect the account to. Currently allowed values are MetaApi and AgiliumTrade
    
    Returns:
    
    application name to connect the account to
  - getMagic
```
public int getMagic()
```
    Returns MetaTrader magic to place trades using
    
    Returns:
    
    MetaTrader magic to place trades using
  - getState
```
public MetatraderAccountDto.DeploymentState getState()
```
    Returns account deployment state
    
    Returns:
    
    account deployment state
  - getConnectionStatus
```
public MetatraderAccountDto.ConnectionStatus getConnectionStatus()
```
    Returns terminal and broker connection status
    
    Returns:
    
    terminal and broker connection status
  - getAccessToken
```
public String getAccessToken()
```
    Returns authorization access token to be used for accessing single account data. Intended to be used in browser API.
    
    Returns:
    
    authorization token
  - isManualTrades
```
public boolean isManualTrades()
```
    Returns flag indicating if trades should be placed as manual trades on this account
    
    Returns:
    
    flag indicating if trades should be placed as manual trades on this account
  - reload
```
public CompletableFuture<Void> reload()
```
    Reloads MetaTrader account from API
    
    Returns:
    
    completable future resolving when MetaTrader account is updated
  - remove
```
public CompletableFuture<Void> remove()
```
    Removes MetaTrader account. Cloud account transitions to DELETING state. It takes some time for an account to be eventually deleted. Self-hosted account is deleted immediately.
    
    Returns:
    
    completable future resolving when account is scheduled for deletion
  - deploy
```
public CompletableFuture<Void> deploy()
```
    Schedules account for deployment. It takes some time for API server to be started and account to reach the DEPLOYED state
    
    Returns:
    
    completable future resolving when account is scheduled for deployment
  - undeploy
```
public CompletableFuture<Void> undeploy()
```
    Schedules account for undeployment. It takes some time for API server to be stopped and account to reach the UNDEPLOYED state
    
    Returns:
    
    completable future resolving when account is scheduled for undeployment
  - redeploy
```
public CompletableFuture<Void> redeploy()
```
    Schedules account for redeployment. It takes some time for API server to be restarted and account to reach the DEPLOYED state
    
    Returns:
    
    completable future resolving when account is scheduled for redeployment
  - waitDeployed
```
public CompletableFuture<Void> waitDeployed(Integer timeoutInSeconds,
                                            Integer intervalInMilliseconds)
```
    Waits until API server has finished deployment and account reached the DEPLOYED state. Completes exceptionally with TimeoutException if account have not reached the DEPLOYED state withing timeout allowed.
    
    Parameters:
    
    timeoutInSeconds - optional wait timeout in seconds, default is 5m
    
    intervalInMilliseconds - optional interval between account reloads while waiting for a change, default is 1s
    
    Returns:
    
    completable future which resolves when account is deployed
  - waitUndeployed
```
public CompletableFuture<Void> waitUndeployed(Integer timeoutInSeconds,
                                              Integer intervalInMilliseconds)
```
    Waits until API server has finished undeployment and account reached the UNDEPLOYED state. Completes exceptionally with TimeoutException if account have not reached the UNDEPLOYED state withing timeout allowed.
    
    Parameters:
    
    timeoutInSeconds - optional wait timeout in seconds, default is 5m
    
    intervalInMilliseconds - optional interval between account reloads while waiting for a change, default is 1s
    
    Returns:
    
    completable future which resolves when account is undeployed
  - waitRemoved
```
public CompletableFuture<Void> waitRemoved(Integer timeoutInSeconds,
                                           Integer intervalInMilliseconds)
```
    Waits until account has been deleted. Completes exceptionally with TimeoutException if account was not deleted withing timeout allowed.
    
    Parameters:
    
    timeoutInSeconds - optional wait timeout in seconds, default is 5m
    
    intervalInMilliseconds - optional interval between account reloads while waiting for a change, default is 1s
    
    Returns:
    
    completable future which resolves when account is deleted
  - waitConnected
```
public CompletableFuture<Void> waitConnected()
```
    Waits until API server has connected to the terminal and terminal has connected to the broker. Completes exceptionally with TimeoutException if account have not connected to the broker withing timeout allowed. Wait timeout in seconds is 5m and interval between account reloads while waiting for a change is 1s.
    
    Returns:
    
    completable future which resolves when API server is connected to the broker
  - waitConnected
```
public CompletableFuture<Void> waitConnected(Integer timeoutInSeconds,
                                             Integer intervalInMilliseconds)
```
    Waits until API server has connected to the terminal and terminal has connected to the broker. Completes exceptionally with TimeoutException if account have not connected to the broker withing timeout allowed.
    
    Parameters:
    
    timeoutInSeconds - optional wait timeout in seconds, default is 5m
    
    intervalInMilliseconds - optional interval between account reloads while waiting for a change, default is 1s
    
    Returns:
    
    completable future which resolves when API server is connected to the broker
  - connect
```
public CompletableFuture<MetaApiConnection> connect()
```
    Connects to MetaApi with default history storage. There is only one connection per account. Subsequent calls to this method will return the same connection.
    
    Returns:
    
    MetaApi connection
  - connect
```
public CompletableFuture<MetaApiConnection> connect(HistoryStorage historyStorage)
```
    Connects to MetaApi. There is only one connection per account. Subsequent calls to this method will return the same connection.
    
    Parameters:
    
    historyStorage - optional history storage, or null
    
    Returns:
    
    MetaApi connection
  - connect
```
public CompletableFuture<MetaApiConnection> connect(HistoryStorage historyStorage,
                                                    IsoTime historyStartTime)
```
    Connects to MetaApi. There is only one connection per account. Subsequent calls to this method will return the same connection.
    
    Parameters:
    
    historyStorage - optional history storage, or null
    
    historyStartTime - history start time, or null. Used for tests
    
    Returns:
    
    MetaApi connection
  - update
```
public CompletableFuture<Void> update(MetatraderAccountUpdateDto account)
```
    Updates MetaTrader account data
    
    Parameters:
    
    account - MetaTrader account update
    
    Returns:
    
    completable future resolving when account is updated

Class MetatraderAccount

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

MetatraderAccount

Method Detail

getId

getName

getType

getLogin

getServer

getProvisioningProfileId

getApplication

getMagic

getState

getConnectionStatus

getAccessToken

isManualTrades

reload

remove

deploy

undeploy

redeploy

waitDeployed

waitUndeployed

waitRemoved

waitConnected

waitConnected

connect

connect

connect

update