earn-hunter

Monitors OKX Flash, Fixed, and Flexible Earn rates and sends scheduled notifications.

Updated Aug 18, 2026
One-click install
npx skills add https://github.com/wandreandrade2018-maker/claude-config --skill earn-hunter-wandreandrade2018-maker
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: earn-hunter
Source: https://github.com/wandreandrade2018-maker/claude-config/tree/main/.agents/skills/earn-hunter
Command: npx skills add https://github.com/wandreandrade2018-maker/claude-config --skill earn-hunter-wandreandrade2018-maker

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @okx_ai/okx-trade-cli, jq, and includes scripts (resource) and references (resource) components.

What problem does it solve? Manually checking OKX Earn products for new high-yield opportunities is repetitive and easy to miss. This Skill automates scheduled scanning of Flash Earn, Fixed Earn, and Flexible Earn rates, deduplicates results, and pushes alerts to Telegram, Lark, or the current session so you never miss a rate spike or new project. ## Core Features & Use Cases - Scheduled multi-product scanning: A pure shell + jq script (scripts/scan.sh) runs from OS crontab, macOS LaunchAgent, or OpenClaw cron with zero LLM cost per tick, covering Flash Earn, Fixed Earn, and Flexible Earn. - Threshold-based filtering and dedup: Two-layer APY thresholds (per-currency overrides plus global minimum), term filters, and a threshold-crossing dedup model for flexible rates prevent notification spam. - Multi-channel push notifications: Sends alerts via Telegram Bot API, Lark webhook cards, or the interactive session, with smoke tests, delivery confirmation, and troubleshooting flows. - Purchase guidance: After a notification, it checks balances across funding, trading, and flexible accounts, compares APR vs APY, recommends an amount, and hands off execution to the okx-cex-earn skill. - Use Case: Tell the agent "monitor earn and notify me on Telegram" — it detects your platform, configures thresholds, installs an hourly cron job, and pushes an alert whenever USDT flexible APY crosses 8% or a new Flash Earn project opens. ## Quick Start Ask the agent to monitor OKX earn products and notify you about new opportunities, for example by saying "有闪赚通知我" or "monitor earn and send alerts to Telegram".

Frequently Asked Questions about earn-hunter

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I monitor OKX Earn rates and get notified automatically?

Activate the skill by saying you want to monitor earn products. It detects your platform, asks you to confirm a notification channel (Telegram, Lark, or session), sets APY thresholds, and installs an hourly scheduler that runs scripts/scan.sh and pushes alerts for new opportunities.

How do I set up Telegram notifications for OKX earn alerts?

Create a bot via @BotFather, then set the TELEGRAM_BOT_TOKEN and TELEGRAM_CHAT_ID environment variables. The scan script reads these at runtime and sends alerts through the Telegram Bot API; credentials are never accepted through chat for security.

Does the OKX earn scanner work on macOS without cron running?

Yes. On macOS, if the cron daemon is not running, the activation flow automatically falls back to a LaunchAgent (com.okx.earn-hunter.plist) with the same interval, resolved tool paths, and RunAtLoad enabled, requiring no sudo.

Why am I getting duplicate or missing earn notifications?

Duplicates usually come from a corrupted state.json, which the script resets to an empty dedup state. Missing notifications often mean the APY is below your configured threshold or the opportunity was already deduplicated; flexible earn only notifies once per threshold-crossing period.

Can the earn monitor buy Fixed Earn products for me?

It does not execute purchases directly. After a notification, it checks your balances, compares fixed APR against flexible APY, recommends an amount, re-verifies the offer is not sold out, then hands off execution to the okx-cex-earn skill or gives you copy-paste CLI commands.

What are the limitations of the earn-hunter scan?

It covers only Flash Earn, Simple Earn Fixed, and Simple Earn Flexible; DCD, on-chain, and auto-earn products are out of scope. It runs in live trading mode only, and flexible rate checks require one API call per configured currency.