CLI Commands Reference

The chainstream CLI exposes every data product, GraphQL cube and DeFi primitive over a single binary. This page is the authoritative command reference — for narrative usage and installation see Access Methods → CLI.

Install

# Global install (recommended for interactive use)
npm install -g @chainstream-io/cli

# Zero-install, always-latest (recommended for agents and CI)
npx @chainstream-io/cli <command>

Either invocation works everywhere below. The short form chainstream <cmd> is used throughout this reference and is equivalent to npx @chainstream-io/cli <cmd>.

Global flags

Flag	Purpose
`--version`	Print the CLI version and exit
`--json`	Emit single-line machine-readable JSON (default output is pretty-printed JSON)
`--help`	Print help for the current command or group

Environment variables

Variable	Purpose	Default
`CHAINSTREAM_API_KEY`	API key used in lieu of `config.json`	unset
`CHAINSTREAM_API_URL`	Override REST base URL	`https://api.chainstream.io`
`CHAINSTREAM_AUTH_URL`	Override Auth service URL	production default
`CHAINSTREAM_GRAPHQL_URL`	Override GraphQL endpoint	`https://graphql.chainstream.io/graphql`
`SOLANA_RPC_URL`	Override Solana RPC for wallet / balance reads	public RPC
`BASE_RPC_URL`	Override Base RPC	public RPC

Config is persisted to ~/.config/chainstream/config.json; P-256 wallet keys live in ~/.config/chainstream/keys/. chainstream logout clears the wallet config but preserves the keys.

Authentication commands (top-level)

These commands are registered at the program root (no sub-group).

Command	Purpose	Arguments / Options
`login`	Create a TEE-backed wallet (default) or start an email OTP flow. Auto-grants the nano trial (50K CU, 30 days) on first login	`[email]`; `--key`; `--email`
`verify`	Complete an email OTP login started by `login --email`	`--otp-id`; `--code`; `--email`
`logout`	Clear the session (keeps keys on disk)	—
`bind-email`	Bind an email to an existing wallet	`[email]`
`bind-email-verify`	Finish the email-bind OTP flow (non-interactive)	`--otp-id`; `--code`; `--email`

`token` — Token information and analytics

Subcommand	Purpose	Options
`search`	Search tokens by keyword	`--keyword` (required); `--chain` (required); `--limit`
`info`	Get full token detail	`--chain`; `--address`
`security`	Security report (honeypot, mint authority, freeze authority, etc.)	`--chain`; `--address`
`holders`	Top token holders	`--chain`; `--address`; `--limit`
`candles`	OHLCV candlesticks	`--chain`; `--address`; `--resolution`; `--from`; `--to`; `--limit`
`pools`	Liquidity pools for a token	`--chain`; `--address`

`market` — Market data and discovery

Subcommand	Purpose	Options
`trending`	Hot / trending tokens by window	`--chain`; `--duration`; `--limit`
`new`	Newly created tokens	`--chain`; `--limit`
`trades`	Recent trades, optionally filtered to a token	`--chain`; `--token`; `--limit`

`wallet` — Wallet analytics, management, and signing

Subcommand	Purpose	Options
`sign`	Sign a serialized transaction with the on-host wallet	`--chain`; `--tx`
`profile`	PnL + net worth + top holdings in one call	`--chain`; `--address`
`pnl`	PnL detail	`--chain`; `--address`
`holdings`	Token balances	`--chain`; `--address`; `--limit`
`activity`	Transfer history	`--chain`; `--address`; `--limit`
`address`	Show current wallet addresses	—
`balance`	Native + USDC balance (single request)	`--chain` (`sol` \| `base`)
`set-raw`	Import a raw private key (dev / testing only)	`--chain` (`base` \| `sol`)
`link`	Link a wallet address to your subscription	`--chain` (`evm` \| `solana`)
`pricing`	List available x402 plans and prices	—

`dex` — DEX route, swap, and token creation

All commands return unsigned transactions built server-side; signing happens on the host wallet.

Subcommand	Purpose	Options
`route`	Aggregated route + unsigned swap transaction	`--chain`; `--from`; `--input-token`; `--output-token`; `--amount`; `--slippage`; `--dex`; `--recipient`; `--anti-mev`; `--gas-price`; `--gas-limit`; `--max-fee-per-gas`; `--max-priority-fee-per-gas`
`swap`	Unsigned swap transaction (direct, no aggregation)	`--chain`; `--from`; `--input-token`; `--output-token`; `--amount`; `--slippage`; `--dex`
`create`	Unsigned launchpad token creation transaction	`--chain`; `--from`; `--name`; `--symbol`; `--dex`; `--uri`; `--image`

`tx` — Broadcast and gas

Subcommand	Purpose	Options
`send`	Broadcast a signed transaction	`--chain`; `--signed-tx`; `--submit-type`; `--anti-mev`
`gas-price`	Current gas price (EVM only)	`--chain` (`eth` \| `bsc`)
`estimate-gas`	Estimate gas limit for an EVM call	`--chain`; `--from`; `--to`; `--data`; `--value`

`job` — Async job polling

Subcommand	Purpose	Options
`status`	Check the status of a long-running job	`--id`; `--wait`; `--timeout`

`graphql` — GraphQL schema and queries

See the full usage guide in Access Methods → CLI → GraphQL subcommand and the Agent Skill at chainstream-graphql.

Subcommand	Purpose	Options
`schema`	Discover schema (cubes, types, fields)	`--summary`; `--type <cube>`; `--full`; `--refresh`
`query`	Execute a GraphQL query	`--query <gql>`; `--file <path>`; `--var <json>`

`plan` — Subscription and x402 auto-pay

Subcommand	Purpose	Options
`status`	Current plan, remaining quota and usage	`--chain`; `--address`
`purchase`	Purchase a plan via x402 / MPP (auto-saves the returned API key to `config.json`)	`--plan`

`config` — Local configuration

Subcommand	Purpose	Options
`set`	Set a configuration value	`--key` (`apiKey` \| `baseUrl` \| `walletChain`); `--value`
`get`	Show current configuration	`--key` (optional)
`auth`	Show current authentication status	—

Exit behaviour

0 — success (or empty result)
1 — user-facing error with JSON payload on stdout (unless --json is off, in which case a formatted error is printed)
Non-zero exit on auth failure (401), payment-required (402), or network error

On 402 from any data/GraphQL command, the CLI prints a pointer to wallet pricing and plan purchase. plan purchase itself handles x402 auto-pay transparently.

Access Methods → CLI

Narrative usage: install, auth, first commands, GraphQL subcommand.

Agent Skills

How AI agents should drive the CLI.

x402 Payments

How plan purchase and on-the-fly 402 handling work.

GraphQL

Endpoint, schema and authentication for the GraphQL surface.

Authentication

REST API

WebSocket

Kafka Topics

CLI Commands

MCP Tools

CLI Commands Reference

Install

Global flags

Environment variables

Authentication commands (top-level)

`token` — Token information and analytics

`market` — Market data and discovery

`wallet` — Wallet analytics, management, and signing

`dex` — DEX route, swap, and token creation

`tx` — Broadcast and gas

`job` — Async job polling

`graphql` — GraphQL schema and queries

`plan` — Subscription and x402 auto-pay

`config` — Local configuration

Exit behaviour

Next

Access Methods → CLI

Agent Skills

x402 Payments

GraphQL

​Install

​Global flags

​Environment variables

​Authentication commands (top-level)

​token — Token information and analytics

​market — Market data and discovery

​wallet — Wallet analytics, management, and signing

​dex — DEX route, swap, and token creation

​tx — Broadcast and gas

​job — Async job polling

​graphql — GraphQL schema and queries

​plan — Subscription and x402 auto-pay

​config — Local configuration

​Exit behaviour

​Next

Access Methods → CLI

Agent Skills

x402 Payments

GraphQL

Install

Global flags

Environment variables

Authentication commands (top-level)

`token` — Token information and analytics

`market` — Market data and discovery

`wallet` — Wallet analytics, management, and signing

`dex` — DEX route, swap, and token creation

`tx` — Broadcast and gas

`job` — Async job polling

`graphql` — GraphQL schema and queries

`plan` — Subscription and x402 auto-pay

`config` — Local configuration

Exit behaviour

Next