@termix-it/cryptoclaw 1.0.3 → 1.0.5

package/skills/binance-spot/SKILL.md

@@ -0,0 +1,158 @@
+---
+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,81 @@
+---
+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

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

@@ -0,0 +1,112 @@
+---
+name: binance-token-info
+description: Binance Web3 official skill — search tokens, retrieve metadata, real-time market data, and candlestick charts across BSC, Base, and Solana. Sourced from github.com/binance/binance-skills-hub.
+metadata: { "cryptoclaw": { "emoji": "🔍", "always": false } }
+---
+
+# Binance Token Info
+
+Official Binance Web3 skill for querying token details, market data, and price charts.
+
+> Source: [binance/binance-skills-hub](https://github.com/binance/binance-skills-hub/tree/main/skills/binance-web3/query-token-info)
+
+## Supported Chains
+
+| Chain  | chainId | K-Line platform |
+|--------|---------|-----------------|
+| BSC    | 56      | bsc             |
+| Base   | 8453    | base            |
+| Solana | CT_501  | solana          |
+
+## API 1 — Token Search
+
+Search tokens by name, symbol, or contract address.
+
+```
+GET https://web3.binance.com/bapi/defi/v1/public/wallet-direct/buw/wallet/token/search
+  ?keyword=<name|symbol|address>
+  &chainId=<chainId>          # optional, omit for all chains
+  &sortBy=volume              # optional
+  &page=1
+  &pageSize=20
+```
+
+Response: token list with name, symbol, contract address, chain, price, volume.
+
+## API 2 — Token Metadata
+
+Static token information.
+
+```
+GET https://web3.binance.com/bapi/defi/v1/public/wallet-direct/buw/wallet/token/metadata
+  ?contractAddress=<address>
+  &chainId=<chainId>
+```
+
+Response includes:
+- Name, symbol, logo URL
+- Social links (website, Twitter, Telegram)
+- Creator address
+- Audit status
+- Project description
+
+## API 3 — Token Dynamic Data
+
+Real-time market metrics.
+
+```
+GET https://web3.binance.com/bapi/defi/v1/public/wallet-direct/buw/wallet/token/dynamic
+  ?contractAddress=<address>
+  &chainId=<chainId>
+```
+
+Response includes:
+- Current price (USD)
+- 24h / 6h / 1h volume
+- Market cap, fully diluted valuation
+- Liquidity
+- Holder count and distribution
+- Transaction counts (buys/sells)
+- Price change percentages across timeframes
+
+## API 4 — K-Line Candlestick Data
+
+OHLCV price chart data.
+
+```
+GET https://web3.binance.com/bapi/defi/v1/public/wallet-direct/buw/wallet/token/kline
+  ?contractAddress=<address>
+  &platform=<bsc|solana|base|eth>
+  &interval=<interval>
+  &limit=<count>
+  &from=<timestamp_ms>        # optional, limit takes precedence
+```
+
+Supported intervals: `1s`, `1m`, `5m`, `15m`, `30m`, `1h`, `4h`, `1d`, `1w`, `1M`
+
+Response is a 2D array per candle:
+```
+[open, high, low, close, volume, timestamp_ms, transaction_count]
+```
+
+## Notes
+
+- All numeric values are returned as strings — convert before calculations
+- Logo URLs require prefix: `https://bin.bnbstatic.com`
+- `limit` parameter takes precedence over `from` in K-Line requests
+
+## Usage Examples
+
+```
+User: Find the token PEPE on BSC
+→ GET Token Search, keyword:PEPE, chainId:56
+
+User: What is the current price and market cap of <contract>?
+→ GET Token Dynamic Data
+
+User: Show me the 4h chart for <contract> on Solana
+→ GET K-Line, platform:solana, interval:4h, limit:100
+
+User: Who created this token and does it have social links?
+→ GET Token Metadata
+```

package/skills/binance-trading-signal/SKILL.md

@@ -0,0 +1,84 @@
+---
+name: binance-trading-signal
+description: Binance Web3 official skill — Smart Money on-chain trading signals tracking professional investor buy/sell activity on BSC and Solana. Sourced from github.com/binance/binance-skills-hub.
+metadata: { "cryptoclaw": { "emoji": "📡", "always": false } }
+---
+
+# Binance Smart Money Trading Signals
+
+Official Binance Web3 skill for tracking on-chain Smart Money trading signals — follow professional investors' buy/sell activity.
+
+> Source: [binance/binance-skills-hub](https://github.com/binance/binance-skills-hub/tree/main/skills/binance-web3/trading-signal)
+
+## Supported Chains
+
+| Chain  | chainId |
+|--------|---------|
+| BSC    | 56      |
+| Solana | CT_501  |
+
+## API — Smart Money Signals
+
+```
+POST https://web3.binance.com/bapi/defi/v1/public/wallet-direct/buw/wallet/web/signal/smart-money
+Content-Type: application/json
+
+{
+  "chainId": "56",
+  "page": 1,
+  "pageSize": 20,
+  "smartSignalType": ""    // optional filter, empty string = all
+}
+```
+
+Max `pageSize`: 100.
+
+## Response Fields
+
+| Field              | Description                                      |
+|--------------------|--------------------------------------------------|
+| `signalId`         | Unique signal identifier                         |
+| `tokenSymbol`      | Token ticker symbol                              |
+| `contractAddress`  | Token contract address                           |
+| `logoUrl`          | Token logo (prepend `https://bin.bnbstatic.com`) |
+| `direction`        | `buy` or `sell`                                  |
+| `smartMoneyCount`  | Number of smart money wallets involved           |
+| `timeframe`        | Signal observation window                        |
+| `triggerTime`      | Unix timestamp when signal was triggered         |
+| `triggerPrice`     | Price at signal trigger                          |
+| `currentPrice`     | Current token price                              |
+| `highestPrice`     | Maximum price achieved after signal              |
+| `maxGainPct`       | Maximum gain percentage from trigger             |
+| `exitRate`         | Percentage of smart money that has exited        |
+| `status`           | `active` / `timeout` / `completed`               |
+| `tags`             | Token classifications (DEX Paid, Pumpfun, etc.)  |
+| `launchPlatform`   | Origin platform (Pump.fun, Moonshot, etc.)       |
+
+## Signal Status
+
+- **active** — Signal is currently valid and ongoing
+- **timeout** — Exceeded observation period without resolution
+- **completed** — Target reached or stop loss triggered
+
+## Usage Examples
+
+```
+User: Show me latest smart money buy signals on BSC
+→ POST chainId:56, page:1, pageSize:20, direction filter: buy
+
+User: What are smart money selling on Solana?
+→ POST chainId:CT_501, smartSignalType: sell signals
+
+User: Find tokens where smart money has max gain > 50%
+→ GET signals, filter by maxGainPct > 50
+
+User: Show active buy signals from Pump.fun tokens
+→ GET signals, filter status:active + launchPlatform:pump.fun
+```
+
+## Notes
+
+- Logo URLs require prefix: `https://bin.bnbstatic.com`
+- Prices and percentages are returned as strings — convert for calculations
+- This is for informational purposes only — not investment advice
+- Past signal performance does not guarantee future results