openclaw/acwxpunh/binance-event-contract

Binance Event Contract Full Data Fetcher

1. Scenario Definition

• Trigger Timing: Auto-run every minute after Agent startup; also supports manual trigger via /binance-fetch-data; runs 24/7, aligned with Binance 7×24 trading hours
• Core Intent: Provide 100% accurate, delay-free Binance official native data for the 3-tier resonance strategy; reject all third-party data sources
• Context: Targets only BTCUSDT & ETHUSDT pairs; covers only 10min/30min/60min Event Contract cycles; provides underlying data support for signal calculation, ICT recognition, and risk control

2. Goal Setting

Complete Binance official API data fetch within 1 second per minute; output standardized BTC/ETH full-dimension data with 100% accuracy; price data fully matches Binance Event Contract settlement spot index price; provide error-free data source for strategy signal calculation.

3. Execution Rules

3.1 Data Source Rule

• MUST connect ONLY to Binance Official REST API & WebSocket API
• MUST call https://api.binance.com (or appropriate endpoint)
• PROHIBITED: Calling any third-party data platform (Huobi, OKX, etc.)

3.2 Fixed Fetch Pairs

• BTCUSDT (primary)
• ETHUSDT (secondary)

3.3 Mandatory Fetch Data Dimensions

K-line Data:

• Cycles: 1min / 10min / 30min / 1h / 4h
• Fields: open, high, low, close, volume, turnover
• Fetch latest 200 K-lines per cycle for indicator calculation

Liquidity Data:

• BTC/ETH spot order book top 10 bid/ask depth
• Calculate total bid/ask amount
• Verify if total bid or ask ≥ 500,000 USDT

Market Data:

• Latest spot index price (Binance Event Contract settlement anchor)
• 24h price change
• Bid-ask spread

Contract Rule Data:

• Current available expiration cycles (10min/30min/1h)
• Single trade limit (5-250 USDT)
• Daily loss limit rules

3.4 Running Rule

• Auto-start cron task at Agent startup
• Run at second 0 of every minute
• Auto-cache data after fetch
• Sync to all related Skills for call

3.5 Data Verification Rule

• Auto-verify data integrity after each fetch
• Auto-retry 3 times if interface timeout or data missing
• Trigger exception alert if retry failed
• Use previous valid cached data as fallback
• No impact on strategy running if cache available

4. Example Output

✅ Positive Example (Standard Output)

【 Binance Event Contract Data Fetch Completed | 2026-03-18 12:10:00 】
1. Pair: BTCUSDT
   - Latest Index Price: 68245.32 USDT
   - 10min K-line: Open 68198.45 / High 68289.12 / Low 68176.33 / Close 68245.32 / Volume 128.34 BTC
   - Liquidity: Bid Depth 892,000 USDT | Ask Depth 945,000 USDT | Qualified ✓
   - Available Cycles: 10min / 30min / 1h Event Contract — ALL AVAILABLE
2. Pair: ETHUSDT
   - Latest Index Price: 3842.18 USDT
   - 10min K-line: Open 3839.76 / High 3845.22 / Low 3838.11 / Close 3842.18 / Volume 986.25 ETH
   - Liquidity: Bid Depth 627,000 USDT | Ask Depth 583,000 USDT | Qualified ✓
   - Available Cycles: 10min / 30min / 1h Event Contract — ALL AVAILABLE
Data synced to signal calculation module | Cache valid for 60s

❌ Negative Example (Forbidden Output)

• Fetch BTC/ETH data from exchanges other than Binance (Huobi/OKX etc.)
• Only output price without volume, liquidity, or other strategy-required data
• Use expired K-line data with delay over 1 minute

5. Boundary Definition

Forbidden Operations

1. Do NOT call Binance trading API for entry/settlement — only data fetch and verification
2. Do NOT fetch data of pairs other than BTC/ETH
3. Do NOT store user account privacy data

Exception Handling

1. When Binance API is under maintenance or rate limit → push alert immediately, stop invalid fetch, auto-restart after API recovery
2. Do NOT output invalid data to signal calculation module if data verification failed

Fallback Strategy

If fetch fails 3 times consecutively → push "Data Fetch Exception" alert immediately, pause signal generation until data returns to normal, avoid false signal caused by wrong data

Installation

npx clawhub@latest install binance-event-contract-data-fetcher --dir /workspace/skills

Auto-Run Trigger

24/7, run every minute automatically after activation