Many resources are needed to download a project. Please understand that we have to compensate our server costs. Thank you in advance. Project price only 1 $
You can buy this project and download/modify it how often you want.
* All stream endpoints under the
* Websocket Market Streams and
* User Data Streams
* section of the API documentation will be implemented in this class.
*
* Response will be returned as callback.
*/
public class WebsocketClientImpl implements WebsocketClient {
private final String baseUrl;
private final Map connections = new HashMap<>();
private final WebSocketCallback noopCallback = msg -> {
};
private static final Logger logger = LoggerFactory.getLogger(WebsocketClientImpl.class);
public WebsocketClientImpl() {
this.baseUrl = DefaultUrls.WS_URL;
}
public WebsocketClientImpl(String baseUrl) {
this.baseUrl = baseUrl;
}
/**
* The Aggregate Trade Streams push trade information that is aggregated for a single taker order.
*
* <symbol>@aggTrade
*
* Update Speed: Real-time
*
* @param symbol Name of trading pair
* @return int - Connection ID
* @see
* https://binance-docs.github.io/apidocs/spot/en/#aggregate-trade-streams
*/
@Override
public int aggTradeStream(String symbol, WebSocketCallback callback) {
ParameterChecker.checkParameterType(symbol, String.class, "symbol");
return aggTradeStream(symbol.toLowerCase(), noopCallback, callback, noopCallback, noopCallback);
}
/**
* Same as {@link #aggTradeStream(String, WebSocketCallback)} plus accepts callbacks for all major websocket connection events.
*
* @param symbol
* @param onOpenCallback
* @param onMessageCallback
* @param onClosingCallback
* @param onFailureCallback
* @return
*/
@Override
public int aggTradeStream(String symbol, WebSocketCallback onOpenCallback, WebSocketCallback onMessageCallback, WebSocketCallback onClosingCallback, WebSocketCallback onFailureCallback) {
ParameterChecker.checkParameterType(symbol, String.class, "symbol");
Request request = RequestBuilder.buildWebsocketRequest(String.format("%s/ws/%s@aggTrade", baseUrl, symbol.toLowerCase()));
return createConnection(onOpenCallback, onMessageCallback, onClosingCallback, onFailureCallback, request);
}
/**
* The Trade Streams push raw trade information; each trade has a unique buyer and seller.
*
* <symbol>@trade
*
* Update Speed: Real-time
*
* @param symbol Name of trading pair
* @return int - Connection ID
* @see
* https://binance-docs.github.io/apidocs/spot/en/#trade-streams
*/
@Override
public int tradeStream(String symbol, WebSocketCallback callback) {
ParameterChecker.checkParameterType(symbol, String.class, "symbol");
return tradeStream(symbol.toLowerCase(), noopCallback, callback, noopCallback, noopCallback);
}
/**
* Same as {@link #tradeStream(String, WebSocketCallback)} plus accepts callbacks for all major websocket connection events.
*
* @param symbol
* @param onOpenCallback
* @param onMessageCallback
* @param onClosingCallback
* @param onFailureCallback
* @return
*/
@Override
public int tradeStream(String symbol, WebSocketCallback onOpenCallback, WebSocketCallback onMessageCallback, WebSocketCallback onClosingCallback, WebSocketCallback onFailureCallback) {
ParameterChecker.checkParameterType(symbol, String.class, "symbol");
Request request = RequestBuilder.buildWebsocketRequest(String.format("%s/ws/%s@trade", baseUrl, symbol.toLowerCase()));
return createConnection(onOpenCallback, onMessageCallback, onClosingCallback, onFailureCallback, request);
}
/**
* The Kline/Candlestick Stream push updates to the current klines/candlestick every second.
*
* <symbol>@kline_<interval>
*
* Update Speed: Real-time
*
* @param symbol Name of trading pair
* @return int - Connection ID
* @see
* https://binance-docs.github.io/apidocs/spot/en/#kline-candlestick-streams
*/
@Override
public int klineStream(String symbol, String interval, WebSocketCallback callback) {
ParameterChecker.checkParameterType(symbol, String.class, "symbol");
return klineStream(symbol.toLowerCase(), interval, noopCallback, callback, noopCallback, noopCallback);
}
/**
* Same as {@link #klineStream(String, String, WebSocketCallback)} plus accepts callbacks for all major websocket connection events.
*
* @param symbol
* @param interval
* @param onOpenCallback
* @param onMessageCallback
* @param onClosingCallback
* @param onFailureCallback
* @return
*/
@Override
public int klineStream(String symbol, String interval, WebSocketCallback onOpenCallback, WebSocketCallback onMessageCallback, WebSocketCallback onClosingCallback, WebSocketCallback onFailureCallback) {
ParameterChecker.checkParameterType(symbol, String.class, "symbol");
Request request = RequestBuilder.buildWebsocketRequest(String.format("%s/ws/%s@kline_%s", baseUrl, symbol.toLowerCase(), interval));
return createConnection(onOpenCallback, onMessageCallback, onClosingCallback, onFailureCallback, request);
}
/**
* 24hr rolling window mini-ticker statistics.
* These are NOT the statistics of the UTC day, but a 24hr rolling window for the previous 24hrs.
*
* <symbol>@miniTicker
*
* Update Speed: Real-time
*
* @param symbol Name of trading pair
* @return int - Connection ID
* @see
* https://binance-docs.github.io/apidocs/spot/en/#individual-symbol-mini-ticker-stream
*/
@Override
public int miniTickerStream(String symbol, WebSocketCallback callback) {
ParameterChecker.checkParameterType(symbol, String.class, "symbol");
return miniTickerStream(symbol.toLowerCase(), noopCallback, callback, noopCallback, noopCallback);
}
/**
* Same as {@link #miniTickerStream(String, WebSocketCallback)} plus accepts callbacks for all major websocket connection events.
*
* @param symbol
* @param onOpenCallback
* @param onMessageCallback
* @param onClosingCallback
* @param onFailureCallback
* @return
*/
@Override
public int miniTickerStream(String symbol, WebSocketCallback onOpenCallback, WebSocketCallback onMessageCallback, WebSocketCallback onClosingCallback, WebSocketCallback onFailureCallback) {
ParameterChecker.checkParameterType(symbol, String.class, "symbol");
Request request = RequestBuilder.buildWebsocketRequest(String.format("%s/ws/%s@miniTicker", baseUrl, symbol.toLowerCase()));
return createConnection(onOpenCallback, onMessageCallback, onClosingCallback, onFailureCallback, request);
}
/**
* 24hr rolling window mini-ticker statistics for all symbols that changed in an array.
* These are NOT the statistics of the UTC day, but a 24hr rolling window for the previous 24hrs.
* Note that only tickers that have changed will be present in the array.
*
* !miniTicker@arr
*
* Update Speed: Real-time
*
* @return int - Connection ID
* @see
* https://binance-docs.github.io/apidocs/spot/en/#all-market-mini-tickers-stream
*/
@Override
public int allMiniTickerStream(WebSocketCallback callback) {
return allMiniTickerStream(noopCallback, callback, noopCallback, noopCallback);
}
/**
* Same as {@link #allMiniTickerStream(WebSocketCallback)} plus accepts callbacks for all major websocket connection events.
*
* @param onOpenCallback
* @param onMessageCallback
* @param onClosingCallback
* @param onFailureCallback
* @return
*/
@Override
public int allMiniTickerStream(WebSocketCallback onOpenCallback, WebSocketCallback onMessageCallback, WebSocketCallback onClosingCallback, WebSocketCallback onFailureCallback) {
Request request = RequestBuilder.buildWebsocketRequest(String.format("%s/ws/!miniTicker@arr", baseUrl));
return createConnection(onOpenCallback, onMessageCallback, onClosingCallback, onFailureCallback, request);
}
/**
* 24hr rolling window ticker statistics for a single symbol.
* These are NOT the statistics of the UTC day, but a 24hr rolling window for the previous 24hrs.
*
* <symbol>@ticker
*
* Update Speed: Real-time
*
* @param symbol Name of trading pair
* @return int - Connection ID
* @see
* https://binance-docs.github.io/apidocs/spot/en/#individual-symbol-ticker-streams
*/
@Override
public int symbolTicker(String symbol, WebSocketCallback callback) {
ParameterChecker.checkParameterType(symbol, String.class, "symbol");
return symbolTicker(symbol.toLowerCase(), noopCallback, callback, noopCallback, noopCallback);
}
/**
* Same as {@link #symbolTicker(String, WebSocketCallback)} plus accepts callbacks for all major websocket connection events.
*
* @param symbol
* @param onOpenCallback
* @param onMessageCallback
* @param onClosingCallback
* @param onFailureCallback
* @return
*/
@Override
public int symbolTicker(String symbol, WebSocketCallback onOpenCallback, WebSocketCallback onMessageCallback, WebSocketCallback onClosingCallback, WebSocketCallback onFailureCallback) {
ParameterChecker.checkParameterType(symbol, String.class, "symbol");
Request request = RequestBuilder.buildWebsocketRequest(String.format("%s/ws/%s@ticker", baseUrl, symbol.toLowerCase()));
return createConnection(onOpenCallback, onMessageCallback, onClosingCallback, onFailureCallback, request);
}
/**
* 24hr rolling window ticker statistics for all symbols that changed in an array.
* These are NOT the statistics of the UTC day, but a 24hr rolling window for the previous 24hrs.
* Note that only tickers that have changed will be present in the array.
*
* !ticker@arr
*
* Update Speed: Real-time
*
* @return int - Connection ID
* @see
* https://binance-docs.github.io/apidocs/spot/en/#all-market-tickers-stream
*/
@Override
public int allTickerStream(WebSocketCallback callback) {
return allTickerStream(noopCallback, callback, noopCallback, noopCallback);
}
/**
* Same as {@link #allTickerStream(WebSocketCallback)} plus accepts callbacks for all major websocket connection events.
*
* @param onOpenCallback
* @param onMessageCallback
* @param onClosingCallback
* @param onFailureCallback
* @return
*/
@Override
public int allTickerStream(WebSocketCallback onOpenCallback, WebSocketCallback onMessageCallback, WebSocketCallback onClosingCallback, WebSocketCallback onFailureCallback) {
Request request = RequestBuilder.buildWebsocketRequest(String.format("%s/ws/!ticker@arr", baseUrl));
return createConnection(onOpenCallback, onMessageCallback, onClosingCallback, onFailureCallback, request);
}
/**
* Rolling window ticker statistics for a single symbol, computed over multiple windows.
*
* <symbol>@ticker_<window_size>
*
* Update Speed: Real-time
*
* @param symbol Name of trading pair
* @param windowSize Window Sizes: 1h,4h
* @return int - Connection ID
* @see
* https://binance-docs.github.io/apidocs/spot/en/#individual-symbol-rolling-window-statistics-streams
*/
public int rollingWindowTicker(String symbol, String windowSize, WebSocketCallback callback) {
ParameterChecker.checkParameterType(symbol, String.class, "symbol");
ParameterChecker.checkParameterType(symbol, String.class, "windowSize");
ArrayList allowedWindowSize = new ArrayList() {{
add("1h");
add("4h");
}};
if (!allowedWindowSize.contains(windowSize)) {
throw new BinanceConnectorException(String.format("\"%s\" is not a valid window size.", windowSize));
}
return rollingWindowTicker(symbol.toLowerCase(), windowSize, noopCallback, callback, noopCallback, noopCallback);
}
/**
* Same as {@link #rollingWindowTicker(String, String, WebSocketCallback)} (String, WebSocketCallback)} plus accepts callbacks for all major websocket connection events.
*
* @param symbol
* @param onOpenCallback
* @param onMessageCallback
* @param onClosingCallback
* @param onFailureCallback
* @return
*/
@Override
public int rollingWindowTicker(String symbol, String windowSize, WebSocketCallback onOpenCallback, WebSocketCallback onMessageCallback, WebSocketCallback onClosingCallback, WebSocketCallback onFailureCallback) {
ParameterChecker.checkParameterType(symbol, String.class, "symbol");
ParameterChecker.checkParameterType(symbol, String.class, "windowSize");
ArrayList allowedWindowSize = new ArrayList() {{
add("1h");
add("4h");
}};
if (!allowedWindowSize.contains(windowSize)) {
throw new BinanceConnectorException(String.format("\"%s\" is not a valid window size.", windowSize));
}
Request request = RequestBuilder.buildWebsocketRequest(String.format("%s/ws/%s@ticker_%s", baseUrl, symbol.toLowerCase(), windowSize));
return createConnection(onOpenCallback, onMessageCallback, onClosingCallback, onFailureCallback, request);
}
/**
* Rolling window ticker statistics for all market symbols, computed over multiple windows.
* Note that only tickers that have changed will be present in the array.
*
* !ticker_<window-size>@arr
*
* Update Speed: Real-time
*
* @param windowSize Window Sizes: 1h,4h
* @return int - Connection ID
* @see
* https://binance-docs.github.io/apidocs/spot/en/#all-market-rolling-window-statistics-streams
*/
@Override
public int allRollingWindowTicker(String windowSize, WebSocketCallback callback) {
ParameterChecker.checkParameterType(windowSize, String.class, "windowSize");
ArrayList allowedWindowSize = new ArrayList() {{
add("1h");
add("4h");
}};
if (!allowedWindowSize.contains(windowSize.toLowerCase())) {
throw new BinanceConnectorException(String.format("\"%s\" is not a valid window size.", windowSize.toLowerCase()));
}
return allRollingWindowTicker(windowSize.toLowerCase(), noopCallback, callback, noopCallback, noopCallback);
}
/**
* Same as {@link #allRollingWindowTicker(String, WebSocketCallback)} plus accepts callbacks for all major websocket connection events.
*
* @param windowSize
* @param onOpenCallback
* @param onMessageCallback
* @param onClosingCallback
* @param onFailureCallback
* @return
*/
@Override
public int allRollingWindowTicker(String windowSize, WebSocketCallback onOpenCallback, WebSocketCallback onMessageCallback, WebSocketCallback onClosingCallback, WebSocketCallback onFailureCallback) {
ParameterChecker.checkParameterType(windowSize, String.class, "windowSize");
Request request = RequestBuilder.buildWebsocketRequest(String.format("%s/ws/!ticker_%s@arr", baseUrl, windowSize.toLowerCase()));
return createConnection(onOpenCallback, onMessageCallback, onClosingCallback, onFailureCallback, request);
}
/**
* Pushes any update to the best bid or ask's price or quantity in real-time for a specified symbol.
*
* <symbol>@bookTicker
*
* Update Speed: Real-time
*
* @param symbol Name of trading pair
* @return int - Connection ID
* @see
* https://binance-docs.github.io/apidocs/spot/en/#individual-symbol-book-ticker-streams
*/
@Override
public int bookTicker(String symbol, WebSocketCallback callback) {
ParameterChecker.checkParameterType(symbol, String.class, "symbol");
return bookTicker(symbol.toLowerCase(), noopCallback, callback, noopCallback, noopCallback);
}
/**
* Same as {@link #bookTicker(String, WebSocketCallback)} plus accepts callbacks for all major websocket connection events.
*
* @param symbol
* @param onOpenCallback
* @param onMessageCallback
* @param onClosingCallback
* @param onFailureCallback
* @return
*/
@Override
public int bookTicker(String symbol, WebSocketCallback onOpenCallback, WebSocketCallback onMessageCallback, WebSocketCallback onClosingCallback, WebSocketCallback onFailureCallback) {
ParameterChecker.checkParameterType(symbol, String.class, "symbol");
Request request = RequestBuilder.buildWebsocketRequest(String.format("%s/ws/%s@bookTicker", baseUrl, symbol.toLowerCase()));
return createConnection(onOpenCallback, onMessageCallback, onClosingCallback, onFailureCallback, request);
}
/**
* Top bids and asks, Valid are 5, 10, or 20.
*
* <symbol>@depth<levels>@<speed>ms
*
* Update Speed: 1000ms or 100ms
*
* @param symbol Name of trading pair
* @param levels Valid are 5, 10, or 20
* @param speed 1000ms or 100ms
* @return int - Connection ID
* @see
* https://binance-docs.github.io/apidocs/spot/en/#partial-book-depth-streams
*/
@Override
public int partialDepthStream(String symbol, int levels, int speed, WebSocketCallback callback) {
ParameterChecker.checkParameterType(symbol, String.class, "symbol");
return partialDepthStream(symbol.toLowerCase(), levels, speed, noopCallback, callback, noopCallback, noopCallback);
}
/**
* Same as {@link #partialDepthStream(String, int, int, WebSocketCallback)} plus accepts callbacks for all major websocket connection events.
*
* @param symbol
* @param levels
* @param speed
* @param onOpenCallback
* @param onMessageCallback
* @param onClosingCallback
* @param onFailureCallback
* @return
*/
@Override
public int partialDepthStream(String symbol, int levels, int speed, WebSocketCallback onOpenCallback, WebSocketCallback onMessageCallback, WebSocketCallback onClosingCallback, WebSocketCallback onFailureCallback) {
ParameterChecker.checkParameterType(symbol, String.class, "symbol");
Request request = RequestBuilder.buildWebsocketRequest(String.format("%s/ws/%s@depth%s@%sms", baseUrl, symbol.toLowerCase(), levels, speed));
return createConnection(onOpenCallback, onMessageCallback, onClosingCallback, onFailureCallback, request);
}
/**
* Order book price and quantity depth updates used to locally manage an order book.
*
* <symbol>@depth@<speed>ms
*
* Update Speed: 1000ms or 100ms
*
* @param symbol Name of trading pair
* @param speed 1000ms or 100ms
* @return int - Connection ID
* @see
* https://binance-docs.github.io/apidocs/spot/en/#diff-depth-stream
*/
@Override
public int diffDepthStream(String symbol, int speed, WebSocketCallback callback) {
ParameterChecker.checkParameterType(symbol, String.class, "symbol");
return diffDepthStream(symbol.toLowerCase(), speed, noopCallback, callback, noopCallback, noopCallback);
}
/**
* Same as {@link #diffDepthStream(String, int, WebSocketCallback)} plus accepts callbacks for all major websocket connection events.
*
* @param symbol
* @param speed
* @param onOpenCallback
* @param onMessageCallback
* @param onClosingCallback
* @param onFailureCallback
* @return
*/
@Override
public int diffDepthStream(String symbol, int speed, WebSocketCallback onOpenCallback, WebSocketCallback onMessageCallback, WebSocketCallback onClosingCallback, WebSocketCallback onFailureCallback) {
ParameterChecker.checkParameterType(symbol, String.class, "symbol");
Request request = RequestBuilder.buildWebsocketRequest(String.format("%s/ws/%s@depth@%sms", baseUrl, symbol.toLowerCase(), speed));
return createConnection(onOpenCallback, onMessageCallback, onClosingCallback, onFailureCallback, request);
}
/**
* User Data Streams are accessed at /ws/<listenKey>
*
* @param listenKey listen key obtained from this
* endpoint
* @return int - Connection ID
* @see
* https://binance-docs.github.io/apidocs/spot/en/#user-data-streams
*/
@Override
public int listenUserStream(String listenKey, WebSocketCallback callback) {
return listenUserStream(listenKey, noopCallback, callback, noopCallback, noopCallback);
}
/**
* Same as {@link #listenUserStream(String, WebSocketCallback)} plus accepts callbacks for all major websocket connection events.
*
* @param listenKey
* @param onOpenCallback
* @param onMessageCallback
* @param onClosingCallback
* @param onFailureCallback
* @return
*/
@Override
public int listenUserStream(String listenKey, WebSocketCallback onOpenCallback, WebSocketCallback onMessageCallback, WebSocketCallback onClosingCallback, WebSocketCallback onFailureCallback) {
Request request = RequestBuilder.buildWebsocketRequest(String.format("%s/ws/%s", baseUrl, listenKey));
return createConnection(onOpenCallback, onMessageCallback, onClosingCallback, onFailureCallback, request);
}
/**
* Combined streams are accessed at /stream?streams=<streamName1>/<streamName2>/<streamName3>
*
* @param streams A list of stream names to be combined
* @return int - Connection ID
* @see
* https://binance-docs.github.io/apidocs/spot/en/#websocket-market-streams
*/
@Override
public int combineStreams(ArrayList streams, WebSocketCallback callback) {
return combineStreams(streams, noopCallback, callback, noopCallback, noopCallback);
}
/**
* Same as {@link #combineStreams(ArrayList, WebSocketCallback)} plus accepts callbacks for all major websocket connection events.
*
* @param streams
* @param onOpenCallback
* @param onMessageCallback
* @param onClosingCallback
* @param onFailureCallback
* @return
*/
@Override
public int combineStreams(ArrayList streams, WebSocketCallback onOpenCallback, WebSocketCallback onMessageCallback, WebSocketCallback onClosingCallback, WebSocketCallback onFailureCallback) {
String url = UrlBuilder.buildStreamUrl(String.format("%s/stream", baseUrl), streams);
Request request = RequestBuilder.buildWebsocketRequest(url);
return createConnection(onOpenCallback, onMessageCallback, onClosingCallback, onFailureCallback, request);
}
/**
* Closes a specific stream based on stream Id.
*
* @param connectionId
*/
@Override
public void closeConnection(int connectionId) {
if (connections.containsKey(connectionId)) {
connections.get(connectionId).close();
logger.info("Closing Connection ID {}", connectionId);
connections.remove(connectionId);
} else {
logger.info("Connection ID {} does not exist!", connectionId);
}
}
/**
* Closes all streams
*/
@Override
public void closeAllConnections() {
if (!connections.isEmpty()) {
logger.info("Closing {} connections(s)", connections.size());
Iterator> iter = connections.entrySet().iterator();
while (iter.hasNext()) {
WebSocketConnection connection = iter.next().getValue();
connection.close();
iter.remove();
}
}
if (connections.isEmpty()) {
HttpClientSingleton.getHttpClient().dispatcher().executorService().shutdown();
logger.info("All connections are closed!");
}
}
private int createConnection(
WebSocketCallback onOpenCallback,
WebSocketCallback onMessageCallback,
WebSocketCallback onClosingCallback,
WebSocketCallback onFailureCallback,
Request request
) {
WebSocketConnection connection = new WebSocketConnection(onOpenCallback, onMessageCallback, onClosingCallback, onFailureCallback, request);
connection.connect();
int connectionId = connection.getConnectionId();
connections.put(connectionId, connection);
return connectionId;
}
}
