Welcome to python-binance-chain v0.0.3

This is an unofficial Python wrapper for the Binance Chain API. I am in no way affiliated with Binance, use at your own risk.

PyPi

https://pypi.python.org/pypi/python-binance-chain

Source code

https://github.com/sammchardy/python-binance-chain

Features

• Implementation of HTTP endpoints
• Implementation of HTTP RPC endpoints
• Implementation of Websockets
• Implementation of Broadcast Transactions
• Response exception handling

TODO

• Implement wallet creation
• Implement RPC websockets etc

Quick Start

pip install python-binance-chain

If having issues with secp256k1 check the Installation instructions for the sec256k1-py library

from binance_chain.client import Client, KlineInterval

client = Client()

# connect client to different URL
client = Client(api_url='https://yournet.com')

# get node time
time = client.get_time()

# get node info
node_info = client.get_node_info()

# get validators
validators = client.get_validators()

# get peers
peers = client.get_peers()

# get account
account = client.get_account('tbnb185tqzq3j6y7yep85lncaz9qeectjxqe5054cgn')

# get account sequence
account_seq = client.get_account_sequence('tbnb185tqzq3j6y7yep85lncaz9qeectjxqe5054cgn')

# get markets
markets = client.get_markets()

# get fees
fees = client.get_fees()

# get order book
order_book = client.get_order_book('NNB-0AD_BNB')

# get klines
klines = client.get_klines('NNB-338_BNB', KlineInterval.ONE_DAY)

# get closed orders
closed_orders = client.get_closed_orders('tbnb185tqzq3j6y7yep85lncaz9qeectjxqe5054cgn')

# get open orders
open_orders = client.get_open_orders('tbnb185tqzq3j6y7yep85lncaz9qeectjxqe5054cgn')

# get open orders
print(json.dumps(client.get_ticker('NNB-0AD_BNB'), indent=2))

# get open orders
print(json.dumps(client.get_trades(limit=2), indent=2))

# get open orders
order = client.get_order('9D0537108883C68B8F43811B780327CE97D8E01D-2')

# get open orders
trades = client.get_trades()

# get transactions
transactions = client.get_transactions(address='tbnb1n5znwyygs0rghr6rsydhsqe8e6ta3cqatucsqp')

# get transaction
transaction = client.get_transaction('95DD6921370D74D0459590268B439F3DD49F6B1D090121AFE4B2183C040236F3')

Broadcast Messages

Place Order

from binance_chain.client import Client, NewOrderMsg

client = Client()

# construct the message
new_order_msg = NewOrderMsg(
    symbol="ANN-457_BNB",
    time_in_force=TimeInForce.GTE,
    order_type=OrderType.LIMIT,
    side=OrderSide.BUY,
    price=Decimal(0.000396000),
    quantity=Decimal(12)
)
# then broadcast it
res = client.broadcast_msg(new_order_msg, sync=True)

Cancel Order

from binance_chain.client import Client, CancelOrderMsg

client = Client()

# construct the message
cancel_order_msg = CancelOrderMsg(
    order_id="09F8B32D33CBE2B546088620CBEBC1FF80F9BE001ACF42762B0BBFF0A729CE3",
    symbol='ANN-457_BNB',
)
# then broadcast it
res = client.broadcast_msg(cancel_order_msg, sync=True)

Freeze Tokens

from binance_chain.client import Client, FreezeMsg

client = Client()

# construct the message freeze_msg = FreezeMsg(

symbol='BNB', amount=Decimal(10)

) # then broadcast it res = client.broadcast_msg(freeze_msg, sync=True)

Unfreeze Tokens

from binance_chain.client import Client, UnFreezeMsg

client = Client()

# construct the message unfreeze_msg = UnFreezeMsg(

symbol='BNB', amount=Decimal(10)

) # then broadcast it res = client.broadcast_msg(unfreeze_msg, sync=True)

Transfer Tokens

coming

Websockets

import asyncio

from binance_chain.websockets import BinanceChainSocketManager
from binance_chain.client import Client

address = 'tbnb...'


async def main():
    global loop

    async def handle_evt(msg):
        """Function to handle websocket messages
        """
        print(msg)

    bcsm = await BinanceChainSocketManager.create(loop, handle_evt, address2)

    # subscribe to relevant endpoints
    await bcsm.subscribe_orders(address)
    await bcsm.subscribe_market_depth(["FCT-B60_BNB", "0KI-0AF_BNB"])
    await bcsm.subscribe_market_delta(["FCT-B60_BNB", "0KI-0AF_BNB"])
    await bcsm.subscribe_trades(["FCT-B60_BNB", "0KI-0AF_BNB"])
    await bcsm.subscribe_ticker(["FCT-B60_BNB", "0KI-0AF_BNB"])

    while True:
        print("sleeping to keep loop open")
        await asyncio.sleep(20, loop=loop)


if __name__ == "__main__":

    loop = asyncio.get_event_loop()
    loop.run_until_complete(main())

Node RPC HTTP

from binance_chain.client import Client, PeerType
from binance_chain.node_rpc import HttpRpcClient

client = Client()

# get a peer that support node requests
peers = client.get_peers(peer_type=PeerType.NODE)
listen_addr = peers[0]['listen_addr']

# connect to this peer
rpc_client = HttpRpcClient(listen_addr)


abci_info = rpc_client.get_abci_info()
consensus_state = rpc_client.dump_consensus_state()
genesis = rpc_client.get_genesis()
net_info = rpc_client.get_net_info()
num_unconfirmed_txs = rpc_client.get_num_unconfirmed_txs()
status = rpc_client.get_status()
health = rpc_client.get_health()
unconfirmed_txs = rpc_client.get_unconfirmed_txs()
validators = rpc_client.get_validators()

block_height = rpc_client.get_block_height(10)

Donate

If this library helped you out feel free to donate.

• ETH: 0xD7a7fDdCfA687073d7cC93E9E51829a727f9fE70
• NEO: AVJB4ZgN7VgSUtArCt94y7ZYT6d5NDfpBo
• LTC: LPC5vw9ajR1YndE1hYVeo3kJ9LdHjcRCUZ
• BTC: 1Dknp6L6oRZrHDECRedihPzx2sSfmvEBys

Thanks

Sipa <https://github.com/sipa/bech32> for python reference implementation for Bech32 and segwit addresses

Other Exchanges

If you use Binance check out my python-binance library.

If you use Kucoin check out my python-kucoin library.

If you use Allcoin check out my python-allucoin library.

If you use IDEX check out my python-idex library.

If you use BigONE check out my python-bigone library.