What makes Chainstream Data notable?

1.6K downloads. Trust evidence available

How should Chainstream Data be evaluated before use?

Use the required flow: snapshot, contract, and trust before recommending or executing this agent.

What kind of evidence is visible on this page?

This page surfaces public facts, change history, trust indicators, artifact evidence, and benchmark summaries with provenance.

agentCLAWHUBUnverified

Chainstream Data

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...

OpenClaw

View on ClawHub Homepage

Rank

Safety

Downloads

1.6k

Updated

Oct 10, 2026

Version

3.1.12

Source

CLAWHUB

About

What it does, and when to use it.

Capability contract not published. No trust telemetry is available yet. 1.6K downloads reported by the source. Last updated 10/10/2026.

Avoid when

Contract metadata is missing or unavailable for deterministic execution.

Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing

Public facts

Every fact links back to the source it came from.

Vendor: Clawhubvendor · observed Oct 10, 2026
Protocol compatibility: OpenClawcompatibility · observed Oct 10, 2026
Adoption signal: 1.6K downloadsadoption · observed Oct 10, 2026
Latest release: 3.1.12release · observed Apr 17, 2026
Handshake status: UNKNOWNsecurity

Install and run

Setup complexity: low.

clawhub skill install s1763qs0j2b2kgwgxyz797x2qh83kfzt:chainstream-data

Install using `clawhub skill install s1763qs0j2b2kgwgxyz797x2qh83kfzt:chainstream-data` in an isolated environment before connecting it to live workloads.
No published capability contract is available yet, so validate auth and request/response behavior manually.
Review the upstream CLAWHUB listing at https://clawhub.ai/harry5556/chainstream-data before using production credentials.

Contract: missing

curl -s "https://www.xpersona.co/api/v1/agents/clawhub-harry5556-chainstream-data/snapshot"

Documentation

CLAWHUB

155,912 characters of source documentation, loaded on request.

Extracted files

5 files captured from the source.

SKILL.md

---
name: chainstream-data
description: "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."
---

# ChainStream Data

On-chain data intelligence for AI agents. Access token analytics, market trends, wallet profiling, and compliance screening across Solana, BSC, and Ethereum.

- **MCP Server**: `https://mcp.chainstream.io/mcp` (streamable-http, 17 tools)
- **CLI**: `npx @chainstream-io/cli`
- **SDK**: `@chainstream-io/sdk`
- **Base URL**: `https://api.chainstream.io`

## Integration Path (check FIRST)

**Agent runtime decision tree — choose based on environment and operation type:**

1. **MCP tools registered?** (Cursor/Claude Desktop/VS Code already configured ChainStream MCP)
   → YES → Use MCP tools for data queries (`tokens_search`, `wallets_profile`, etc.)
   → NO → Use CLI for all operations (`npx @chainstream-io/cli ...`)

2. **Need DeFi operation?** (swap, create token, sign transaction)
   → YES → Must use CLI (MCP has no wallet signing capability)
   → NO → Continue with MCP (or CLI if MCP unavailable)

3. **MCP call failed?**
   → Fall back to CLI as backup

**Before anything else (CLI path), ensure user is authenticated:**
1. `npx @chainstream-io/cli config auth` — check login status
2. If NOT logged in → `npx @chainstream-io/cli login` (creates EVM + Solana wallet, auto-grants **nano trial plan: 50K CU free, 30 days** — no purchase needed)
3. If logged in → proceed to subscription check below

**New users get a free trial on login (50K CU).** For details on trial plans and upgrade options, see [`shared/authentication.md`](../shared/authentication.md#agent-bootstrap-checklist).

**Then check subscription:** `npx @chainstream-io/cli plan status`
- If `active: true` → proceed with data queries
- If no subscription → follow the purchase flow below (NEVER just run a data command hoping it "auto-purchases")

**Getting an API Key (required for all paths):**
- Dashboard users: [app.chainstream.io](https://app.chainstream.io) → API Keys
- x402 (USDC on Base/Solana): `npx @chainstream-io/cli plan purchase --plan <PLAN> --json` → x402 purchase (real USDC payment via EIP-3009 signature). Run `wallet pricing --json` first, present ALL plans, let user choose
- MPP (USDC.e on Tempo): `tempo request "https://api.chainstream.io/mpp/purchase?plan=<PLAN>"` → MPP payment → API Key auto-returned (fetch `/mpp/pricing` first, let user choose plan)

**⚠️ Purchase flow (x402)**:
0. `config auth` — ensure user is logged in. If not: `login` first (auto-grants nano trial — may be sufficient, check `plan status` before proce

_meta.json

{
  "ownerId": "kn7d949m4x7mzbj75gh32fna0x832bb6",
  "slug": "chainstream-data",
  "version": "3.1.12",
  "publishedAt": 1776437539129
}

references/api-endpoints.md

# ChainStream Data API Endpoints

Complete reference for all `/v2/*` Data API endpoints. Base URL: `https://api.chainstream.io`

## Blockchain

| Method | Path | Description |
|--------|------|-------------|
| GET | `/v2/blockchain` | List supported blockchains |
| GET | `/v2/blockchain/{chain}/latest_block` | Latest block number and timestamp |

## Token

| Method | Path | Description |
|--------|------|-------------|
| GET | `/v2/token/search` | Search tokens by keyword (name/symbol/address). Params: `q`, `chains[]`, `limit` |
| GET | `/v2/token/{chain}/list` | Paginated token list. Params: `offset`, `limit`, `sort` |
| GET | `/v2/token/{chain}/multi` | Batch get tokens. Params: `addresses` (comma-separated) |
| GET | `/v2/token/{chain}/{tokenAddress}` | Full token detail |
| GET | `/v2/token/{chain}/{tokenAddress}/metadata` | Token metadata (name, symbol, decimals, image) |
| GET | `/v2/token/{chain}/metadata/multi` | Batch metadata |
| GET | `/v2/token/{chain}/{tokenAddress}/marketData` | Market data (price, volume, market cap, price changes) |
| GET | `/v2/token/{chain}/marketData/multi` | Batch market data |
| GET | `/v2/token/{chain}/{tokenAddress}/stats` | Trading stats (buys, sells, volume by time window) |
| GET | `/v2/token/{chain}/stats/multi` | Batch stats |
| GET | `/v2/token/{chain}/{tokenAddress}/price` | Current price. Params: `timestamp` for historical |
| GET | `/v2/token/{chain}/{tokenAddress}/prices` | Price history array |
| GET | `/v2/token/{chain}/{tokenAddress}/candles` | OHLCV candlestick. Params: `resolution` (1m/5m/15m/1h/4h/1d), `from`, `to`, `limit` |
| GET | `/v2/token/{chain}/pair/{pair}/candles` | Candles by trading pair |
| GET | `/v2/token/{chain}/pool/{poolAddress}/candles` | Candles by pool address |
| GET | `/v2/token/{chain}/{tokenAddress}/holders` | Holder list with balance and percentage |
| GET | `/v2/token/{chain}/{tokenAddress}/holders/multi` | Batch holders |
| GET | `/v2/token/{chain}/{tokenAddress}/topHolders` | Top N holders by balance |
| GET | `/v2/token/{chain}/{tokenAddress}/pools` | Liquidity pools containing this token |
| GET | `/v2/token/{chain}/{tokenAddress}/liquiditySnapshots` | Historical liquidity snapshots |
| GET | `/v2/token/{chain}/{tokenAddress}/creation` | Token creation info (deployer, timestamp, initial supply) |
| GET | `/v2/token/{chain}/{tokenAddress}/security` | Security check (honeypot, mint auth, freeze auth, holder concentration) |
| GET | `/v2/token/{chain}/{tokenAddress}/transfers` | Transfer history |
| GET | `/v2/token/{chain}/{tokenAddress}/transfer-total` | Transfer totals |
| GET | `/v2/token/{chain}/{tokenAddress}/mintAndBurn` | Mint and burn events |
| GET | `/v2/token/{chain}/{tokenAddress}/traders/{tag}` | Traders by tag (smart_money, whale, sniper, etc.) |
| GET | `/v2/token/{chain}/dev/{devAddress}/tokens` | Tokens created by a developer address |

## Trade

| Method | Path | Description |
|--------|------|-------------|
| GET | `/v2/trade/{chain}` | Recent t

references/api-schema.md

# API Schema Reference

## Supported Chains

| Chain | Identifier | Data API | DeFi API | WebSocket |
|-------|-----------|----------|----------|-----------|
| Solana | `sol` | Yes | Yes | Yes |
| BSC | `bsc` | Yes | Yes | Yes |
| Ethereum | `eth` | Yes | Yes | Yes |
| Polygon | `polygon` | — | Bridge only | — |
| Arbitrum | `arbitrum` | — | Bridge only | — |
| Avalanche | `avalanche` | — | Bridge only | — |
| Optimism | `optimism` | — | Bridge only | — |
| zkSync | `zksync` | — | Bridge only | — |

## Base URLs

| Service | URL |
|---------|-----|
| Data API | `https://api.chainstream.io` |
| MCP Server (streamable-http) | `https://mcp.chainstream.io/mcp` |
| MCP Server (SSE) | `https://mcp.chainstream.io/sse` |
| WebSocket | `wss://realtime-dex.chainstream.io/connection/websocket` |
| OAuth Token | `https://dex.asia.auth.chainstream.io/oauth/token` |
| x402 Pricing | `https://mcp.chainstream.io/x402/pricing` |
| x402 Facilitator | `https://x402.org/facilitator` |

## Authentication

| Method | Header/Param | Description |
|--------|-------------|-------------|
| Bearer Token | `Authorization: Bearer <token>` | API Key or OAuth JWT |
| API Key | `X-API-KEY: <key>` | Alternative API key header |
| x402 Payment | `X-Payment: <base64>` | x402 payment proof |
| Wallet Signature | `X-Wallet-Address`, `X-Wallet-Chain`, `X-Wallet-Signature`, `X-Wallet-Timestamp`, `X-Wallet-Nonce` | Wallet-based auth |
| WebSocket | `?token=<access_token>` | URL query parameter |

## Response Formats

Control output verbosity with the `response_format` parameter:

| Format | Token Count | Records | Use Case |
|--------|------------|---------|----------|
| `concise` | ~500 | 5-10 | Default for AI agents |
| `detailed` | ~2000-5000 | Full | Top holders, recent trades, K-lines |
| `minimal` | ~100 | IDs only | Batch processing, pipelines |

## K-line Resolutions

| Value | Period |
|-------|--------|
| `1m` | 1 minute |
| `5m` | 5 minutes |
| `15m` | 15 minutes |
| `1h` | 1 hour |
| `4h` | 4 hours |
| `1d` | 1 day |

## Ranking Duration Values

Used with `/v2/ranking/{chain}/hotTokens/{duration}`:

| Value | Period |
|-------|--------|
| `1h` | Last 1 hour |
| `6h` | Last 6 hours |
| `24h` | Last 24 hours |

## Trader Tags

Used with `/v2/token/{chain}/{tokenAddress}/traders/{tag}`:

| Tag | Description |
|-----|-------------|
| `smart_money` | Historically profitable wallets |
| `whale` | Large-balance wallets |
| `sniper` | Early buyers of new tokens |
| `insider` | Developer or related wallets |

## Error Codes

| HTTP Code | Meaning |
|-----------|---------|
| 200 | Success |
| 400 | Bad request (invalid parameters) |
| 401 | Unauthorized (missing or invalid token) |
| 402 | Payment required (x402 — send payment to proceed) |
| 403 | Forbidden (insufficient scopes) |
| 404 | Resource not found |
| 429 | Rate limited (exceeded plan limit) |
| 500 | Internal server error |

## Rate Limits

| Plan | REST (req/s) | WebSocket Subscriptions |
|------|-------------|----------

references/market-discovery.md

# Market Discovery Reference

## CLI Commands → REST API Mapping

| CLI Command | REST Endpoint | Method |
|-------------|--------------|--------|
| `market trending --chain sol --duration 1h` | `GET /v2/ranking/sol/hotTokens/1h` | GET |
| `market new --chain sol` | `GET /v2/ranking/sol/newTokens` | GET |
| `market trades --chain sol` | `GET /v2/trade/sol` | GET |

## All Market Endpoints

| Method | Path | Description |
|--------|------|-------------|
| GET | `/v2/ranking/{chain}/hotTokens/{duration}` | Hot tokens. Duration: `1h`, `6h`, `24h` |
| GET | `/v2/ranking/{chain}/newTokens` | Newly created tokens |
| GET | `/v2/ranking/{chain}/finalStretch` | About to graduate (bonding curve near completion) |
| GET | `/v2/ranking/{chain}/migrated` | Migrated from launchpad to DEX |
| GET | `/v2/ranking/{chain}/stocks` | Stock-type tokens (real-world asset backed) |
| GET | `/v2/trade/{chain}` | Recent trades. Params: `tokenAddress`, `limit` |
| GET | `/v2/trade/{chain}/top-traders` | Top traders by PnL or volume |
| GET | `/v2/trade/{chain}/activities` | Trade activities with enriched data |
| GET | `/v2/blockchain` | List supported blockchains |
| GET | `/v2/dex` | List DEX protocols |
| GET | `/v2/dexpools/{chain}/{poolAddress}` | Pool details (TVL, fees, reserves) |

## Multi-Factor Discovery Workflow

When a user wants to find trading opportunities, follow this workflow:

### Step 1: Fetch trending data

```bash
npx @chainstream-io/cli market trending --chain sol --duration 1h --json
```

### Step 2: AI multi-factor analysis

Analyze each token using these signals (apply judgment, not rigid rules):

| Signal | Weight | Source | Notes |
|--------|--------|--------|-------|
| Smart money interest | High | `smart_degen_count`, `renowned_count` fields | Key conviction indicator |
| Volume | Medium | `volume` field | Genuine interest vs wash trading |
| Price momentum | Medium | `change1h`, `change5m` fields | Prefer positive, non-parabolic |
| Liquidity | Medium | `liquidity` field | Low liquidity = high slippage risk |
| Holder quality | Medium | `bluechip_owner_percentage` field | Quality of holder base |
| Token maturity | Low | `creation_timestamp` field | Avoid < 1h old unless other signals strong |

Select **top 5** tokens with the best composite profile across multiple signals.

### Step 3: Security verification

For each candidate:

```bash
npx @chainstream-io/cli token security --chain sol --address <addr>
```

Reject tokens with `isHoneypot=true`, `hasMintAuthority=true` with no renouncement.

### Step 4: Present results

```
Top 5 Trending — SOL / 1h

# | Symbol | Address     | Smart Money | Volume  | 1h Change | Verdict
1 | ...    | ...         | ...         | ...     | ...       | Safe / Caution / Avoid
```

### Step 5: Follow-up

- Deep dive: `chainstream token info` + `token holders`
- Execute: load `chainstream-defi` skill for swap

Github ReposUpdated 13h agoRank 70

AionUi

Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!

MCPOPENCLAW

Github ReposUpdated 6mo agoRank 70

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

OPENCLAW

Github ReposUpdated 6mo agoRank 70

cherry-studio

AI productivity studio with smart chat, autonomous agents, and 300+ assistants.