valr-python 0.1.7

Python SDK for the VALR REST API

Python SDK for the VALR REST API

• Free software: MIT license

Installation

pip install valr-python

You can also install the in-development version with:

pip install https://github.com/jonathanelscpt/valr-python/archive/master.zip

Authentication

Authenticating to the VALR API requires a valid API Key from the VALR exchange.

Documentation

To use the project:

>>> from valr_python import Client
>>> from valr_python.exceptions import IncompleteOrderWarning
>>>
>>> c = Client(api_key='api_key', api_secret='api_secret')
>>> c.rate_limiting_support = True # honour HTTP 429 "Retry-After" header values
>>> limit_order = {
...     "side": "SELL",
...     "quantity": 0.1,
...     "price": 10000,
...     "pair": "BTCZAR",
...     "post_only": True,
... }
>>> try:
...    res = c.post_limit_order(**limit_order)
...    order_id = res['id']
...    print(order_id)
... except IncompleteOrderWarning as w:  # HTTP 202 Accepted handling for incomplete orders
...    order_id = w.data['id']
...    print(order_id)
... except Exception as e:
...    print(e)
"558f5e0a-ffd1-46dd-8fae-763d93fa2f25"
>>>

Development

To execute all tests run:

tox

Note, to combine the coverage data from all the tox environments run:

Windows	set PYTEST_ADDOPTS=--cov-append tox
Other	PYTEST_ADDOPTS=--cov-append tox

Donate

If this library has helped you, or if you would like to support future development, donations are most welcome:

Cryptocurrency	Address
BTC	38c7QWggrB2HLUJZFmhAC2zh4t8C57c1ec
ETH	0x01eD3b58a07c6d005281Db76e6c1AE2bfF2226AD

Changelog

0.1.7 (2020-01-11)

• Standardised api attribute naming in Client

• Updated doctest and readme for more detailed SDK description

0.1.6 (2020-01-11)

• Added custom warning IncompleteOrderWarning on receiving 202 Accepted response to support custom handling of incomplete orders

• Added custom warning TooManyRequestsWarning during 429 handling

• Added class flag for enabling or disabling 429 handler

0.1.5 (2020-01-11)

• Expanded test suites to unit, functional and live integration testing

• Internal class refactoring

• Added optional HTTP 429 handling by honouring the “Retry-After” header value sent in VALR responses

0.1.4 (2020-01-04)

• Streamlined ordering api calls with decorators

• Added typing support

• Re-worked class design internals to support later async expansion

• Fixed bugs with str ‘None’ insertion with f-strings

• Expanded unit tests to cover all api endpoints for synchronous client

0.1.3 (2020-01-02)

• Fixed defect with empty body signed signatures

• Updated class importing

• Added additional docstrings and unit tests

0.1.2 (2019-12-31)

• Updated readme and documentation

0.1.1 (2019-12-31)

• corrected build error issue in setup.py

0.1.0 (2019-12-29)

• Initial PyPi release

0.0.0 (2019-12-27)

• Alpha-only. Not released on PyPI.