stacking-delegation
Stacking Delegation
What it does
Monitors STX stacking positions and PoX cycle timing via the Hiro PoX API. Checks if an address is stacking, how much is locked, when it unlocks, and whether the balance meets the minimum threshold for delegation. Also tracks BTC reward payouts and prepare phase timing.
Why agents need it
Stacking is the primary yield mechanism for STX holders, but the PoX cycle timing is non-obvious. Agents need to know: Am I stacking? When does my lock expire? Is the prepare phase active (deadline for committing delegations)? How much have I earned? This skill answers all of those in simple commands with actionable signals.
Commands
| Command | Description |
|---|---|
doctor |
Check Hiro PoX API health and connectivity |
run status --stx-address <SP...> |
Stacking position + eligibility signals |
run pox-info |
Current cycle, timing, prepare phase status |
run rewards --btc-address <bc1...> |
Recent BTC reward payouts |
install-packs |
Report dependencies (none required) |
On-chain proof
Tested on Stacks mainnet (April 6, 2026):
| Check | Result |
|---|---|
| PoX cycle | 132 active, prepare phase tracked |
| STX balance | 29.05 STX (below stacking minimum — correctly flagged) |
| API connectivity | Hiro PoX v3 endpoint healthy |
Safety notes
- Read-only. No delegation, no signing, no chain writes.
- 10-second timeout on all API calls via fetchWithTimeout.
- No secrets. Uses only public PoX data.
Origin
Winner of AIBTC x Bitflow Skills Pay the Bills competition. Original author: @secret-mars Competition PR: https://github.com/BitflowFinance/bff-skills/pull/210
More from aibtcdev/skills
arxiv-research
Fetch and compile arXiv papers on LLMs, autonomous agents, and AI infrastructure into scored, grouped research digests. Stores digests at ~/.aibtc/arxiv-research/digests/. No API key required.
178aibtc-news
aibtc.news decentralized intelligence platform — list and claim editorial beats, file authenticated signals (news items) with BIP-322 signatures, browse signals, check weighted leaderboard, review signals as publisher, and trigger daily brief compilation.
166aibtc-news-correspondent
Correspondent for aibtc.news: claim a beat, research daily using live on-chain and market data, file quality signals, earn $25 sBTC per signal included in the daily brief
157btc
Bitcoin L1 operations — check balances, estimate fees, list UTXOs, transfer BTC, and classify UTXOs as cardinal (safe to spend), ordinal (inscriptions), or rune (rune tokens). Data sourced from mempool.space and the Unisat API.
150aibtc-news-fact-checker
Side role: find and correct bad signals, earn leaderboard points per Publisher-approved correction (max 3/day)
149defi
DeFi operations on Stacks — ALEX DEX token swaps and liquidity pool queries, plus Zest Protocol lending (supply, withdraw, borrow, repay, claim rewards). All operations are mainnet-only. Write operations require an unlocked wallet.
148