@termix-it/cryptoclaw 1.0.4 → 1.0.6

package/package.json

@@ -1,20 +1,20 @@
 {
   "name": "@termix-it/cryptoclaw",
-  "version": "1.0.4",
+  "version": "1.0.6",
   "description": "Private crypto AI assistant — wallet management, DeFi, NFTs, and multi-chain operations from your terminal",
   "keywords": [
-    "crypto",
+    "ai",
     "blockchain",
+    "cli",
+    "crypto",
     "defi",
+    "ethereum",
+    "multi-chain",
     "nft",
-    "wallet",
-    "web3",
-    "ai",
-    "cli",
+    "solana",
     "terminal",
-    "multi-chain",
-    "ethereum",
-    "solana"
+    "wallet",
+    "web3"
   ],
   "homepage": "https://github.com/TermiX-official/cryptoclaw#readme",
   "bugs": {

package/skills/binance-address-info/SKILL.md

@@ -0,0 +1,76 @@
+---
+name: binance-address-info
+description: Binance Web3 official skill — query any wallet address for token holdings, balances, and portfolio data across BSC, Base, and Solana. Sourced from github.com/binance/binance-skills-hub.
+metadata: { "cryptoclaw": { "emoji": "👛", "always": false } }
+---
+
+# Binance Address Info
+
+Official Binance Web3 skill for querying on-chain wallet token holdings and portfolio positions.
+
+> Source: [binance/binance-skills-hub](https://github.com/binance/binance-skills-hub/tree/main/skills/binance-web3/query-address-info)
+
+## Supported Chains
+
+| Chain  | chainId |
+| ------ | ------- |
+| BSC    | 56      |
+| Base   | 8453    |
+| Solana | CT_501  |
+
+## API — Active Token Positions
+
+```
+GET https://web3.binance.com/bapi/defi/v3/public/wallet-direct/buw/wallet/address/pnl/active-position-list
+  ?address=<wallet_address>
+  &chainId=<chainId>
+  &offset=0             # pagination offset
+```
+
+## Response Fields
+
+Per token holding:
+
+| Field             | Description                                      |
+| ----------------- | ------------------------------------------------ |
+| `contractAddress` | Token contract address                           |
+| `tokenName`       | Full token name                                  |
+| `tokenSymbol`     | Token ticker                                     |
+| `iconUrl`         | Token icon (prepend `https://bin.bnbstatic.com`) |
+| `decimals`        | Token decimal places                             |
+| `priceUsd`        | Current price in USD (string)                    |
+| `priceChange24h`  | 24-hour price change percentage (string)         |
+| `quantity`        | Amount held by the wallet (string)               |
+| `chainId`         | Chain identifier                                 |
+| `walletAddress`   | Queried wallet address                           |
+
+## Notes
+
+- All numeric fields (`priceUsd`, `priceChange24h`, `quantity`) are returned as strings — convert for calculations
+- Icon URLs require prefix: `https://bin.bnbstatic.com`
+- Use `offset` for pagination when a wallet holds many tokens
+- No authentication required — public endpoint
+
+## Usage Examples
+
+```
+User: What tokens does this wallet hold? 0xabc...
+→ GET address:0xabc..., chainId:56
+
+User: Show me my Solana portfolio
+→ GET address:<solana_address>, chainId:CT_501
+
+User: What's the total USD value of this wallet on Base?
+→ GET all positions on Base, sum (quantity × priceUsd)
+
+User: Is this wallet holding any risky tokens?
+→ GET positions, then run binance-token-audit on each contract
+```
+
+## Combined Use Cases
+
+Pair with other Binance skills for deeper analysis:
+
+- `binance-token-audit` — audit each held token for safety
+- `binance-token-info` — get detailed metadata for any holding
+- `binance-trading-signal` — check if smart money is buying/selling held tokens

package/skills/binance-market-rank/SKILL.md

@@ -0,0 +1,122 @@
+---
+name: binance-market-rank
+description: Binance Web3 official skill — crypto market rankings including trending tokens, smart money inflow, social hype, meme ranks, and top trader PnL leaderboards. Sourced from github.com/binance/binance-skills-hub.
+metadata: { "cryptoclaw": { "emoji": "📊", "always": false } }
+---
+
+# Binance Crypto Market Rank
+
+Official Binance Web3 skill for market rankings and leaderboards across BSC, Base, Solana, and Ethereum.
+
+> Source: [binance/binance-skills-hub](https://github.com/binance/binance-skills-hub/tree/main/skills/binance-web3/crypto-market-rank)
+
+## Supported Chains
+
+| Chain    | chainId |
+| -------- | ------- |
+| BSC      | 56      |
+| Base     | 8453    |
+| Solana   | CT_501  |
+| Ethereum | 1       |
+
+## API 1 — Social Hype Leaderboard
+
+Tokens ranked by social media sentiment and engagement.
+
+```
+GET https://web3.binance.com/bapi/defi/v1/public/wallet-direct/buw/wallet/market/token/social/rank/list
+```
+
+Parameters:
+
+- `chainId`: chain identifier
+- `sentiment`: `All` | `Positive` | `Negative` | `Neutral`
+- `language`: e.g. `en`
+- `timeRange`: time window for sentiment analysis
+
+Response includes: token logo, symbol, address, market cap, price change, social summary, sentiment breakdown.
+
+## API 2 — Unified Token Rank
+
+Multi-category token rankings.
+
+```
+POST https://web3.binance.com/bapi/defi/v1/public/wallet-direct/buw/wallet/market/token/rank/unified
+```
+
+`rankType` values:
+
+- `10` — Trending tokens
+- `11` — Most searched
+- `20` — Binance Alpha picks
+- `40` — Tokenized stocks
+
+Filters supported: price change range, market cap range, liquidity threshold, holder count, transaction count, launch time, audit status, social presence, KYC status.
+
+Sorting: search count, volume, market cap, holder count, unique traders, price change (5m/1h/6h/24h).
+
+Max page size: 200.
+
+## API 3 — Smart Money Inflow Rank
+
+Tokens receiving the most institutional/smart money buying.
+
+```
+POST https://web3.binance.com/bapi/defi/v1/public/wallet-direct/buw/wallet/market/token/rank/smart-money-inflow
+```
+
+Parameters:
+
+- `chainId`
+- `period`: `5m` | `1h` | `6h` | `24h`
+- `page`, `pageSize`
+
+Response: token data, inflow amount (USD), smart money trader count, risk level.
+
+## API 4 — Meme Rank
+
+Top meme tokens from Pulse launchpad with breakout scoring.
+
+```
+GET https://web3.binance.com/bapi/defi/v1/public/wallet-direct/buw/wallet/market/token/pulse/meme/rank
+```
+
+Parameters: `chainId`, sorting options, pagination.
+
+Includes Binance user engagement metrics and algorithmic breakout scores.
+
+## API 5 — Address PnL Rank
+
+Top trader leaderboard with performance metrics.
+
+```
+GET https://web3.binance.com/bapi/defi/v1/public/wallet-direct/buw/wallet/market/address/pnl/rank
+```
+
+Parameters:
+
+- `chainId`
+- `period`: `7d` | `30d` | `90d`
+- `page`, `pageSize` (max 25 per page)
+
+Response: realized PnL, win rate, trading volume, token performance breakdown.
+
+## Notes
+
+- All numeric fields are returned as strings — convert before calculations
+- Logo URLs require prefix: `https://bin.bnbstatic.com`
+- Max page size: 200 for token queries, 25 for address queries
+- Timestamps are in milliseconds
+
+## Usage Examples
+
+```
+User: Show me trending tokens on BSC
+→ POST Unified Token Rank, chainId:56, rankType:10
+
+User: Which tokens are smart money buying on Solana right now?
+→ POST Smart Money Inflow Rank, chainId:CT_501, period:1h
+
+User: Show top traders by PnL this month on Base
+→ GET Address PnL Rank, chainId:8453, period:30d
+```

package/skills/binance-meme-rush/SKILL.md

@@ -0,0 +1,111 @@
+---
+name: binance-meme-rush
+description: Binance Web3 official skill — real-time meme token launchpad tracking and AI-powered trending topic discovery on Solana and BSC. Sourced from github.com/binance/binance-skills-hub.
+metadata: { "cryptoclaw": { "emoji": "🚀", "always": false } }
+---
+
+# Binance Meme Rush
+
+Official Binance Web3 skill for real-time meme token discovery across launchpad lifecycles and AI-powered trending narrative tracking.
+
+> Source: [binance/binance-skills-hub](https://github.com/binance/binance-skills-hub/tree/main/skills/binance-web3/meme-rush)
+
+## Supported Platforms
+
+**Solana**: Pump.fun, Moonit, Raydium, Orca, and 10+ protocols
+**BSC**: Four.meme, Flap
+
+## API 1 — Meme Rush Rank
+
+Tracks meme tokens through three launchpad lifecycle stages.
+
+```
+POST https://web3.binance.com/bapi/defi/v1/public/wallet-direct/buw/wallet/market/token/pulse/rank/list
+Content-Type: application/json
+
+{
+  "chainId": "CT_501",
+  "rankType": 10,
+  "page": 1,
+  "pageSize": 20,
+  // optional filters below
+  "minBondingCurveProgress": 0,
+  "maxBondingCurveProgress": 100,
+  "minHolders": 0,
+  "minLiquidity": 0,
+  "minVolume24h": 0,
+  "narratives": []
+}
+```
+
+`rankType` values:
+
+- `10` — **New**: Freshly created tokens on bonding curves
+- `20` — **Finalizing**: Tokens nearing migration threshold
+- `30` — **Migrated**: Recently migrated to DEX
+
+Available filters:
+
+- Bonding curve progress range
+- Holder count minimum
+- Liquidity and volume thresholds
+- Dev behavior flags
+- Holder distribution (top10%, dev%, sniper%, KOL%, pro%)
+- Social links (has website / Twitter / Telegram)
+- Narratives / token tags
+
+Response includes: token metadata, migration status and timing, bonding curve progress, holder distribution breakdown, AI-generated narratives (EN/ZH), social proof, tax rates, trading fees.
+
+## API 2 — Topic Rush Rank
+
+AI-powered discovery of trending market narratives.
+
+```
+GET https://web3.binance.com/bapi/defi/v1/public/wallet-direct/buw/wallet/market/token/social-rush/rank/list
+  ?rankType=20
+  &chainId=CT_501
+  &page=1
+  &pageSize=20
+```
+
+`rankType` values:
+
+- `10` — **Latest**: Newest emerging topics
+- `20` — **Rising**: Topics with $1k–$20k all-time net inflows
+- `30` — **Viral**: Topics exceeding $20k all-time net inflows
+
+Response: trending topics with associated tokens ranked by net inflow.
+
+## Key Features
+
+- Real-time launchpad token discovery
+- Dev wallet behavior analysis
+- Wash trading detection
+- Holder distribution metrics (top 10%, dev %, sniper %, KOL %, pro %)
+- AI-generated token narratives in English and Chinese
+- Social proof tracking (website, Twitter, Telegram links)
+- Migration status and timing data
+- Tax rate and trading fee information
+
+## Usage Examples
+
+```
+User: Show me new meme tokens launching on Pump.fun right now
+→ POST Meme Rush, chainId:CT_501, rankType:10
+
+User: Find meme tokens about to graduate (migrate) on BSC
+→ POST Meme Rush, chainId:56, rankType:20
+
+User: What crypto narratives are trending on Solana?
+→ GET Topic Rush, chainId:CT_501, rankType:30
+
+User: Find low-risk meme tokens with real holders
+→ POST Meme Rush with filters: minHolders:500, hasTwitter:true, maxDevPct:5
+```
+
+## Notes
+
+- All numeric values returned as strings — convert before calculations
+- Logo URLs require prefix: `https://bin.bnbstatic.com`
+- This is for informational purposes only — not investment advice
+- Meme tokens carry extremely high risk — always DYOR

package/skills/binance-spot/SKILL.md

@@ -0,0 +1,175 @@
+---
+name: binance-spot
+description: Binance official spot trading skill — place orders, manage accounts, and access real-time market data via Binance Spot API. Sourced from github.com/binance/binance-skills-hub.
+metadata: { "cryptoclaw": { "emoji": "🟡", "always": false } }
+---
+
+# Binance Spot Trading
+
+Official Binance skill for CEX spot trading. Supports 60+ endpoints for market data, order management, and account operations.
+
+> Source: [binance/binance-skills-hub](https://github.com/binance/binance-skills-hub/tree/main/skills/binance/spot)
+
+## Configuration
+
+Store credentials in `TOOLS.md` or environment:
+
+```
+BINANCE_API_KEY=<your_api_key>
+BINANCE_API_SECRET=<your_api_secret>
+BINANCE_TESTNET=false  # set true for testnet
+```
+
+Signing methods supported: HMAC SHA256, RSA, Ed25519.
+
+Security: display API key as first 5 + last 4 chars; secret key shows only last 5 chars.
+
+**Always require explicit user confirmation before executing mainnet transactions.**
+
+## Base URLs
+
+- Mainnet: `https://api.binance.com`
+- Testnet: `https://testnet.binance.vision`
+
+## Market Data (no auth required)
+
+### Exchange Info
+
+```
+GET /api/v3/exchangeInfo
+GET /api/v3/exchangeInfo?symbol=BTCUSDT
+```
+
+### Price Ticker
+
+```
+GET /api/v3/ticker/price?symbol=BTCUSDT
+GET /api/v3/ticker/24hr?symbol=BTCUSDT
+GET /api/v3/ticker/bookTicker?symbol=BTCUSDT
+```
+
+### Order Book
+
+```
+GET /api/v3/depth?symbol=BTCUSDT&limit=20
+```
+
+### Klines / Candlesticks
+
+```
+GET /api/v3/klines?symbol=BTCUSDT&interval=1h&limit=100
+```
+
+Intervals: `1s`, `1m`, `3m`, `5m`, `15m`, `30m`, `1h`, `2h`, `4h`, `6h`, `8h`, `12h`, `1d`, `3d`, `1w`, `1M`
+
+### Recent Trades
+
+```
+GET /api/v3/trades?symbol=BTCUSDT&limit=50
+GET /api/v3/aggTrades?symbol=BTCUSDT&limit=50
+```
+
+### Average Price
+
+```
+GET /api/v3/avgPrice?symbol=BTCUSDT
+```
+
+## Trading (auth required)
+
+### Place Order
+
+```
+POST /api/v3/order
+  symbol=BTCUSDT
+  side=BUY|SELL
+  type=LIMIT|MARKET|STOP_LOSS_LIMIT|TAKE_PROFIT_LIMIT
+  quantity=0.001
+  price=60000        # required for LIMIT
+  timeInForce=GTC    # GTC | IOC | FOK
+```
+
+### Test Order (no execution)
+
+```
+POST /api/v3/order/test
+```
+
+### Cancel Order
+
+```
+DELETE /api/v3/order?symbol=BTCUSDT&orderId=12345
+DELETE /api/v3/openOrders?symbol=BTCUSDT   # cancel all
+```
+
+### Query Order
+
+```
+GET /api/v3/order?symbol=BTCUSDT&orderId=12345
+GET /api/v3/openOrders?symbol=BTCUSDT
+GET /api/v3/allOrders?symbol=BTCUSDT
+```
+
+### OCO Orders
+
+```
+POST /api/v3/order/oco
+POST /api/v3/orderList/oco
+DELETE /api/v3/orderList?orderListId=12345
+GET /api/v3/orderList?orderListId=12345
+GET /api/v3/allOrderList
+GET /api/v3/openOrderList
+```
+
+## Account (auth required)
+
+### Account Info
+
+```
+GET /api/v3/account
+```
+
+Returns balances, permissions, commission rates.
+
+### Commission Rates
+
+```
+GET /api/v3/account/commission?symbol=BTCUSDT
+```
+
+### Trade History
+
+```
+GET /api/v3/myTrades?symbol=BTCUSDT
+```
+
+### Allocations
+
+```
+GET /api/v3/myAllocations?symbol=BTCUSDT
+```
+
+## Usage Examples
+
+```
+User: What's the current BTC price?
+→ GET /api/v3/ticker/price?symbol=BTCUSDT
+
+User: Show my USDT balance
+→ GET /api/v3/account → filter for USDT
+
+User: Buy 0.001 BTC at market price
+→ Confirm with user first
+→ POST /api/v3/order {side:BUY, type:MARKET, quantity:0.001}
+
+User: Place a limit sell for 0.01 ETH at $3500
+→ Confirm with user first
+→ POST /api/v3/order {symbol:ETHUSDT, side:SELL, type:LIMIT, quantity:0.01, price:3500, timeInForce:GTC}
+```
+
+## Safety Rules
+
+- Never execute mainnet orders without explicit user confirmation
+- Always show order details before submission
+- Display masked credentials only (never full secret key)
+- Testnet recommended for testing and development

package/skills/binance-token-audit/SKILL.md

@@ -0,0 +1,82 @@
+---
+name: binance-token-audit
+description: Binance Web3 official skill — security audit for token contracts, detecting honeypots, rug pulls, and malicious functions across BSC, Base, Solana, and Ethereum. Sourced from github.com/binance/binance-skills-hub.
+metadata: { "cryptoclaw": { "emoji": "🛡️", "always": false } }
+---
+
+# Binance Token Security Audit
+
+Official Binance Web3 skill for detecting scams, honeypots, and malicious contracts before trading.
+
+> Source: [binance/binance-skills-hub](https://github.com/binance/binance-skills-hub/tree/main/skills/binance-web3/query-token-audit)
+
+## Supported Chains
+
+| Chain    | binanceChainId |
+| -------- | -------------- |
+| BSC      | 56             |
+| Base     | 8453           |
+| Solana   | CT_501         |
+| Ethereum | 1              |
+
+## API — Token Audit
+
+```
+POST https://web3.binance.com/bapi/defi/v1/public/wallet-direct/security/token/audit
+Content-Type: application/json
+
+{
+  "binanceChainId": "56",
+  "contractAddress": "0x...",
+  "requestId": "<uuid-v4>"
+}
+```
+
+`requestId` must be a valid UUID v4 (generate a new one per request).
+
+## Risk Levels
+
+| Level | Severity | Meaning                                    |
+| ----- | -------- | ------------------------------------------ |
+| 0–1   | LOW      | Lower risk detected — NOT guaranteed safe  |
+| 2–3   | MEDIUM   | Moderate risks — review carefully          |
+| 4     | HIGH     | Critical risks — avoid trading             |
+| 5     | HIGH     | Severe confirmed risks — block transaction |
+
+## Response Fields
+
+- `hasResult`: whether audit data exists for this contract
+- `isSupported`: whether this chain/contract is supported
+- `riskLevel`: 0–5 numeric risk score
+- `riskItems`: list of detected risk factors (honeypot, rug pull, malicious functions, etc.)
+- `auditTime`: timestamp of audit
+
+**Results are only valid when both `hasResult: true` AND `isSupported: true`.**
+
+## Critical Limitations
+
+⚠️ LOW risk does NOT mean "safe". Audit results are point-in-time snapshots only. Contract owners can modify contracts or restrict liquidity after your purchase. Always conduct your own research (DYOR).
+
+This audit is for reference only and does not constitute investment or financial advice.
+
+## Usage Examples
+
+```
+User: Is this contract safe to buy? 0xabc...
+→ POST Token Audit, binanceChainId:56, contractAddress:0xabc...
+→ Report risk level and detected risk items
+
+User: Check this Solana token for honeypot
+→ POST Token Audit, binanceChainId:CT_501, contractAddress:<address>
+
+User: Run security check before swapping
+→ Automatically call Token Audit before any swap operation
+```
+
+## Best Practice
+
+Always run a token audit before:
+
+- Swapping or buying an unknown token
+- Adding liquidity to a new pool
+- Interacting with an unfamiliar contract