Metadata-Version: 2.1
Name: orbs-orderbook-sdk
Version: 0.10.2
Summary: Python SDK for the Orbs order book
Author: Luke Rogerson
Author-email: contact@lukerogerson.me
Requires-Python: >=3.8,<4.0
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Dist: asyncio (>=3.4.3,<4.0.0)
Requires-Dist: eth-account (>=0.10.0,<0.11.0)
Requires-Dist: requests (>=2.31.0,<3.0.0)
Requires-Dist: web3 (>=6.11.4,<7.0.0)
Description-Content-Type: text/markdown

# Python SDK for Orb's order book

This Python SDK allows you to query the Orb's order book and place orders.

**Please note that this SDK is still in development and is subject to change.**

## Getting started

The SDK [is available on PyPI](https://pypi.org/project/orbs-orderbook-sdk/) and can be installed with `pip`:

```bash
pip install orbs-orderbook-sdk
```

You will need to request an API key from the Orbs team, and provide us with your Externally Owned Account (EOA) wallet address (NOT the private key).

## Usage

### Creating an order

See `examples/create_order.py`.

### Creating multiple orders in a batch

See `examples/create_multiple_orders.py`.

### Signing an order

See `examples/sign_order.py`.

### Cancelling orders

See `examples/cancel_order.py`.

### Getting orders (open and filled)

See `examples/get_orders.py`.

### Other endpoints

See `orbs_orderbook/client.py` for the full list of available endpoints.

## Folder structure

- `examples`: Example scripts
- `orbs_orderbook`: The Python SDK source code

## Development

### Installation

1. Ensure you have at least Python 3.8 installed

#### Pip

1. Run `pip install -r requirements.txt` to install dependencies

#### Poetry

1. Install [Poetry](https://python-poetry.org/docs/#installation)
1. Run `poetry install` to install dependencies into a virtual environment

