Crypto Funding Harvester

Scans perpetual futures funding rates across Hyperliquid, Binance, and Bybit to identify delta-neutral carry trade opportunities. A delta-neutral carry trade...

Security Scan

The skill's code, manifest, and runtime instructions are consistent with its stated purpose (poll public exchange endpoints for funding rates and write results to /tmp); it does not request credentials or unrelated access.

Purpose & Capability

Name/description, SKILL.md, clawhub.json (requires.requests), and the visible Python code all align: the skill polls public funding-rate endpoints (Hyperliquid, Binance, Bybit) and computes annualized funding rates. There are no unexpected credentials, binaries, or services requested.

Instruction Scope

Instructions and code operate within the stated scope (fetch public APIs, filter and save results to /tmp/funding_opportunities.json, run every 15 minutes). Note: the skill writes output to /tmp (an ephemeral, world-readable location on many systems) — this is expected but could expose results to other local processes.

Install Mechanism

No install script; clawhub.json lists a single pip dependency ('requests'), which the code uses. This is proportionate for HTTP polling. No arbitrary downloads or extract steps are present.

Credentials

No required environment variables or credentials. Declared optional env vars (MIN_ANNUALIZED_PCT, CROSS_EXCHANGE_SPREAD_THRESHOLD, REQUEST_TIMEOUT) are appropriate for tuning behavior and match usage in the code.

Persistence & Privilege

The skill is an automaton scheduled to run on a cron schedule (*/15 * * * *) and is not set to always:true. It does not request system-wide config changes or other skills' credentials. Autonomous invocation is allowed (platform default) but not unusual here.

Assessment

This skill appears coherent and limited to polling public exchange APIs and writing computed results to /tmp. Before installing: 1) Review the full funding_harvester.py file (the provided excerpt was truncated) to confirm there are no hidden network calls or post-install hooks; 2) Be aware output is stored in /tmp which may be readable by other local users/processes; 3) Confirm you are comfortable with a cron job making external HTTP requests every 15 minutes and consider rate limits / exchange terms of service; 4) Run the skill in a sandbox or isolated environment if you want to inspect its behavior before trusting it in production.

Crypto Funding Rate Harvester

Scans perpetual futures funding rates across Hyperliquid, Binance, and Bybit to surface delta-neutral carry trade opportunities in real time.

What it does

A delta-neutral carry trade works like this:

• Buy spot (e.g. BTC on any exchange)
• Short the perpetual future on the same asset
• Net directional exposure = zero
• Collect the funding rate paid by longs to shorts
• Pure yield, no price risk (ignoring basis risk)

This skill identifies assets where funding rates are high enough (>20% annualized) to make this trade worthwhile after accounting for fees and capital costs.

Output

Results are saved to /tmp/funding_opportunities.json with the following structure:

{
  "generated_at": "2025-01-01T00:00:00.000000",
  "opportunities": [
    {
      "asset": "BTC",
      "exchange": "binance",
      "funding_rate_8h": 0.0003,
      "annualized_pct": 32.85,
      "current_price": 65000.0
    }
  ],
  "cross_exchange_spreads": [
    {
      "asset": "BTC",
      "binance_annualized_pct": 32.85,
      "bybit_annualized_pct": 10.95,
      "spread_pct": 21.9,
      "note": "Binance funding significantly higher than Bybit — potential cross-exchange arb"
    }
  ],
  "summary": {
    "total_opportunities": 5,
    "exchanges_scanned": ["hyperliquid", "binance", "bybit"],
    "min_annualized_threshold_pct": 20
  }
}

Environment Variables

No environment variables are required. All APIs used are free and public.

The following optional environment variables can be used to tune behavior:

Variable	Default	Description
MIN_ANNUALIZED_PCT	20	Minimum annualized funding rate (%) to include in results
CROSS_EXCHANGE_SPREAD_THRESHOLD	10	Minimum spread (%) between Binance and Bybit to flag as a cross-exchange opportunity
REQUEST_TIMEOUT	10	HTTP request timeout in seconds

Exchanges

Exchange	Endpoint	Notes
Hyperliquid	https://api.hyperliquid.xyz/info	POST, type=metaAndAssetCtxs
Binance	https://fapi.binance.com/fapi/v1/premiumIndex	GET, all USDT perps
Bybit	https://api.bybit.com/v5/market/tickers	GET, category=linear

Funding Rate Normalization

All exchanges use 8-hour funding intervals. Annualized rate is calculated as:

annualized_pct = funding_rate_8h * 3 * 365 * 100

Where * 3 converts 8h to daily (3 periods per day) and * 365 converts daily to annual.

Cron Schedule

Runs every 15 minutes: */15 * * * *