ExchangePortDemo | Documentation and code examples for ExchangePort | Learning library

Using Gradle, add your ExchangePort JAR. Also required is org.apache.httpcomponents:httpclient.
Construct the ConnectivityClient instance by providing a valid token (gotten on purchase). Construct the provider you want to connect to. Here's are two ways to connect to the FTX exchange. Note: In the nomenclature of this library, the class by which you connect to an exchange is called a "provider". Add your listeners to observe what's going on in the market. The market data is received using the data listener. Overall connection to the exchange, login status, and any error messages are received using the admin adapter listener. Callbacks regarding instrument subscriptions are received using the instrument listener. Subscribe to an instrument. Before proceeding, wait for one of the Layer1ApiInstrumentListener method to be called. Place an order (only if provider was constructed with credentials). Note: see below how to setup order listeners, and how to update / cancel orders. For code examples, see the *Example.java files in src/main/java.
Construct the ConnectivityClient instance by providing a valid token (gotten on purchase). ConnectivityClient client = new ConnectivityClient("YOUR_TOKEN");
Construct the provider you want to connect to. Here's are two ways to connect to the FTX exchange. // Connect as "read-only", to be able to observe the order book and market trades, but not to place orders. Layer1ApiProvider provider = client.ftx(); // Connect with your FTX keys to be able to place and manipulate your orders, observe positions etc. Layer1ApiProvider provider = client.ftx("YOUR_FTX_API_KEY", "YOUR_FTX_API_SECRET"); Note: In the nomenclature of this library, the class by which you connect to an exchange is called a "provider".
Setup listeners. Add your listeners to observe what's going on in the market. The market data is received using the data listener. provider.addListener(new Layer1ApiDataListener() { /** * Called when a trade happens in the market. */ @Override public void onTrade(String alias, double priceLevel, int sizeLevel, TradeInfo tradeInfo) {} /** * Called when the order book is updated. */ @Override public void onDepth(String alias, boolean isBid, int priceLevel, int sizeLevel) {} /** * Not used in blockchain exchanges. */ @Override public void onMarketMode(String s, MarketMode marketMode) {} }); Overall connection to the exchange, login status, and any error messages are received using the admin adapter listener. provider.addListener(new Layer1ApiAdminAdapter() { @Override public void onLoginFailed(LoginFailedReason reason, String message) {} @Override public void onLoginSuccessful() {} @Override public void onConnectionLost(DisconnectionReason reason, String message) {} @Override public void onConnectionRestored() {} @Override public void onSystemTextMessage(String message, SystemTextMessageType messageType) {} @Override public void onUserMessage(Object data) {} }); Callbacks regarding instrument subscriptions are received using the instrument listener. provider.addListener(new Layer1ApiInstrumentListener() { @Override public void onInstrumentAdded(String alias, InstrumentInfo instrumentInfo) {} @Override public void onInstrumentRemoved(String alias) {} @Override public void onInstrumentNotFound(String symbol, String exchange, String type) {} @Override public void onInstrumentAlreadySubscribed(String symbol, String exchange, String type) {} });
Subscribe to an instrument. String symbol = "ETH/USD"; double pip = 0.01; double sizeMultiplier = 1; provider.subscribe(new SubscribeInfoCrypto(symbol, null, null, pip, sizeMultiplier)); Before proceeding, wait for one of the Layer1ApiInstrumentListener method to be called.
Place an order (only if provider was constructed with credentials). boolean isBuy = true; int size = 1; OrderDuration duration = OrderDuration.GTC; double limitPrice = 370.0; double stopPrice = Double.NaN; provider.sendOrder(new SimpleOrderSendParameters(symbol, isBuy, size, duration, limitPrice, stopPrice)); Note: see below how to setup order listeners, and how to update / cancel orders.