[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M77164487R1C6FCH27EB5CF1":3,"skill-same:01M77164487R1C6FCH27EB5CF1":47},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":24,"commitSha":25,"skillDirectory":26,"forksCount":27,"repositoryHtmlUrl":28,"repositoryHomepageUrl":29,"ownerHtmlUrl":30,"ownerBlogUrl":6,"ownerDescription":31,"updatedAt":32,"install":33,"resources":46},"01M77164487R1C6FCH27EB5CF1","chainstream-data",null,"Query and analyze on-chain data via MCP (17 tools) and CLI across Solana, BSC, Ethereum. Use when user asks to search tokens, check token security or holders, track market trends or hot tokens, analyze wallet PnL or holdings, stream real-time trades, compare multiple tokens, or backtest trading strategies. Covers token analytics, market ranking, wallet profiling, and WebSocket streaming. Keywords: token, wallet, market, trending, PnL, holders, security, candles, WebSocket, on-chain data, MCP.","Lord1Egypt\u002Fawesome-skill-forge","Lord1Egypt","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F99746359?v=4","01M7592YDNT0XK9WJ0T2MQVPDN","Mohamed Mounir Ali AL Keshita","01M75GRFNHC8VZNWEB8DKDE433",3,"MIT","https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge\u002Fblob\u002Fmaster\u002Fcommunity\u002Fclawhub\u002Fc\u002Fchainstream-data\u002FSKILL.md",[],[],"2026-11-12 13:55:43",false,"---\nname: chainstream-data\ndescription: \"Query and analyze on-chain data via MCP (17 tools) and CLI across Solana, BSC, Ethereum. Use when user asks to search tokens, check token security or holders, track market trends or hot tokens, analyze wallet PnL or holdings, stream real-time trades, compare multiple tokens, or backtest trading strategies. Covers token analytics, market ranking, wallet profiling, and WebSocket streaming. Keywords: token, wallet, market, trending, PnL, holders, security, candles, WebSocket, on-chain data, MCP.\"\n---\n\n# ChainStream Data\n\nOn-chain data intelligence for AI agents. Access token analytics, market trends, wallet profiling, and compliance screening across Solana, BSC, and Ethereum.\n\n- **MCP Server**: `https:\u002F\u002Fmcp.chainstream.io\u002Fmcp` (streamable-http, 17 tools)\n- **CLI**: `npx @chainstream-io\u002Fcli`\n- **SDK**: `@chainstream-io\u002Fsdk`\n- **Base URL**: `https:\u002F\u002Fapi.chainstream.io`\n\n## Integration Path (check FIRST)\n\n**Agent runtime decision tree — choose based on environment and operation type:**\n\n1. **MCP tools registered?** (Cursor\u002FClaude Desktop\u002FVS Code already configured ChainStream MCP)\n   → YES → Use MCP tools for data queries (`tokens_search`, `wallets_profile`, etc.)\n   → NO → Use CLI for all operations (`npx @chainstream-io\u002Fcli ...`)\n\n2. **Need DeFi operation?** (swap, create token, sign transaction)\n   → YES → Must use CLI (MCP has no wallet signing capability)\n   → NO → Continue with MCP (or CLI if MCP unavailable)\n\n3. **MCP call failed?**\n   → Fall back to CLI as backup\n\n**Before anything else (CLI path), ensure user is authenticated:**\n1. `npx @chainstream-io\u002Fcli config auth` — check login status\n2. If NOT logged in → `npx @chainstream-io\u002Fcli login` (creates EVM + Solana wallet, auto-grants **nano trial plan: 50K CU free, 30 days** — no purchase needed)\n3. If logged in → proceed to subscription check below\n\n**New users get a free trial on login (50K CU).** For details on trial plans and upgrade options, see [`shared\u002Fauthentication.md`](..\u002Fshared\u002Fauthentication.md#agent-bootstrap-checklist).\n\n**Then check subscription:** `npx @chainstream-io\u002Fcli plan status`\n- If `active: true` → proceed with data queries\n- If no subscription → follow the purchase flow below (NEVER just run a data command hoping it \"auto-purchases\")\n\n**Getting an API Key (required for all paths):**\n- Dashboard users: [app.chainstream.io](https:\u002F\u002Fapp.chainstream.io) → API Keys\n- x402 (USDC on Base\u002FSolana): `npx @chainstream-io\u002Fcli plan purchase --plan \u003CPLAN> --json` → x402 purchase (real USDC payment via EIP-3009 signature). Run `wallet pricing --json` first, present ALL plans, let user choose\n- MPP (USDC.e on Tempo): `tempo request \"https:\u002F\u002Fapi.chainstream.io\u002Fmpp\u002Fpurchase?plan=\u003CPLAN>\"` → MPP payment → API Key auto-returned (fetch `\u002Fmpp\u002Fpricing` first, let user choose plan)\n\n**⚠️ Purchase flow (x402)**:\n0. `config auth` — ensure user is logged in. If not: `login` first (auto-grants nano trial — may be sufficient, check `plan status` before proceeding to purchase)\n1. `plan status --json` — check if subscription already exists (login auto-grants nano trial, so new users likely already have one)\n2. If `active: true` and quota sufficient → no purchase needed, proceed with data queries\n3. If no subscription or quota exhausted: `wallet pricing --json` — present ALL plans, let user choose. **NEVER auto-select a plan.**\n4. `wallet balance --chain base --json` (and\u002For `--chain sol`) — check where user has USDC\n5. If USDC is on Solana: `config set --key walletChain --value sol` (default is `base`)\n6. `plan purchase --plan \u003CUSER_CHOSEN> --json` — x402 purchase (real USDC payment). API Key auto-saved to config\n\n**⚠️ Quota is CU, NOT call count**: Plan quota is measured in **Compute Units (CU)**, not API call count. Each API endpoint costs a different amount of CU per call (varies by endpoint complexity and response size). When presenting plans to the user, always use \"CU\" as the unit — NEVER say \"calls\" or \"requests\".\n\n**Channel matrix:**\n\n| Operation | MCP (when registered) | CLI | SDK |\n|-----------|----------------------|-----|-----|\n| Search tokens | `tokens_search` | `token search` | `client.token.search` |\n| Analyze token | `tokens_analyze` | `token info` | `client.token.getToken` |\n| Price history | `tokens_price_history` | `token candles` | `client.token.getCandles` |\n| Wallet profile | `wallets_profile` | `wallet profile` | `client.wallet.*` |\n| Market trending | `market_trending` | `market trending` | `client.ranking.*` |\n| DEX quote | `dex_quote` | `dex route` | `client.dex.route` |\n| DEX swap | _(no signing)_ | `dex swap` | `client.dex.swap` + sign |\n| Create token | _(no signing)_ | `dex create` | `client.dex.createToken` |\n\n## Prerequisites\n\n### MCP path (recommended for data queries)\n\nAdd to your MCP client configuration (Cursor, Claude Desktop, VS Code):\n\n```json\n{\n  \"mcpServers\": {\n    \"chainstream\": {\n      \"url\": \"https:\u002F\u002Fmcp.chainstream.io\u002Fmcp\",\n      \"headers\": { \"X-API-KEY\": \"\u003Cyour-api-key>\" }\n    }\n  }\n}\n```\n\n### CLI path\n\n```bash\n# Option A: Use API Key (recommended — works with all agent wallets)\nnpx @chainstream-io\u002Fcli config set --key apiKey --value \u003Cyour-api-key>\n\n# Option B: Create ChainStream Wallet (for DeFi + auto x402 payment)\nnpx @chainstream-io\u002Fcli login\n\n# Option C: Import existing key (dev\u002Ftesting)\nnpx @chainstream-io\u002Fcli wallet set-raw --chain base   # EVM (Base) key\nnpx @chainstream-io\u002Fcli wallet set-raw --chain sol     # Solana key\n```\n\n### SDK path\n\n`npm install @chainstream-io\u002Fsdk` — see [`shared\u002Fauthentication.md`](..\u002Fshared\u002Fauthentication.md) Path 2 for `WalletSigner` integration.\n\n## Endpoint Selector\n\n### Token\n\n| Intent | CLI Command | MCP Tool | Reference |\n|--------|-------------|----------|-----------|\n| Search tokens | `npx @chainstream-io\u002Fcli token search --keyword X --chain sol` | `tokens_search` | [token-research.md](references\u002Ftoken-research.md) |\n| Token detail | `npx @chainstream-io\u002Fcli token info --chain sol --address ADDR` | `tokens_analyze` | [token-research.md](references\u002Ftoken-research.md) |\n| Security check | `npx @chainstream-io\u002Fcli token security --chain sol --address ADDR` | `tokens_analyze` | [token-research.md](references\u002Ftoken-research.md) |\n| Top holders | `npx @chainstream-io\u002Fcli token holders --chain sol --address ADDR` | `tokens_analyze` | [token-research.md](references\u002Ftoken-research.md) |\n| K-line \u002F OHLCV | `npx @chainstream-io\u002Fcli token candles --chain sol --address ADDR --resolution 1h` | `tokens_price_history` | [token-research.md](references\u002Ftoken-research.md) |\n| Liquidity pools | `npx @chainstream-io\u002Fcli token pools --chain sol --address ADDR` | `tokens_discover` | [token-research.md](references\u002Ftoken-research.md) |\n\n### Market\n\n| Intent | CLI Command | MCP Tool | Reference |\n|--------|-------------|----------|-----------|\n| Hot\u002Ftrending tokens | `npx @chainstream-io\u002Fcli market trending --chain sol --duration 1h` | `market_trending` | [market-discovery.md](references\u002Fmarket-discovery.md) |\n| New token listings | `npx @chainstream-io\u002Fcli market new --chain sol` | `market_trending` | [market-discovery.md](references\u002Fmarket-discovery.md) |\n| Recent trades | `npx @chainstream-io\u002Fcli market trades --chain sol` | `trades_recent` | [market-discovery.md](references\u002Fmarket-discovery.md) |\n\n### Wallet\n\n| Intent | CLI Command | MCP Tool | Reference |\n|--------|-------------|----------|-----------|\n| Wallet profile (PnL + holdings) | `npx @chainstream-io\u002Fcli wallet profile --chain sol --address ADDR` | `wallets_profile` | [wallet-profiling.md](references\u002Fwallet-profiling.md) |\n| PnL details | `npx @chainstream-io\u002Fcli wallet pnl --chain sol --address ADDR` | `wallets_profile` | [wallet-profiling.md](references\u002Fwallet-profiling.md) |\n| Token balances | `npx @chainstream-io\u002Fcli wallet holdings --chain sol --address ADDR` | `wallets_profile` | [wallet-profiling.md](references\u002Fwallet-profiling.md) |\n| Transfer history | `npx @chainstream-io\u002Fcli wallet activity --chain sol --address ADDR` | `wallets_activity` | [wallet-profiling.md](references\u002Fwallet-profiling.md) |\n| Own wallet balance (base\u002Fsol) | `npx @chainstream-io\u002Fcli wallet balance --chain sol` | — | Supports `sol` and `base` (note: `base` is a payment chain, not a data chain) |\n\n### Subscription\n\n| Intent | CLI Command | MCP Tool | Reference |\n|--------|-------------|----------|-----------|\n| **Check current subscription** | `npx @chainstream-io\u002Fcli plan status` | — | [x402-payment.md](..\u002Fshared\u002Fx402-payment.md) |\n| Check subscription (explicit) | `npx @chainstream-io\u002Fcli plan status --chain evm --address ADDR` | — | [x402-payment.md](..\u002Fshared\u002Fx402-payment.md) |\n| View available plans | `npx @chainstream-io\u002Fcli wallet pricing` | — | [x402-payment.md](..\u002Fshared\u002Fx402-payment.md) |\n| **Purchase plan (non-interactive)** | `npx @chainstream-io\u002Fcli plan purchase --plan \u003CNAME> --json` | — | [x402-payment.md](..\u002Fshared\u002Fx402-payment.md) |\n| Check subscription (API) | `curl \"https:\u002F\u002Fapi.chainstream.io\u002Fx402\u002Fstatus?chain=evm&address=ADDR\"` | — | [x402-payment.md](..\u002Fshared\u002Fx402-payment.md) |\n\n## Quickstart\n\n```bash\nnpx @chainstream-io\u002Fcli login                                              # Auth (one-time)\nnpx @chainstream-io\u002Fcli token search --keyword PUMP --chain sol            # Search tokens\nnpx @chainstream-io\u002Fcli token info --chain sol --address \u003Caddr> --json     # Token detail (single-line JSON for piping)\n```\n\nAll commands from the Endpoint Selector tables above work after `login`. Append `--json` for machine-readable output.\n\n**Default limit**: All list queries (`token search`, `token holders`, `token candles`, `market trending`, `market new`, `market trades`, `wallet holdings`, `wallet activity`) default to **5 results**. Pass `--limit \u003Cn>` to override (e.g. `--limit 20`).\n\n## AI Workflows\n\n### Token Research Flow\n\n```\nnpx @chainstream-io\u002Fcli token search → npx @chainstream-io\u002Fcli token info → npx @chainstream-io\u002Fcli token security\n→ npx @chainstream-io\u002Fcli token holders → npx @chainstream-io\u002Fcli token candles\n```\n\nBefore recommending any token, always run `token security` — ChainStream's risk model covers honeypot, rug pull, mint authority, freeze authority, and holder concentration.\n\n### Market Discovery Flow\n\n**MANDATORY - READ**: Before executing this workflow, load [`references\u002Fmarket-discovery.md`](references\u002Fmarket-discovery.md) for the multi-factor signal weight table and output format.\n\n```\nnpx @chainstream-io\u002Fcli market trending (top 50)\n→ AI multi-factor analysis (smart money, volume, momentum, safety)\n→ npx @chainstream-io\u002Fcli token security (top 5 candidates)\n→ Present results to user\n→ If user wants to trade → load chainstream-defi skill\n```\n\n**Do NOT load** wallet-profiling.md for this workflow.\n\n### Wallet Profiling Flow\n\n**MANDATORY - READ**: Load [`references\u002Fwallet-profiling.md`](references\u002Fwallet-profiling.md) for PnL interpretation and behavior patterns.\n\n```\nnpx @chainstream-io\u002Fcli wallet profile → npx @chainstream-io\u002Fcli wallet activity\n→ npx @chainstream-io\u002Fcli token info (on top holdings)\n→ Assess: win rate, concentration, holding behavior\n```\n\n## NEVER Do\n\n- NEVER answer \"what's the price of X\" from training data — always make a live CLI\u002FAPI call; crypto prices are stale within seconds\n- NEVER skip `token security` before recommending a token — ChainStream's risk model covers honeypot, rug pull, and concentration signals that generic analysis misses\n- NEVER pass `format: \"detailed\"` to MCP tools unless user explicitly requests it — returns 4-10x more tokens than default `concise`, wastes context window\n- NEVER batch more than 50 addresses in `\u002Fmulti` endpoints — API hard limit\n- NEVER use public RPC or third-party data providers as substitutes — results differ and miss ChainStream-specific enrichments (security scores, smart money tags)\n- NEVER omit `--limit` on list queries — CLI defaults to 5 results to prevent context overflow. If the user needs more, pass `--limit \u003Cn>` explicitly (e.g. `--limit 20`)\n- NEVER run data commands (token\u002Fmarket\u002Fwallet) without ensuring user is logged in and has an active subscription — run `config auth` → `login` (if needed) → `plan status` first. New users get a free nano trial on login; only run `plan purchase` if the trial is exhausted or absent\n\n## Error Recovery\n\n| Error | Meaning | Recovery |\n|-------|---------|----------|\n| \"Not authenticated\" \u002F 401 \u002F 402 | Not logged in, no API Key, or no active subscription | Follow the 401\u002F402 sequence below |\n| 429 | Rate limit | Wait 1s, exponential backoff |\n| 5xx | Server error | Retry once after 2s |\n\nOn 401\u002F402, follow this exact sequence:\n1. **Check login**: `npx @chainstream-io\u002Fcli config auth` — if not logged in, run `npx @chainstream-io\u002Fcli login` (creates wallet + auto-grants nano trial with 50K CU free). After login, retry the failed command — it will likely succeed now\n2. **Check subscription**: `npx @chainstream-io\u002Fcli plan status` — if `active: true` with remaining quota, the issue is likely a transient auth error; retry\n3. **If logged in but no subscription**: ask the user \"Do you have a ChainStream API Key?\" — if yes, `config set --key apiKey --value \u003Ckey>` and retry; if no, run `npx @chainstream-io\u002Fcli wallet pricing`, **present ALL plans to the user**, let them choose, then load [`shared\u002Fx402-payment.md`](..\u002Fshared\u002Fx402-payment.md) for the purchase flow. **NEVER auto-select a plan. NEVER try to pipe input to interactive CLI prompts.**\n\n## Skill Map\n\n| Reference | Content | When to Load |\n|-----------|---------|--------------|\n| [token-research.md](references\u002Ftoken-research.md) | 25+ token endpoints, batch queries, security field meanings | Token analysis tasks |\n| [market-discovery.md](references\u002Fmarket-discovery.md) | Ranking\u002Ftrade endpoints, multi-factor discovery workflow | Hot token discovery |\n| [wallet-profiling.md](references\u002Fwallet-profiling.md) | 15+ wallet endpoints, PnL logic, behavior patterns | Wallet analysis |\n| [websocket-streams.md](references\u002Fwebsocket-streams.md) | Channels, subscription format, heartbeat | Real-time streaming |\n\n## Related Skills\n\n- [chainstream-graphql](..\u002Fchainstream-graphql\u002F) — When standard REST\u002FMCP endpoints aren't enough: custom GraphQL queries with cross-cube JOINs, aggregations, and complex filters on 27 on-chain cubes\n- [chainstream-defi](..\u002Fchainstream-defi\u002F) — When analysis leads to action: swap, launchpad, transaction signing and broadcast\n","# ChainStream Data\n\nOn-chain data intelligence for AI agents. Access token analytics, market trends, wallet profiling, and compliance screening across Solana, BSC, and Ethereum.\n\n- **MCP Server**: `https:\u002F\u002Fmcp.chainstream.io\u002Fmcp` (streamable-http, 17 tools)\n- **CLI**: `npx @chainstream-io\u002Fcli`\n- **SDK**: `@chainstream-io\u002Fsdk`\n- **Base URL**: `https:\u002F\u002Fapi.chainstream.io`\n\n## Integration Path (check FIRST)\n\n**Agent runtime decision tree — choose based on environment and operation type:**\n\n1. **MCP tools registered?** (Cursor\u002FClaude Desktop\u002FVS Code already configured ChainStream MCP)\n   → YES → Use MCP tools for data queries (`tokens_search`, `wallets_profile`, etc.)\n   → NO → Use CLI for all operations (`npx @chainstream-io\u002Fcli ...`)\n\n2. **Need DeFi operation?** (swap, create token, sign transaction)\n   → YES → Must use CLI (MCP has no wallet signing capability)\n   → NO → Continue with MCP (or CLI if MCP unavailable)\n\n3. **MCP call failed?**\n   → Fall back to CLI as backup\n\n**Before anything else (CLI path), ensure user is authenticated:**\n1. `npx @chainstream-io\u002Fcli config auth` — check login status\n2. If NOT logged in → `npx @chainstream-io\u002Fcli login` (creates EVM + Solana wallet, auto-grants **nano trial plan: 50K CU free, 30 days** — no purchase needed)\n3. If logged in → proceed to subscription check below\n\n**New users get a free trial on login (50K CU).** For details on trial plans and upgrade options, see [`shared\u002Fauthentication.md`](..\u002Fshared\u002Fauthentication.md#agent-bootstrap-checklist).\n\n**Then check subscription:** `npx @chainstream-io\u002Fcli plan status`\n- If `active: true` → proceed with data queries\n- If no subscription → follow the purchase flow below (NEVER just run a data command hoping it \"auto-purchases\")\n\n**Getting an API Key (required for all paths):**\n- Dashboard users: [app.chainstream.io](https:\u002F\u002Fapp.chainstream.io) → API Keys\n- x402 (USDC on Base\u002FSolana): `npx @chainstream-io\u002Fcli plan purchase --plan \u003CPLAN> --json` → x402 purchase (real USDC payment via EIP-3009 signature). Run `wallet pricing --json` first, present ALL plans, let user choose\n- MPP (USDC.e on Tempo): `tempo request \"https:\u002F\u002Fapi.chainstream.io\u002Fmpp\u002Fpurchase?plan=\u003CPLAN>\"` → MPP payment → API Key auto-returned (fetch `\u002Fmpp\u002Fpricing` first, let user choose plan)\n\n**⚠️ Purchase flow (x402)**:\n0. `config auth` — ensure user is logged in. If not: `login` first (auto-grants nano trial — may be sufficient, check `plan status` before proceeding to purchase)\n1. `plan status --json` — check if subscription already exists (login auto-grants nano trial, so new users likely already have one)\n2. If `active: true` and quota sufficient → no purchase needed, proceed with data queries\n3. If no subscription or quota exhausted: `wallet pricing --json` — present ALL plans, let user choose. **NEVER auto-select a plan.**\n4. `wallet balance --chain base --json` (and\u002For `--chain sol`) — check where user has USDC\n5. If USDC is on Solana: `config set --key walletChain --value sol` (default is `base`)\n6. `plan purchase --plan \u003CUSER_CHOSEN> --json` — x402 purchase (real USDC payment). API Key auto-saved to config\n\n**⚠️ Quota is CU, NOT call count**: Plan quota is measured in **Compute Units (CU)**, not API call count. Each API endpoint costs a different amount of CU per call (varies by endpoint complexity and response size). When presenting plans to the user, always use \"CU\" as the unit — NEVER say \"calls\" or \"requests\".\n\n**Channel matrix:**\n\n| Operation | MCP (when registered) | CLI | SDK |\n|-----------|----------------------|-----|-----|\n| Search tokens | `tokens_search` | `token search` | `client.token.search` |\n| Analyze token | `tokens_analyze` | `token info` | `client.token.getToken` |\n| Price history | `tokens_price_history` | `token candles` | `client.token.getCandles` |\n| Wallet profile | `wallets_profile` | `wallet profile` | `client.wallet.*` |\n| Market trending | `market_trending` | `market trending` | `client.ranking.*` |\n| DEX quote | `dex_quote` | `dex route` | `client.dex.route` |\n| DEX swap | _(no signing)_ | `dex swap` | `client.dex.swap` + sign |\n| Create token | _(no signing)_ | `dex create` | `client.dex.createToken` |\n\n## Prerequisites\n\n### MCP path (recommended for data queries)\n\nAdd to your MCP client configuration (Cursor, Claude Desktop, VS Code):\n\n```json\n{\n  \"mcpServers\": {\n    \"chainstream\": {\n      \"url\": \"https:\u002F\u002Fmcp.chainstream.io\u002Fmcp\",\n      \"headers\": { \"X-API-KEY\": \"\u003Cyour-api-key>\" }\n    }\n  }\n}\n```\n\n### CLI path\n\n```bash\n# Option A: Use API Key (recommended — works with all agent wallets)\nnpx @chainstream-io\u002Fcli config set --key apiKey --value \u003Cyour-api-key>\n\n# Option B: Create ChainStream Wallet (for DeFi + auto x402 payment)\nnpx @chainstream-io\u002Fcli login\n\n# Option C: Import existing key (dev\u002Ftesting)\nnpx @chainstream-io\u002Fcli wallet set-raw --chain base   # EVM (Base) key\nnpx @chainstream-io\u002Fcli wallet set-raw --chain sol     # Solana key\n```\n\n### SDK path\n\n`npm install @chainstream-io\u002Fsdk` — see [`shared\u002Fauthentication.md`](..\u002Fshared\u002Fauthentication.md) Path 2 for `WalletSigner` integration.\n\n## Endpoint Selector\n\n### Token\n\n| Intent | CLI Command | MCP Tool | Reference |\n|--------|-------------|----------|-----------|\n| Search tokens | `npx @chainstream-io\u002Fcli token search --keyword X --chain sol` | `tokens_search` | [token-research.md](references\u002Ftoken-research.md) |\n| Token detail | `npx @chainstream-io\u002Fcli token info --chain sol --address ADDR` | `tokens_analyze` | [token-research.md](references\u002Ftoken-research.md) |\n| Security check | `npx @chainstream-io\u002Fcli token security --chain sol --address ADDR` | `tokens_analyze` | [token-research.md](references\u002Ftoken-research.md) |\n| Top holders | `npx @chainstream-io\u002Fcli token holders --chain sol --address ADDR` | `tokens_analyze` | [token-research.md](references\u002Ftoken-research.md) |\n| K-line \u002F OHLCV | `npx @chainstream-io\u002Fcli token candles --chain sol --address ADDR --resolution 1h` | `tokens_price_history` | [token-research.md](references\u002Ftoken-research.md) |\n| Liquidity pools | `npx @chainstream-io\u002Fcli token pools --chain sol --address ADDR` | `tokens_discover` | [token-research.md](references\u002Ftoken-research.md) |\n\n### Market\n\n| Intent | CLI Command | MCP Tool | Reference |\n|--------|-------------|----------|-----------|\n| Hot\u002Ftrending tokens | `npx @chainstream-io\u002Fcli market trending --chain sol --duration 1h` | `market_trending` | [market-discovery.md](references\u002Fmarket-discovery.md) |\n| New token listings | `npx @chainstream-io\u002Fcli market new --chain sol` | `market_trending` | [market-discovery.md](references\u002Fmarket-discovery.md) |\n| Recent trades | `npx @chainstream-io\u002Fcli market trades --chain sol` | `trades_recent` | [market-discovery.md](references\u002Fmarket-discovery.md) |\n\n### Wallet\n\n| Intent | CLI Command | MCP Tool | Reference |\n|--------|-------------|----------|-----------|\n| Wallet profile (PnL + holdings) | `npx @chainstream-io\u002Fcli wallet profile --chain sol --address ADDR` | `wallets_profile` | [wallet-profiling.md](references\u002Fwallet-profiling.md) |\n| PnL details | `npx @chainstream-io\u002Fcli wallet pnl --chain sol --address ADDR` | `wallets_profile` | [wallet-profiling.md](references\u002Fwallet-profiling.md) |\n| Token balances | `npx @chainstream-io\u002Fcli wallet holdings --chain sol --address ADDR` | `wallets_profile` | [wallet-profiling.md](references\u002Fwallet-profiling.md) |\n| Transfer history | `npx @chainstream-io\u002Fcli wallet activity --chain sol --address ADDR` | `wallets_activity` | [wallet-profiling.md](references\u002Fwallet-profiling.md) |\n| Own wallet balance (base\u002Fsol) | `npx @chainstream-io\u002Fcli wallet balance --chain sol` | — | Supports `sol` and `base` (note: `base` is a payment chain, not a data chain) |\n\n### Subscription\n\n| Intent | CLI Command | MCP Tool | Reference |\n|--------|-------------|----------|-----------|\n| **Check current subscription** | `npx @chainstream-io\u002Fcli plan status` | — | [x402-payment.md](..\u002Fshared\u002Fx402-payment.md) |\n| Check subscription (explicit) | `npx @chainstream-io\u002Fcli plan status --chain evm --address ADDR` | — | [x402-payment.md](..\u002Fshared\u002Fx402-payment.md) |\n| View available plans | `npx @chainstream-io\u002Fcli wallet pricing` | — | [x402-payment.md](..\u002Fshared\u002Fx402-payment.md) |\n| **Purchase plan (non-interactive)** | `npx @chainstream-io\u002Fcli plan purchase --plan \u003CNAME> --json` | — | [x402-payment.md](..\u002Fshared\u002Fx402-payment.md) |\n| Check subscription (API) | `curl \"https:\u002F\u002Fapi.chainstream.io\u002Fx402\u002Fstatus?chain=evm&address=ADDR\"` | — | [x402-payment.md](..\u002Fshared\u002Fx402-payment.md) |\n\n## Quickstart\n\n```bash\nnpx @chainstream-io\u002Fcli login                                              # Auth (one-time)\nnpx @chainstream-io\u002Fcli token search --keyword PUMP --chain sol            # Search tokens\nnpx @chainstream-io\u002Fcli token info --chain sol --address \u003Caddr> --json     # Token detail (single-line JSON for piping)\n```\n\nAll commands from the Endpoint Selector tables above work after `login`. Append `--json` for machine-readable output.\n\n**Default limit**: All list queries (`token search`, `token holders`, `token candles`, `market trending`, `market new`, `market trades`, `wallet holdings`, `wallet activity`) default to **5 results**. Pass `--limit \u003Cn>` to override (e.g. `--limit 20`).\n\n## AI Workflows\n\n### Token Research Flow\n\n```\nnpx @chainstream-io\u002Fcli token search → npx @chainstream-io\u002Fcli token info → npx @chainstream-io\u002Fcli token security\n→ npx @chainstream-io\u002Fcli token holders → npx @chainstream-io\u002Fcli token candles\n```\n\nBefore recommending any token, always run `token security` — ChainStream's risk model covers honeypot, rug pull, mint authority, freeze authority, and holder concentration.\n\n### Market Discovery Flow\n\n**MANDATORY - READ**: Before executing this workflow, load [`references\u002Fmarket-discovery.md`](references\u002Fmarket-discovery.md) for the multi-factor signal weight table and output format.\n\n```\nnpx @chainstream-io\u002Fcli market trending (top 50)\n→ AI multi-factor analysis (smart money, volume, momentum, safety)\n→ npx @chainstream-io\u002Fcli token security (top 5 candidates)\n→ Present results to user\n→ If user wants to trade → load chainstream-defi skill\n```\n\n**Do NOT load** wallet-profiling.md for this workflow.\n\n### Wallet Profiling Flow\n\n**MANDATORY - READ**: Load [`references\u002Fwallet-profiling.md`](references\u002Fwallet-profiling.md) for PnL interpretation and behavior patterns.\n\n```\nnpx @chainstream-io\u002Fcli wallet profile → npx @chainstream-io\u002Fcli wallet activity\n→ npx @chainstream-io\u002Fcli token info (on top holdings)\n→ Assess: win rate, concentration, holding behavior\n```\n\n## NEVER Do\n\n- NEVER answer \"what's the price of X\" from training data — always make a live CLI\u002FAPI call; crypto prices are stale within seconds\n- NEVER skip `token security` before recommending a token — ChainStream's risk model covers honeypot, rug pull, and concentration signals that generic analysis misses\n- NEVER pass `format: \"detailed\"` to MCP tools unless user explicitly requests it — returns 4-10x more tokens than default `concise`, wastes context window\n- NEVER batch more than 50 addresses in `\u002Fmulti` endpoints — API hard limit\n- NEVER use public RPC or third-party data providers as substitutes — results differ and miss ChainStream-specific enrichments (security scores, smart money tags)\n- NEVER omit `--limit` on list queries — CLI defaults to 5 results to prevent context overflow. If the user needs more, pass `--limit \u003Cn>` explicitly (e.g. `--limit 20`)\n- NEVER run data commands (token\u002Fmarket\u002Fwallet) without ensuring user is logged in and has an active subscription — run `config auth` → `login` (if needed) → `plan status` first. New users get a free nano trial on login; only run `plan purchase` if the trial is exhausted or absent\n\n## Error Recovery\n\n| Error | Meaning | Recovery |\n|-------|---------|----------|\n| \"Not authenticated\" \u002F 401 \u002F 402 | Not logged in, no API Key, or no active subscription | Follow the 401\u002F402 sequence below |\n| 429 | Rate limit | Wait 1s, exponential backoff |\n| 5xx | Server error | Retry once after 2s |\n\nOn 401\u002F402, follow this exact sequence:\n1. **Check login**: `npx @chainstream-io\u002Fcli config auth` — if not logged in, run `npx @chainstream-io\u002Fcli login` (creates wallet + auto-grants nano trial with 50K CU free). After login, retry the failed command — it will likely succeed now\n2. **Check subscription**: `npx @chainstream-io\u002Fcli plan status` — if `active: true` with remaining quota, the issue is likely a transient auth error; retry\n3. **If logged in but no subscription**: ask the user \"Do you have a ChainStream API Key?\" — if yes, `config set --key apiKey --value \u003Ckey>` and retry; if no, run `npx @chainstream-io\u002Fcli wallet pricing`, **present ALL plans to the user**, let them choose, then load [`shared\u002Fx402-payment.md`](..\u002Fshared\u002Fx402-payment.md) for the purchase flow. **NEVER auto-select a plan. NEVER try to pipe input to interactive CLI prompts.**\n\n## Skill Map\n\n| Reference | Content | When to Load |\n|-----------|---------|--------------|\n| [token-research.md](references\u002Ftoken-research.md) | 25+ token endpoints, batch queries, security field meanings | Token analysis tasks |\n| [market-discovery.md](references\u002Fmarket-discovery.md) | Ranking\u002Ftrade endpoints, multi-factor discovery workflow | Hot token discovery |\n| [wallet-profiling.md](references\u002Fwallet-profiling.md) | 15+ wallet endpoints, PnL logic, behavior patterns | Wallet analysis |\n| [websocket-streams.md](references\u002Fwebsocket-streams.md) | Channels, subscription format, heartbeat | Real-time streaming |\n\n## Related Skills\n\n- [chainstream-graphql](..\u002Fchainstream-graphql\u002F) — When standard REST\u002FMCP endpoints aren't enough: custom GraphQL queries with cross-cube JOINs, aggregations, and complex filters on 27 on-chain cubes\n- [chainstream-defi](..\u002Fchainstream-defi\u002F) — When analysis leads to action: swap, launchpad, transaction signing and broadcast\n",{"name":5,"description":7},"master","4aa004da461d820f4ea5499e58eb8d196cf99016","community\u002Fclawhub\u002Fc\u002Fchainstream-data",0,"https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge","https:\u002F\u002Fskill-explorer-rho.vercel.app","https:\u002F\u002Fgithub.com\u002FLord1Egypt","Unbreakable. Unstoppable. Unmatched⚡.\r\n Speaker of machine tongues 🤖  | World-builder of decentralized dreams 🌐 | Defender of the digital realm🛡️.","2026-06-10 08:21:01",{"source":8,"skillName":5,"commands":34,"prompt":44,"zipAvailable":45},[35,38,41],{"tool":36,"command":37},"npx","npx skills add Lord1Egypt\u002Fawesome-skill-forge --skill chainstream-data",{"tool":39,"command":40},"bunx","bunx skills add Lord1Egypt\u002Fawesome-skill-forge --skill chainstream-data",{"tool":42,"command":43},"pnpm","pnpm dlx skills add Lord1Egypt\u002Fawesome-skill-forge --skill chainstream-data","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge\u002Fblob\u002Fmaster\u002Fcommunity\u002Fclawhub\u002Fc\u002Fchainstream-data\u002FSKILL.md",true,[],[48,56,63,70,77,84],{"skillNo":49,"name":50,"nameZh":6,"description":51,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":52,"categories":53,"keywords":54,"publishedAt":55},"01M785WKJB99G3STR1NF9NRTJW","youtube-content","YouTube transcripts to summaries, threads, blogs.","https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge\u002Fblob\u002Fmaster\u002Fskills\u002Fyoutube-content\u002FSKILL.md",[],[],"2026-11-15 14:19:17",{"skillNo":57,"name":58,"nameZh":6,"description":59,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":60,"categories":61,"keywords":62,"publishedAt":55},"01M785WEFHB0G2S9YA6EPR3H0E","xurl","X\u002FTwitter via xurl CLI: post, search, DM, media, v2 API.","https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge\u002Fblob\u002Fmaster\u002Fskills\u002Fxurl\u002FSKILL.md",[],[],{"skillNo":64,"name":65,"nameZh":6,"description":66,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":67,"categories":68,"keywords":69,"publishedAt":55},"01M785W98EDN4EFJXJPMQEHCRC","touchdesigner-mcp","Control a running TouchDesigner instance via twozero MCP — create operators, set parameters, wire connections, execute Python, build real-time visuals. 36 native tools.","https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge\u002Fblob\u002Fmaster\u002Fskills\u002Ftouchdesigner-mcp\u002FSKILL.md",[],[],{"skillNo":71,"name":72,"nameZh":6,"description":73,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":74,"categories":75,"keywords":76,"publishedAt":55},"01M785W5S9FP3QBH2V191E025P","test-driven-development","TDD: enforce RED-GREEN-REFACTOR, tests before code.","https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge\u002Fblob\u002Fmaster\u002Fskills\u002Ftest-driven-development\u002FSKILL.md",[],[],{"skillNo":78,"name":79,"nameZh":6,"description":80,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":81,"categories":82,"keywords":83,"publishedAt":55},"01M785W2AS08NSSH9YATCV6FJB","teams-meeting-pipeline","Operate the Teams meeting summary pipeline via Hermes CLI — summarize meetings, inspect pipeline status, replay jobs, manage Microsoft Graph subscriptions.","https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge\u002Fblob\u002Fmaster\u002Fskills\u002Fteams-meeting-pipeline\u002FSKILL.md",[],[],{"skillNo":85,"name":86,"nameZh":6,"description":87,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":88,"categories":89,"keywords":90,"publishedAt":55},"01M785VXKW4T34BTP1SCHW1R7F","systematic-debugging","4-phase root cause debugging: understand bugs before fixing.","https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge\u002Fblob\u002Fmaster\u002Fskills\u002Fsystematic-debugging\u002FSKILL.md",[],[]]