npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

@nadohq/nado-cli

v0.1.3

Published

CLI for the Nado Protocol

Vulnerabilities

Powered byPowered by Snyk
  • 0High
  • 0Medium
  • 0Low

Links

Git

Maintainers

przemekinkprzemekinkfrankinkfndfrankinkfndjeuryinkjeuryink

Keywords

nadocryptotradingclidefiperps

Readme

nado-cli

version platform

CLI for the Nado Protocol — perpetual futures, spot trading, and liquidity provision on the Ink blockchain.

Full protocol access. Mainnet and testnet. Cross and isolated margin.

Pair with @nadohq/nado-mcp for MCP server support in Cursor, Claude, Codex, Copilot, Gemini, Goose, and other agents.

[!CAUTION] Experimental software. Interacts with the live Nado Protocol on the Ink blockchain and can execute real financial transactions including leveraged perpetual futures. Read DISCLAIMER.md before using with real funds or AI agents.

Contents

Installation

Requires Bun or Node.js 18+.

bun

bun install -g @nadohq/nado-cli

npm

npm install -g @nadohq/nado-cli

Run without installing

bunx @nadohq/nado-cli --help
# or
npx @nadohq/nado-cli --help

Verify it works:

nado --version
nado market list --format json
git clone https://github.com/nadohq/nado-cli.git
cd nado-cli
bun install
bun run build
bun link        # makes `nado` available globally

Quick Start

Public market data requires no credentials:

nado market list                              # All available markets
nado market price BTC                         # Best bid/ask
nado market tickers --market perp             # 24h perp tickers
nado market candles BTC --period 3600         # 1h OHLCV candles
nado market orderbook BTC --depth 20          # Orderbook depth

With authentication (see Configuration):

nado account summary                          # Balances, health, positions
nado trade long BTC 0.01                      # Market long BTC-PERP
nado trade buy ETH 1.0                        # Market buy ETH spot
nado trade close BTC                          # Close a position

For humans (interactive setup, REPL):

nado setup                                    # 1-click trading wizard
nado shell                                    # Interactive REPL
nado account summary                          # Table output by default

What You Can Trade

One CLI covers perps, spot, and liquidity provision on the Nado Protocol.

| Asset class | Description | Margin | Example | |---|---|---|---| | Perpetual futures | BTC, ETH, SOL, and more | Cross or isolated, configurable leverage | nado trade long BTC 0.01 -m isolated --leverage 10 | | Spot | Buy and sell tokens directly | — | nado trade buy ETH 1.0 -p 2500 | | NLP vault | Provide liquidity, earn yield | — | nado nlp mint 1000 |

Spot product IDs are even (0, 2, 4…). Perp product IDs are odd (1, 3, 5…). Product 0 is USDT0 (the quote token). Use nado market list to discover all available markets and their product IDs.

Commands

~40 commands across 8 groups.

| Group | Commands | Auth | Description | |-------|----------|------|-------------| | market | 7 | No | Prices, orderbook, candles, funding, tickers | | account | 6 | Yes | Balances, positions, orders, history, fees, stats | | trade | 14 | Yes | Long, short, buy, sell, close, cancel, TWAP, triggers, TP/SL | | funds | 3 | Yes | Deposit, withdraw, transfer between subaccounts | | nlp | 5 | Yes | NLP vault: info, balance, mint, burn, snapshots | | auth | 3 | Mixed | Credential management, linked signers | | setup | 1 | No | Interactive 1-click trading wizard | | shell | 1 | No | Interactive REPL |

14 commands are write operations (orders, closes, cancels, deposits, withdrawals, transfers, mints, burns). All write commands show a confirmation summary before executing. Use -y / --force to skip confirmations (use with caution).

Market Data (Public)

| Command | Description | |---------|-------------| | nado market list | List all available markets | | nado market price <MARKET> | Best bid/ask for a market | | nado market prices <MARKET...> | Bid/ask for multiple markets | | nado market orderbook <MARKET> [--depth 10] [--watch] | Orderbook depth (with optional live WebSocket mode) | | nado market candles <MARKET> [--period 3600] [--limit 20] | OHLCV candlestick data | | nado market funding <MARKET> | Current funding rate for a perp market | | nado market tickers [--market spot\|perp] | 24h ticker data for all markets |

Account Data (Private)

| Command | Description | |---------|-------------| | nado account summary | Subaccount summary with balances and health | | nado account positions | All open perp positions (cross and isolated) | | nado account orders [MARKET...] | Open orders (all or filtered by market) | | nado account history [--limit 100] [--product-ids BTC,ETH] | Historical orders (filled, cancelled, expired) | | nado account fees | Maker/taker fee rates | | nado account stats [--days 30] [--product-ids BTC] | Trading statistics over a time period |

Trading (Private)

| Command | Description | |---------|-------------| | nado trade long <MARKET> <AMOUNT> [-p PRICE] [-m cross\|isolated] [--leverage N] [--tp PRICE] [--sl PRICE] | Perp long order | | nado trade short <MARKET> <AMOUNT> [-p PRICE] [-m cross\|isolated] [--leverage N] [--tp PRICE] [--sl PRICE] | Perp short order | | nado trade buy <MARKET> <AMOUNT> [-p PRICE] [--no-borrow] | Spot buy order | | nado trade sell <MARKET> <AMOUNT> [-p PRICE] [--no-borrow] | Spot sell order | | nado trade tp <MARKET> <TRIGGER_PRICE> [AMOUNT] [-p PRICE] | Take-profit on existing position | | nado trade sl <MARKET> <TRIGGER_PRICE> [AMOUNT] [-p PRICE] | Stop-loss on existing position | | nado trade close <MARKET> [--slippage PCT] | Close an open position | | nado trade close-all [--side long\|short] [--product-ids IDS] | Close all open positions | | nado trade cancel <MARKET> <DIGEST...> | Cancel specific orders by digest | | nado trade cancel-all <MARKET> | Cancel all orders and triggers for a market | | nado trade cancel-trigger <MARKET> <DIGEST...> | Cancel specific trigger orders | | nado trade cancel-trigger-all <MARKET> | Cancel all trigger orders for a market | | nado trade cancel-and-place <MARKET> <SIDE> <AMOUNT> --cancel-digests D --cancel-market M [-p PRICE] | Atomic cancel + place | | nado trade twap <MARKET> <SIDE> <AMOUNT> <DURATION_MIN> [--interval SEC] | TWAP order split across time | | nado trade trigger <MARKET> <SIDE> <AMOUNT> --trigger-price P --trigger-type TYPE [-p PRICE] | Conditional trigger order |

Funds (Private)

| Command | Description | |---------|-------------| | nado funds deposit <AMOUNT> [--product-id 0] | Deposit collateral from wallet into subaccount | | nado funds withdraw <AMOUNT> [--product-id 0] | Withdraw collateral from subaccount to wallet | | nado funds transfer <AMOUNT> [--from NAME] [--to NAME] | Transfer USDT0 between subaccounts |

NLP Vault (Private)

| Command | Description | |---------|-------------| | nado nlp info | NLP vault pool info and current state | | nado nlp balance | Locked/unlocked NLP balances | | nado nlp mint <AMOUNT> | Deposit USDT0 to mint NLP tokens | | nado nlp burn <AMOUNT> | Burn NLP tokens to withdraw USDT0 | | nado nlp snapshots [--granularity 86400] [--limit 100] | Historical vault snapshots |

Auth & Utility

| Command | Description | |---------|-------------| | nado auth set [KEY] [VALUE] | Configure credentials and defaults | | nado auth whoami | Show current identity and config | | nado auth link-signer <ADDRESS> | Link a signer for 1-click trading | | nado setup | Interactive 1-click trading setup wizard | | nado shell | Interactive REPL with tab completion and history |

Configuration

Settings are resolved with this precedence: CLI flags > environment variables > config file > defaults.

Config file

Store credentials in ~/.config/nado/config.toml:

[default]
data_env = "nadoMainnet"        # nadoMainnet | nadoTestnet
subaccount_name = "default"

[credentials]
private_key = "0x..."
subaccount_owner = "0x..."      # only needed when using a linked signer

Or use the interactive wizard: nado setup or nado auth set.

Environment variables

| Variable | Description | |---|---| | PRIVATE_KEY | Wallet or linked signer private key | | SUBACCOUNT_OWNER | Explicit subaccount owner address | | SUBACCOUNT_NAME | Subaccount name (default: "default") | | DATA_ENV | nadoMainnet or nadoTestnet | | RPC_URL | Custom RPC endpoint | | NADO_FORMAT | Default output format: table or json |

Global CLI flags

--format <format>       Output format: table or json
--network <network>     Data environment: nadoMainnet or nadoTestnet
--owner <address>       Subaccount owner address
--subaccount <name>     Subaccount name
-y, --force             Skip confirmation prompts
--dry-run               Show what would be executed without submitting

Output defaults to table in a terminal (TTY) and json when piped.

Security

  • Config file is created with restricted permissions
  • Private keys are never logged, printed in output, or included in error messages
  • Use linked signers (1-click trading via nado setup) instead of your main wallet key
  • The linked signer is a hot key with limited scope — your main wallet key is never stored
  • For automation, prefer environment variables over config files
  • The --dry-run flag lets you inspect what would execute without submitting transactions

For AI Agents

If you're an AI agent or building one, the CLI is designed for structured, programmatic use:

nado <command> [args...] --format json 2>/dev/null
  • stdout is always valid JSON on success or a structured error on failure.
  • Exit code 0 means success. Non-zero means failure.
  • stderr carries diagnostics only. Never parse stderr for data.
  • All write operations show a confirmation summary. Use -y to skip for automation.
  • Market resolution is flexible: use symbols (BTC, ETH), full names (BTC-PERP), or product IDs (1, 2).

Agent invocation pattern:

# Read operations — no confirmation needed
nado market price BTC --format json 2>/dev/null
nado account summary --format json 2>/dev/null

# Write operations — use -y to skip interactive confirmation
nado trade long BTC 0.01 -y --format json 2>/dev/null
nado trade close BTC -y --format json 2>/dev/null

Examples

Market long with TP/SL

nado trade long BTC 0.01 --tp 75000 --sl 60000

Isolated margin with leverage

nado trade long SOL 10 -m isolated --leverage 5

Limit order

nado trade short ETH 0.5 -p 2500 --tif post_only

TWAP over 10 minutes

nado trade twap BTC long 0.1 10 --interval 30

Quick portfolio check (JSON, pipe to jq)

nado account summary --format json | jq '.health'
nado account positions --format json | jq '.crossPositions'

Live orderbook streaming

nado market orderbook BTC --watch

Paper-style exploration (testnet)

nado --network nadoTestnet account summary
nado --network nadoTestnet trade long BTC 0.01

Interactive REPL

nado shell
nado> market price BTC
┌────────────┬─────────┬───────┬───────┐
│ Market     │ Product │ Bid   │ Ask   │
├────────────┼─────────┼───────┼───────┤
│ BTC-PERP   │ 2       │ 72410 │ 72411 │
└────────────┴─────────┴───────┴───────┘
nado> account fees
nado> help
nado> exit

JSON (--format json)

The primary output format for agents. Every command returns valid JSON on stdout.

nado market price BTC --format json

Table (--format table)

Human-readable tables. Default when running in a terminal (TTY).

┌────────────┬─────────┬───────┬───────┐
│ Market     │ Product │ Bid   │ Ask   │
├────────────┼─────────┼───────┼───────┤
│ BTC-PERP   │ 2       │ 72410 │ 72411 │
└────────────┴─────────┴───────┴───────┘

Auto-detection

When stdout is a TTY, output defaults to table. When piped (| jq .), it defaults to json. Override with --format.

Write operation confirmations

All write operations (orders, cancels, deposits, withdrawals, transfers, mints, burns) display a summary and prompt for confirmation before executing:

  Long 0.01 BTC-PERP
  Type:     market
  Margin:   cross
  Slippage: 2%

  Proceed? (y/N)

Use -y / --force to skip. Use --dry-run to see the summary without executing.

"Private key not configured" or authentication errors

Run nado setup to configure 1-click trading, or set PRIVATE_KEY and SUBACCOUNT_OWNER environment variables. Verify with nado auth whoami.

"No market found" for a symbol

Use nado market list to see all available markets. You can use symbols (BTC), names (BTC-PERP), or product IDs (1).

Transaction fails or reverts

Check your subaccount balance with nado account summary. Ensure sufficient margin for the order size and leverage. For deposits, ensure your wallet has the token balance and enough native token for gas.

Orderbook errors on some products

Some protocol products (e.g. NLP pool token) exist on-chain but have no orderbook. The CLI handles this gracefully when querying all markets.

Shell history not saving

History is stored in ~/.config/nado/history. Ensure the directory exists and is writable.

Development

bun install          # install dependencies
bun run dev          # watch mode (rebuilds on change)
bun run build        # production build
bun run test         # run tests
bun run typecheck    # type checking
bun run lint         # lint + format

Disclaimer

See DISCLAIMER.md.