Skip to main content

Reactive Websocket for Kraken

Project description

Kraken Websocket

[NOT RELEASED] This is very much a work in progress, despite being on pypi. Most things might be wrongly documented; API will change

Features

  • Reconnect with incremental backoff (per Kraken's recommendation)
  • Automatically reset subscription for private feeds when sequence is out of whack
  • request/response factories e.g. add_order_factory make websocket events feel like calling an API
  • ... but provides more info than a simple request/response; for instance, add_order goes through each stage submitted->pending->open or canceled, emitting a notification at each stage

Installing

pip install bittrade-kraken-websocket or poetry add bittrade-kraken-websocket

General considerations

Observables/Reactivex

The whole library is build with Reactivex.

Though Observables seem complicated at first, they are the best way to handle - and (synchronously) test - complex situations that arise over time, like an invalid sequence of messages or socket disconnection and backoff reconnects.

For simple use cases, they are also rather easy to use as shown in the examples folder or in the Getting Started below

Concurrency

Internally the library uses threads. For your main program you don't have to worry about threads; you can block the main thread.

Getting started

Connect to the public feeds

from bittrade_kraken_websocket import public_websocket_connection, subscribe_ticker
from bittrade_kraken_websocket.operators import keep_messages_only, filter_new_socket_only

# Prepare connection - note, this is a ConnectableObservable, so it will only trigger connection when we call its ``connect`` method
socket_connection = public_websocket_connection()
# Prepare a feed with only "real" messages, dropping things like status update, heartbeat, etc…
messages = socket_connection.pipe(
    keep_messages_only(),
)
socket_connection.pipe(
    filter_new_socket_only(),
    subscribe_ticker('USDT/USD', messages)
).subscribe(
    print, print, print  # you can do anything with the messages; here we simply print them out
)
socket_connection.connect()

(This script is complete, it should run "as is")

Logging

We use Python's standard logging. You can modify what logs you see as follows:

logging.getLogger('bittrade_kraken_websocket').addHandler(logging.StreamHandler())

Private feeds

Similar to bittrade-kraken-rest, this library attempts to get as little access to sensitive information as possible.

Currently, you need to set the token onto the EnhancedWebsocket; this means we have no access to your Api key and secret. Since the token is connection based and can't be reused, this protects you as much as Kraken's current authentication method allows.

In the future we might even let you code your own send_json method instead.

See examples/private_subscription.py for an example of implementation

new_sockets = connection.pipe(
    filter_new_socket_only(),
    operators.map(add_token),
    operators.share(),
)

Examples

Most examples in the examples folder make use of the development module helpers and the rich logging. You will need to install the dependencies from the rich group to use them:

poetry add bittrade_kraken_websocket -E rich

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

bittrade_kraken_websocket-0.3.3.tar.gz (20.1 kB view details)

Uploaded Source

Built Distribution

bittrade_kraken_websocket-0.3.3-py3-none-any.whl (30.2 kB view details)

Uploaded Python 3

File details

Details for the file bittrade_kraken_websocket-0.3.3.tar.gz.

File metadata

  • Download URL: bittrade_kraken_websocket-0.3.3.tar.gz
  • Upload date:
  • Size: 20.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.3.1 CPython/3.10.5 Darwin/20.6.0

File hashes

Hashes for bittrade_kraken_websocket-0.3.3.tar.gz
Algorithm Hash digest
SHA256 46e9f9c0ac8fd494f6359d1e561e7f22c8d749738dce305a0e50b0c9a0b8566e
MD5 a5c865887a912a03c397dc9fc43b4bdd
BLAKE2b-256 a37f5483fb3627d6683c37677bdb5ea1fe4c2312ff51dbe7678147438622a514

See more details on using hashes here.

File details

Details for the file bittrade_kraken_websocket-0.3.3-py3-none-any.whl.

File metadata

File hashes

Hashes for bittrade_kraken_websocket-0.3.3-py3-none-any.whl
Algorithm Hash digest
SHA256 8e7d8010a85d9de68672db151efdb90fecd3b7be14241a8b9f1eb1fa622318ca
MD5 f191202c023bf14fa4c28d37d3fff60b
BLAKE2b-256 c1aec1aaf7b9f2348a5cafe718bff4208d5a294f59e388ce93f5723b6b42bb35

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page