@chainstream-io/cli

@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 (read-only commands)

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

Get an API key at app.chainstream.io.

Turnkey Wallet (recommended, required for DeFi)

# First time: create wallet via Email OTP
chainstream login [e-mail]
# Enter OTP code when prompted → wallet created (EVM + Solana)

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

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

KYT

Command	Description
kyt risk	Address risk assessment

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
                    → Turnkey TEE (wallet signing)

• SDK-based: All API calls via @chainstream-io/sdk (typed, auto-retry, waitForJob)
• Non-custodial: Wallet keys in Turnkey TEE, never on local disk
• Dual auth: API Key (read-only) or Wallet Signature (full access + DeFi)

License

MIT