com.metaco.api

Class MetacoClientImpl

java.lang.Object

com.metaco.api.MetacoClientImpl

All Implemented Interfaces:

MetacoClient

public class MetacoClientImpl
extends Object
implements MetacoClient

Field Summary

Fields

Modifier and Type	Field and Description
protected String	metacoApiId
protected String	metacoApiKey
protected String	metacoApiUrl
protected Boolean	metacoTestingMode

Constructor Summary

Constructors

Constructor and Description
MetacoClientImpl(MetacoClientBuilder builder)

Method Summary

Modifier and Type	Method and Description
TransactionBroadcastResult	broadcastTransaction(RawTransaction rawTransaction) Requires Authentication Submit a signed transaction You have to sign each of your inputs of the selected transaction (you will get those details when creating the transaction through Metaco) Then encode the transaction in hexadecimal and send it here
void	cancelOrder(String id) Requires Authentication Cancel the specified order
void	confirmPhoneNumber(ValidateAccountRequest request) Requires Authentication Validate the authenticated account, throws an exception if there is an error
Order	createOrder(NewOrder createOrder) Requires Authentication Create an order using the provided parameters This order will be processed in our system It will require your signature later when the trade state will be Signing
TransactionToSign	createTransaction(NewTransaction newTransaction) Requires Authentication Create a Transaction using the provided parameters
AccountStatus	getAccountStatus() Requires Authentication Return the details of an account (API Id, KYC Status and remaining trading amount)
Asset	getAsset(String ticker) Returns the selected Asset if it exists and its details
Asset[]	getAssets() Returns all the available Assets and their details
AssetsHistoryResult	getAssetsHistory(HistoryCriteria criteria) Returns the history for all the available assets according to the given criteria
AssetsHistoryResult	getAssetsHistory(HistoryCriteria criteria, List<String> tickers) Returns the history for the provided assets according to the given criteria Assets must be given using this format : USD,XAU,etc..
String	getLatestDebugData() For testing purposes only On some requests, when you use the TestingMode of the client, you will get a DebugData, which will simplify the testing of the API and the client As an example, a debugData could be the fake validationCode when your register an account.
Order	getOrder(String id) Requires Authentication Returns the specified user's order
OrderResultPage	getOrders() Requires Authentication Returns the user's orders, you will get the 500 first results
OrderResultPage	getOrders(PageCriteria pageCriteria) Requires Authentication Returns the user's orders, according to the pageCriteria settings (the page size is limited to 500)
WalletDetails	getWalletDetails(String address) Requires Authentication Returns the current wallet state The transaction history is paginated, you will get the 500 first results Contains the current balances, the values and the transaction history
WalletDetails	getWalletDetails(String address, PageCriteria pageCriteria) Requires Authentication Returns the current wallet state The transaction history is paginated, you can choose your page using the pageCriteria parameter (the page size is limited to 500) Contains the current balances, the values and the transaction history
AccountRegistrationResult	registerAccount(RegisterAccountRequest request) Register an account on Metaco Sends an SMS to the provided phone number If you are a wallet registering accounts for your clients, don't forget to set the provider_id with your Name/ID.
Order	submitSignedOrder(String id, RawTransaction rawTransaction) Requires Authentication Submit a signed order You have to sign each of your inputs of the selected order (you will get those details by fetching the orders) Then encode the transaction in hexadecimal and send it here

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

metacoApiId

protected String metacoApiId

metacoApiKey

protected String metacoApiKey

metacoApiUrl

protected String metacoApiUrl

metacoTestingMode

protected Boolean metacoTestingMode

Constructor Detail

MetacoClientImpl

public MetacoClientImpl(MetacoClientBuilder builder)

Method Detail

registerAccount

public AccountRegistrationResult registerAccount(RegisterAccountRequest request)
                                          throws MetacoClientException

Description copied from interface: MetacoClient

Register an account on Metaco Sends an SMS to the provided phone number If you are a wallet registering accounts for your clients, don't forget to set the provider_id with your Name/ID. If you are in debug mode, this request will return a HTTP header X-Metaco-DebugData with the validation code, it won't be send by SMS

Specified by:

registerAccount in interface MetacoClient

Returns:

The initial account settings

Throws:

MetacoClientException

See Also:

Online Documentation

getAccountStatus

public AccountStatus getAccountStatus()
                               throws MetacoClientException

Description copied from interface: MetacoClient

Requires Authentication Return the details of an account (API Id, KYC Status and remaining trading amount)

Specified by:

getAccountStatus in interface MetacoClient

Returns:

The account details

Throws:

MetacoClientException

See Also:

Online Documentation

confirmPhoneNumber

public void confirmPhoneNumber(ValidateAccountRequest request)
                        throws MetacoClientException

Description copied from interface: MetacoClient

Requires Authentication Validate the authenticated account, throws an exception if there is an error

Specified by:

confirmPhoneNumber in interface MetacoClient

Throws:

MetacoClientException

See Also:

Online Documentation

getAssets

public Asset[] getAssets()
                  throws MetacoClientException

Description copied from interface: MetacoClient

Returns all the available Assets and their details

Specified by:

getAssets in interface MetacoClient

Returns:

The assets array

Throws:

MetacoClientException

See Also:

Online Documentation

getAsset

public Asset getAsset(String ticker)
               throws MetacoClientException

Description copied from interface: MetacoClient

Returns the selected Asset if it exists and its details

Specified by:

getAsset in interface MetacoClient

Returns:

The asset object

Throws:

MetacoClientException

See Also:

Online Documentation

getAssetsHistory

public AssetsHistoryResult getAssetsHistory(HistoryCriteria criteria)
                                     throws MetacoClientException

Description copied from interface: MetacoClient

Returns the history for all the available assets according to the given criteria

Specified by:

getAssetsHistory in interface MetacoClient

Returns:

The history object

Throws:

MetacoClientException

See Also:

Online Documentation

getAssetsHistory

public AssetsHistoryResult getAssetsHistory(HistoryCriteria criteria,
                                            List<String> tickers)
                                     throws MetacoClientException

Description copied from interface: MetacoClient

Returns the history for the provided assets according to the given criteria Assets must be given using this format : USD,XAU,etc..

Specified by:

getAssetsHistory in interface MetacoClient

Returns:

The history object

Throws:

MetacoClientException

See Also:

Online Documentation

createOrder

public Order createOrder(NewOrder createOrder)
                  throws MetacoClientException

Description copied from interface: MetacoClient

Requires Authentication Create an order using the provided parameters This order will be processed in our system It will require your signature later when the trade state will be Signing

Specified by:

createOrder in interface MetacoClient

Throws:

MetacoClientException

See Also:

Online Documentation

getOrders

public OrderResultPage getOrders()
                          throws MetacoClientException

Description copied from interface: MetacoClient

Requires Authentication Returns the user's orders, you will get the 500 first results

Specified by:

getOrders in interface MetacoClient

Returns:

The orders array

Throws:

MetacoClientException

See Also:

Online Documentation

getOrders

public OrderResultPage getOrders(PageCriteria pageCriteria)
                          throws MetacoClientException

Description copied from interface: MetacoClient

Requires Authentication Returns the user's orders, according to the pageCriteria settings (the page size is limited to 500)

Specified by:

getOrders in interface MetacoClient

Returns:

The orders array

Throws:

MetacoClientException

See Also:

Online Documentation

getOrder

public Order getOrder(String id)
               throws MetacoClientException

Description copied from interface: MetacoClient

Requires Authentication Returns the specified user's order

Specified by:

getOrder in interface MetacoClient

Returns:

The order object

Throws:

MetacoClientException

See Also:

Online Documentation

submitSignedOrder

public Order submitSignedOrder(String id,
                               RawTransaction rawTransaction)
                        throws MetacoClientException

Description copied from interface: MetacoClient

Requires Authentication Submit a signed order You have to sign each of your inputs of the selected order (you will get those details by fetching the orders) Then encode the transaction in hexadecimal and send it here

Specified by:

submitSignedOrder in interface MetacoClient

Throws:

MetacoClientException

See Also:

Online Documentation

cancelOrder

public void cancelOrder(String id)
                 throws MetacoClientException

Description copied from interface: MetacoClient

Requires Authentication Cancel the specified order

Specified by:

cancelOrder in interface MetacoClient

Throws:

MetacoClientException

See Also:

Online Documentation

createTransaction

public TransactionToSign createTransaction(NewTransaction newTransaction)
                                    throws MetacoClientException

Description copied from interface: MetacoClient

Requires Authentication Create a Transaction using the provided parameters

Specified by:

createTransaction in interface MetacoClient

Throws:

MetacoClientException

See Also:

Online Documentation

broadcastTransaction

public TransactionBroadcastResult broadcastTransaction(RawTransaction rawTransaction)
                                                throws MetacoClientException

Description copied from interface: MetacoClient

Requires Authentication Submit a signed transaction You have to sign each of your inputs of the selected transaction (you will get those details when creating the transaction through Metaco) Then encode the transaction in hexadecimal and send it here

Specified by:

broadcastTransaction in interface MetacoClient

Throws:

MetacoClientException

See Also:

Online Documentation

getWalletDetails

public WalletDetails getWalletDetails(String address)
                               throws MetacoClientException

Description copied from interface: MetacoClient

Requires Authentication Returns the current wallet state The transaction history is paginated, you will get the 500 first results Contains the current balances, the values and the transaction history

Specified by:

getWalletDetails in interface MetacoClient

Throws:

MetacoClientException

See Also:

Online Documentation

getWalletDetails

public WalletDetails getWalletDetails(String address,
                                      PageCriteria pageCriteria)
                               throws MetacoClientException

Description copied from interface: MetacoClient

Requires Authentication Returns the current wallet state The transaction history is paginated, you can choose your page using the pageCriteria parameter (the page size is limited to 500) Contains the current balances, the values and the transaction history

Specified by:

getWalletDetails in interface MetacoClient

Throws:

MetacoClientException

See Also:

Online Documentation

getLatestDebugData

public String getLatestDebugData()

Description copied from interface: MetacoClient

For testing purposes only On some requests, when you use the TestingMode of the client, you will get a DebugData, which will simplify the testing of the API and the client As an example, a debugData could be the fake validationCode when your register an account.

Specified by:

getLatestDebugData in interface MetacoClient