https://github.com/phil8192/bitstamp-ws
Bitstamp Websocket API v2 Java client
https://github.com/phil8192/bitstamp-ws
bitstamp bitstamp-api bitstamp-java limit-order-book
Last synced: 8 months ago
JSON representation
Bitstamp Websocket API v2 Java client
- Host: GitHub
- URL: https://github.com/phil8192/bitstamp-ws
- Owner: phil8192
- License: mit
- Created: 2019-05-20T19:27:47.000Z (about 7 years ago)
- Default Branch: master
- Last Pushed: 2025-05-05T16:17:34.000Z (about 1 year ago)
- Last Synced: 2025-05-05T17:45:35.417Z (about 1 year ago)
- Topics: bitstamp, bitstamp-api, bitstamp-java, limit-order-book
- Language: Java
- Size: 54.7 KB
- Stars: 3
- Watchers: 1
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# bitstamp-ws
[](http://www.repostatus.org/#active)
> Btstamp Websocket API v2 Java client
Java client for Bitstamp's [Websocket API v2](https://www.bitstamp.net/websocket/v2/).
Makes use of [dsl-json](https://github.com/ngs-doo/dsl-json) and [tyrus](https://tyrus-project.github.io/).
## Usage
This can be run in stand-alone mode for *orders* or *trades*. Running the below
will result in a logfile with the format `pair-type-YYYY-MM-DD.csv`, Change
`pair` for the market, `type` as either `orders` or `trades`.
The logfiles will rotate each day (UTC),
```bash
./run.sh btusd orders
```
or
```bash
./run.sh btusd trades
```
### API
See
[Client](https://github.com/phil8192/bitstamp-ws/blob/master/src/main/java/net/parasec/trading/bitstampws/Client.java)
interface.
For example, to stream limit orders for `btcusd`:
```java
// 1. Specify a message handler
Client client = new BitstampClient();
BitstampMessageHandler orderHandler = order -> System.out.println(order);
// 2. Subscribe to channel
String subscriptionId = client.subscribeOrders("btcusd", orderHandler);
// 3. Close channel
client.unsubscribe(subscriptionId)
```
Example [here](https://github.com/phil8192/limit-order-book/blob/master/src/main/java/net/parasec/ob/OrderBookStream.java).
It is expected that the message handler puts the message on a non-blocking queue or similar (performs minimal work).