StevenHo1394 Crypto Price Prediction Skill
Fetches next-hour predicted price for BTC or ETH from an external prediction API. Not a local technical analysis model — just an API wrapper.
- API source:
https://myfastapi.zeabur.app/v1/demo/predictions/next_hour/{BTC|ETH} - Symbols supported:
BTCUSDT,ETHUSDTonly - Horizon: 1 hour (fixed — API limitation)
- Output: Unified JSON with current price (hour start), predicted price, and direction
When to Use
- Quick next-hour price check for BTC/ETH
- When you want an external model's prediction instead of local TA
Not For
- Other symbols (SOL, BNB, etc.)
- Horizons other than 1 hour
- Local technical analysis (no Binance/CoinGecko fallback here)
Installation
Self-contained. Python 3.8+ stdlib only. Node.js 18+ for OpenClaw wrapper.
Usage
Hermes CLI
# BTC next-hour prediction
hermes skill run crypto-price-prediction --symbol BTCUSDT --hours 1
# ETH next-hour prediction
hermes skill run crypto-price-prediction --symbol ETHUSDT --hours 1
OpenClaw API
const { predictPrice } = require('./skill.js').tools;
const result = await predictPrice({ symbol: 'BTCUSDT', hours: 1 });
// Returns unified JSON prediction object
Direct Python
cd /opt/data/.hermes/skills/crypto-price-prediction
TZ=Asia/Hong_Kong python3 scripts/predict.py --coin BTC
TZ=Asia/Hong_Kong python3 scripts/predict.py --coin ETH
Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
--symbol |
string | BTCUSDT |
Trading pair: BTCUSDT or ETHUSDT |
--hours |
number | 1.0 |
Horizon (API only supports 1h) |
--timezone |
string | (prompt) | User timezone (e.g., HKT, UTC, America/New_York) |
Output Format (Unified JSON v1.0.1)
Both Hermes CLI and OpenClaw return identical JSON structure:
{
"timestamp": "2026-07-22 21:00 HKT",
"symbol": "BTCUSDT",
"horizonHours": 1,
"currentPrice": 66405.74,
"predictedPrice": 65662.84,
"predictedDirection": "DOWN"
}
Field Rules
| Field | Description |
|---|---|
timestamp |
Prediction target time in user's timezone (format: YYYY-MM-DD HH:MM TZ) |
symbol |
Trading pair (BTCUSDT or ETHUSDT) |
horizonHours |
Always 1 (API limitation) |
currentPrice |
Price at start of current hour (e.g., if prediction at 08:02, price at 08:00). 2 decimal places. |
predictedPrice |
Predicted price at next hour mark. 2 decimal places. |
predictedDirection |
UP if currentPrice < predictedPrice, else DOWN |
Verbal Output (when all fields populated)
Current price of BTC at 2026-07-22 20:00 HKT: 66,405.74
Predicted price of BTC at 2026-07-22 21:00 HKT: 65,662.84
Predicted direction of BTC in the next hour: DOWN
Timezone Handling
- First run: Prompts user for timezone (e.g.,
HKT,UTC,America/New_York) - Remembered: Stored locally, reused on subsequent runs
- Refused: Defaults to GMT (UTC)
API Details
- Endpoint:
GET https://myfastapi.zeabur.app/v1/demo/predictions/next_hour/{BTC|ETH} - Response:
{"BTC predicted price (next_hour)": 64063.6992}(float) - Rate limit: Unknown — use reasonably
- Current price source: CoinGecko API (free, no key)
Troubleshooting
- API timeout/unreachable: Check network access to
myfastapi.zeabur.app - Invalid symbol: Only
BTCUSDT/ETHUSDTaccepted - Non-1h horizon: API only provides next-hour;
--hoursother than 1 logs warning - Current price fetch fails: Prediction still returned,
currentPriceandpredictedDirectionwill benull
Version History
v1.0.1 (2026-07-24)
- Unified JSON output for Hermes CLI and OpenClaw
- Added
currentPrice(hour-start price) andpredictedDirection(UP/DOWN) - Removed
changePercent,direction,confidence,dataSource,signals - Added timezone prompt + persistence (default: GMT)
- Verbal output with formatted prices (2 decimal places)
- Removed "zeabur" from description
v1.0.0 (Initial)
- BTC/ETH next-hour prediction via external API
- Hermes CLI + OpenClaw plugin
- HKT timezone handling
Disclaimer
Not financial advice. External API predictions are opaque — no visibility into methodology. Use at your own risk.
License
MIT