hypernatt-btc-signal

Summary

OpenClaw skill to fetch HyperNatt Mimo cycle state (hypernatt_mimo_cycle_state_v1) from https://hypernatt.com/api/m2m/signal using the x402 payment protocol.

When to use

• Agent needs current Mimo vault cycle direction and DCA leg context
• Agent needs verifiable track record (win rate, trade count) with Hyperliquid proof
• Budget: $0.01 USDC per call on Base

When NOT to use

• Executing trades (this skill is read-only)
• TP/SL or entry advice (product contract forbids it)
• Free data → use https://hypernatt.com/stats instead

Inputs

| Env var | Required | Description | |---------|----------|-------------| | X402_PAYMENT_B64 | No | Base64 x402 payment payload. If omitted, handler returns 402 instructions. | | HYPERNATT_SIGNAL_URL | No | Default https://hypernatt.com/api/m2m/signal |

Outputs

JSON object:

{
  "product": "hypernatt_mimo_cycle_state_v1",
  "direction": "LONG|SHORT|null",
  "cycle_id": "...",
  "track_record": { "win_rate": 0.946, "total_trades": 74, "url": "https://hypernatt.com/stats" },
  "disclaimer": "Live verifiable Mimo cycle state only. Not a trade recommendation."
}

Example

# Step 1 — payment instructions
python handler.py

# Step 2 — after x402 client signs payment
export X402_PAYMENT_B64="<base64-json>"
python handler.py

Handler

• handler.py — stdlib + urllib (no pip deps, recommended)
• handler.js — Node + axios (optional; set X402_PAYMENT_B64 after x402 signing)

Verification

• Public stats: https://hypernatt.com/stats
• MCP tool: get_btc_usdc_signal @ https://hypernatt.com/mcp/protocol
• ACP job: btc_usdc_signal on Virtuals (graduated)

ClawHub publisher checklist

• [ ] Source repo linked to verified GitHub org
• [ ] No secrets in SKILL.md
• [ ] Handler code reviewed (no wallet drain patterns)
• [ ] Publisher verification form submitted