Skip to main content

Overview

The chainstream-data skill provides read-only on-chain data capabilities across Solana, BSC, and Ethereum. It covers token analytics, market ranking, wallet profiling, and WebSocket streaming.
  • Pattern: Tool (read-only, no signing)
  • MCP Server: https://mcp.chainstream.io/mcp (17 tools)
  • CLI: npx @chainstream-io/cli
  • API Base: https://api.chainstream.io

Integration Path

The skill uses a decision tree to route to the right execution channel:

Channel Matrix

OperationMCP ToolCLI CommandSDK Method
Search tokenstokens_searchtoken searchclient.token.search
Analyze tokentokens_analyzetoken infoclient.token.getToken
Security checktokens_analyzetoken securityclient.token.getSecurity
Top holderstokens_analyzetoken holdersclient.token.getHolders
Price history (K-line)tokens_price_historytoken candlesclient.token.getCandles
Liquidity poolstokens_discovertoken poolsclient.token.getPools
Trending tokensmarket_trendingmarket trendingclient.ranking.*
New listingsmarket_trendingmarket newclient.ranking.*
Recent tradestrades_recentmarket tradesclient.trade.*
Wallet profilewallets_profilewallet profileclient.wallet.*
Wallet PnLwallets_profilewallet pnlclient.wallet.*
Token balanceswallets_profilewallet holdingsclient.wallet.*
Transfer historywallets_activitywallet activityclient.wallet.*
DEX quotedex_quotedex routeclient.dex.quote

AI Workflows

Token Research

A complete token analysis flow — always run security checks before recommending any token.
npx @chainstream-io/cli token search --keyword PUMP --chain sol
npx @chainstream-io/cli token info --chain sol --address <addr>
npx @chainstream-io/cli token security --chain sol --address <addr>
npx @chainstream-io/cli token holders --chain sol --address <addr>
npx @chainstream-io/cli token candles --chain sol --address <addr> --resolution 1h

Market Discovery

Find trending tokens, apply multi-factor analysis, then security-check the top candidates.
npx @chainstream-io/cli market trending --chain sol --duration 1h --limit 50
# AI analyzes: smart money signals, volume, momentum, safety
npx @chainstream-io/cli token security --chain sol --address <candidate_1>
npx @chainstream-io/cli token security --chain sol --address <candidate_2>

Wallet Profiling

Analyze a wallet’s performance, holdings, and trading behavior.
npx @chainstream-io/cli wallet profile --chain sol --address <wallet>
npx @chainstream-io/cli wallet activity --chain sol --address <wallet>
npx @chainstream-io/cli token info --chain sol --address <top_holding>

Safety Rules

These rules are enforced by the skill to ensure data accuracy and responsible AI behavior.
RuleReason
Never answer price questions from training dataCrypto prices are stale within seconds — always make a live API call
Always run token security before recommendingChainStream’s risk model covers honeypot, rug pull, and concentration signals
Never pass format: "detailed" to MCP unless requestedReturns 4-10x more data than concise, wastes context window
Never batch more than 50 addresses in /multi endpointsAPI hard limit
Never use public RPC as substituteResults differ and miss ChainStream-specific enrichments

Error Recovery

ErrorRecovery
401 / “Not authenticated”Configure API Key or run chainstream login
402 / “Payment required”Follow x402 payment flow
429 / Rate limitWait 1s, exponential backoff
5xx / Server errorRetry once after 2s

chainstream-defi

For executing trades after research

CLI Commands

Full CLI command reference