earn-hunter

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

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

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve? Manually checking OKX Earn products means missing short-lived Flash Earn launches and APY spikes on Fixed and Flexible Earn. This Skill automates recurring scans of all three product types and pushes alerts to Telegram, Lark, or your chat session so you never miss a high-yield window. ## Core Features & Use Cases - Scheduled multi-product scanning: A pure shell + jq script scans Flash Earn, Fixed Earn, and Flexible Earn on an hourly cron schedule with zero LLM token cost, filtering by currency, term, and configurable APY thresholds. - Deduplicated push notifications: Sends alerts via Telegram Bot API, Lark webhook, or the current session, with state-based dedup so each opportunity notifies only once (Flexible Earn uses a threshold-crossing model). - Guided subscription handoff: When you decide to buy, it checks balances across funding, trading, and Simple Earn accounts, recommends an amount, re-verifies availability, and hands off to the okx-cex-earn skill for execution. - Use Case: Tell your agent "有闪赚通知我" — it detects your platform, sets up an hourly cron job, and the next time a USDT Fixed Earn product appears above your 8% APY threshold, you get a Telegram message with the rate, term, and remaining quota. ## Quick Start Say "monitor OKX earn opportunities and notify me" to activate the guided setup, which configures your notification channel, scan thresholds, and hourly scheduler.

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 APY rates automatically?

Activate the skill by saying you want to monitor earn opportunities. It runs a shell script on an hourly cron schedule that queries Flash Earn, Fixed Earn, and Flexible Earn via the okx CLI, filters by your APY thresholds, and pushes only new opportunities to your chosen channel.

How do I get OKX Earn alerts on Telegram or Lark?

Set the TELEGRAM_BOT_TOKEN and TELEGRAM_CHAT_ID environment variables for Telegram, or provide a Lark webhook URL during activation. The scan script sends notifications directly via curl, so alerts arrive even when no agent session is open.

Does earn-hunter work on Claude Code and OpenClaw?

Yes. On Claude Code, Hermes, and generic platforms it schedules scans through OS crontab or a macOS LaunchAgent. On OpenClaw it uses the in-session cron tool with announce delivery back to the conversation channel.

Why am I getting duplicate OKX Earn notifications?

The skill dedups by opportunity key in state.json, so repeats usually mean the APY changed (treated as a new offer) or state was reset. Flexible Earn only re-notifies after the rate drops below and rises above your threshold again.

Can earn-hunter subscribe to Fixed Earn products for me?

It does not execute purchases directly. It checks your balances, recommends an amount, re-verifies the product is not sold out, then hands off to the okx-cex-earn skill or gives you copy-paste CLI commands to complete the subscription.

Why did my scheduled earn-hunter scan stop working?

The most common cause is cron's minimal PATH not finding okx, node, or jq. The skill writes an env.snapshot file during activation to fix this; check ~/.okx/earn-hunter/cron.log and rerun the activation preflight if the snapshot is missing.