Quickstart

Hive Engine API

The core of nectarengine is the Api class, which provides access to the Hive Engine sidechain data.

from nectarengine.api import Api
api = Api()

# Get the latest block
print(api.get_latest_block_info())

# Get a specific block
print(api.get_block_info(1910))

# Get a transaction
print(api.get_transaction_info("e6c7f351b3743d1ed3d66eb9c6f2c102020aaa5d"))

# Get history for an account and token
print(api.get_history("test_user", "BEE"))

Wallet and Token Operations

To perform operations like transfers, you need a Wallet instance and a Hive connection from the Nectar library.

from nectar import Hive
from nectarengine.wallet import Wallet

# Initialize Hive with your active key
hive = Hive(keys=["your-active-private-key"])

# Create a wallet for your account
wallet = Wallet("youraccount", blockchain_instance=hive)

# Transfer tokens
wallet.transfer("recipient", 1.0, "BEE", memo="Quickstart transfer")

Market Operations

The Market class allows you to interact with the Hive Engine DEX.

from nectar import Hive
from nectarengine.market import Market

hive = Hive(keys=["your-active-private-key"])
market = Market(blockchain_instance=hive)

# Place a buy order
market.buy("youraccount", 100, "SWAP.HIVE", 0.5)

# Place a sell order
market.sell("youraccount", 100, "SWAP.HIVE", 0.6)

# Cancel an order
open_orders = market.get_buy_book("SWAP.HIVE", "youraccount")
if open_orders:
    market.cancel("youraccount", "buy", open_orders[0]["_id"])

NFT Operations

nectarengine also supports NFT operations on Hive Engine.

from nectar import Hive
from nectarengine.nft import Nft

hive = Hive(keys=["your-active-private-key"])
nft = Nft(blockchain_instance=hive)

# Transfer an NFT
nft.transfer("youraccount", "recipient", "NFT_SYMBOL", [123], memo="Sending NFT")