@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 (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 [e-mail]

# 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

GraphQL

Command	Description
graphql schema	Discover cubes, fields, and query rules
graphql query	Execute GraphQL queries (supports x402 auto-payment)

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