Launch Hummingbot Miner

Bamboo Relay

About Bamboo Relay Connector

Bamboo Relay is an exchange application specializing in ERC-20 tokens that uses the 0x Protocol. Currently, Bamboo Relay allows any user to connect their wallet and trade between any coin pair combination.

Using the Connector

Because Bamboo Relay is a decentralized exchange, you will need an independent cryptocurrency wallet and an ethereum node in order to use Hummingbot. See below for information on how to create these:

Connector Operating Modes

The Bamboo Relay connector supports two modes of operation, open order book and coordinated order book.

By default the open order book mode is on for maximum order visibility and network syndication.

Open Order Book

Open order book mode allows for off-chain orders to be submitted and any taker to fill these orders on-chain. Orders may only be cancelled by submitting a transaction and paying gas network costs.

Open orders are syndicated through the 0x Mesh Network as well as directly submitted to the 0x API.

Coordinated order book

The coordinated order book mode extends the open order book mode by adding the ability to soft-cancel orders and a selective delay on order fills, while preserving network and contract fillable liquidity. This is achieved by the use of a coordinator server component and coordinator smart contracts.

At this time coordinated orders are not supported through the 0x Mesh Network or 0x API.

To enable coordinator mode set the bamboo_relay_use_coordinator parameter to true in conf_global.yml in the /conf directory.

Pre-emptive Cancels

The Bamboo Relay front-end UI does not show orders that have less than 30 seconds expiry remaining. This is so that users should only attempt to fill orders that have a reasonable chance of succeeding.

When running the connector in coordinated mode it is advised to enable this setting so that orders are automatically refreshed when they have 30 seconds remaining.

Daily Server Restarts

Bamboo Relay's server restarts at least twice a day which will drop WebSocket connections. As a result, errors will show up in the logs a few times in a day transiently before Hummingbot just reconnects.

Specifically it is Nginx that restarts that takes ~1 second when it happens. If it ends up being minutes, then there may be a problem. If it's just for a few seconds then it's almost 100% the restarts.

2019-09-05 18:15:02,335 - hummingbot.market.bamboo_relay.bamboo_relay_api_order_book_data_source - ERROR - Unexpected error with WebSocket connection. Retrying after 30 seconds...
Traceback (most recent call last):
  File "/hummingbot/market/bamboo_relay/bamboo_relay_api_order_book_data_source.py", line 214, in listen_for_order_book_diffs
    async with websockets.connect(WS_URL) as ws:
  File "/opt/conda/envs/hummingbot/lib/python3.6/site-packages/websockets/py35/client.py", line 2, in __aenter__
    return await self
  File "/opt/conda/envs/hummingbot/lib/python3.6/site-packages/websockets/py35/client.py", line 12, in __await_impl__
    transport, protocol = await self._creating_connection
  File "/opt/conda/envs/hummingbot/lib/python3.6/asyncio/base_events.py", line 809, in create_connection
    sock, protocol_factory, ssl, server_hostname)
  File "/opt/conda/envs/hummingbot/lib/python3.6/asyncio/base_events.py", line 835, in _create_connection_transport
    yield from waiter
  File "/opt/conda/envs/hummingbot/lib/python3.6/asyncio/selector_events.py", line 725, in _read_ready
    data = self._sock.recv(self.max_size)

ConnectionResetError: [Errno 104] Connection reset by peer

raise OSError(err, 'Connect call failed %s' % (address,))
ConnectionRefusedError: [Errno 111] Connect call failed ('', 443)

raise InvalidStatusCode(status_code)
websockets.exceptions.InvalidStatusCode: Status code not 101: 502

Miscellaneous Info

Minimum Order Sizes

The minimum acceptable order size is 0.004 WETH for pairs traded against WETH, this is to prevent transactional costs being higher than the nominal order amount.

Transaction Fees

Currently Bamboo Relay does not charge trading or withdrawal fees. This is set to change February 1st, 2020 with the introduction of relayer fees. See the fee schedule for the latest information.

0x Protocol V3 levies an additional protocol fee for each order filled, this is calculated as 150,000 * gasPrice per order. This is in addition to the standard Ethereum transaction fees.


This connector is maintained by Bamboo Relay, which can be contacted at:

Edit on GitHub