@chainstream-io/cli

ChainStream CLI — on-chain data and DeFi execution for AI agents.

Query tokens, analyze wallets, track markets, and execute swaps across Solana, BSC, and Ethereum.

Quick Start

# Search tokens
npx @chainstream-io/cli token search --keyword PUMP --chain sol

# Get token security
npx @chainstream-io/cli token security --chain sol --address <token_address>

# Check trending tokens
npx @chainstream-io/cli market trending --chain sol --duration 1h

# Wallet PnL
npx @chainstream-io/cli wallet pnl --chain sol --address <wallet_address>

Authentication

API Key (recommended — works with all agent wallets)

chainstream config set --key apiKey --value <your_api_key>

Get an API key at app.chainstream.io, or via x402 purchase (see below).

ChainStream Wallet (recommended for DeFi)

# First time: create wallet (no email required)
chainstream login

# With email (optional, for account recovery)
chainstream login [email protected]

# Returning user: fast re-login
chainstream login --key

x402 Auto-Payment → API Key

When CLI encounters a 402 (no subscription), it auto-purchases via x402 and saves the returned API Key to config. After purchase, all subsequent calls use the API Key — no wallet signature needed.

# Just run any command — CLI handles payment automatically
npx @chainstream-io/cli token search --keyword PUMP --chain sol
# → [chainstream] No active subscription. Available plans: ...
# → [chainstream] Purchasing nano plan...
# → [chainstream] Subscription activated. API Key saved to config.
# → { results: [...] }

Raw Private Key (dev/testing only)

chainstream wallet set-raw --chain evm

Commands

Token

| Command | Description | |---------|-------------| | token search | Search tokens by keyword | | token info | Get full token detail | | token security | Check honeypot, mint auth, freeze auth | | token holders | Get top token holders | | token candles | Get OHLCV candlestick data | | token pools | Get liquidity pools |

Market

| Command | Description | |---------|-------------| | market trending | Hot/trending tokens | | market new | Newly created tokens | | market trades | Recent trades |

Wallet

| Command | Description | |---------|-------------| | wallet profile | PnL + net worth + top holdings | | wallet pnl | PnL details | | wallet holdings | Token balances | | wallet activity | Transfer history | | wallet address | Show wallet addresses | | wallet balance | Current wallet balance |

DeFi (requires wallet)

| Command | Description | |---------|-------------| | dex quote | Get swap quote | | dex swap | Execute token swap (irreversible) | | dex create | Create token on launchpad | | job status | Check job status |

Auth

| Command | Description | |---------|-------------| | login [email] | Email OTP login (default) | | login --key | P-256 key login (returning users) | | verify | Complete OTP verification | | logout | Clear session |

Supported Chains

| Chain | ID | Data API | DeFi | |-------|----|----------|------| | Solana | sol | Yes | Yes | | BSC | bsc | Yes | Yes | | Ethereum | eth | Yes | Yes |

Output

Default: formatted JSON. Use --raw for single-line JSON:

chainstream token info --chain sol --address <addr> --raw | jq '.price'

Architecture

@chainstream-io/cli → @chainstream-io/sdk → ChainStream v2 API
                    → TEE (wallet signing)

• SDK-based: All API calls via @chainstream-io/sdk (typed, auto-retry, waitForJob)
• Non-custodial: Wallet keys in TEE, never on local disk
• API Key first: x402 purchase auto-saves API Key; wallet signature as fallback for DeFi

License

MIT