pynado 0.1.3

A friendly, Pythonic wrapper for the Nado Protocol SDK

Pynado

A friendly, Pythonic wrapper for the Nado Protocol SDK. Pynado simplifies the interaction with the Nado Protocol by abstracting low-level details and handling unit conversions automatically.

Installation

pip install pynado

Usage

1. Setup

Create a .env file in your project root to store your private key securely:

NADO_PRIVATE_KEY='your_private_key_here'

2. Basic Example

Initialize the client and check your account details:

from pynado import Nado

# Initialize the client (defaults to TESTNET and loads key from .env)
client = Nado()

# Access properties directly
print(f"Wallet Address: {client.address}")
print(f"USDT Balance:   {client.balance:,.2f}")

3. Trading (Market Orders)

Pynado handles symbol resolution (Spot vs. Perp) and unit scaling (to_x18) automatically.

# Market Buy 0.01 BTC (Spot)
client.buy("BTC", 0.01)

# Market Sell 0.5 ETH (Perp)
client.sell("ETH-PERP", 0.5)

4. Checking Positions

You can easily check specific positions or get an overview of your entire account.

# Get a specific position
pos = client.get_position("BTC-PERP")
print(f"Amount: {pos['amount']}, Entry Price: {pos['average_entry_price']}")

# Get all active positions
all_pos = client.get_all_positions()
for p in all_pos:
    print(f"{p['symbol']}: {p['amount']}")

Features

• Simple Interface: One class (Nado) to rule them all.
• Automatic Scaling: Handles 18-decimal scaling for you (returns float for balances, accepts float for orders).
• Symbol Resolution: Supports both Spot ("BTC") and Perp ("BTC-PERP") symbols.
• Position Management: Friendly methods to retrieve current holdings and average entry prices.
• Environment Friendly: Native support for .env files.