btc

Perform Bitcoin L1 operations including balance checks, fee estimates, UTXO listings, and BTC transfers.

9|43|Updated Feb 19, 2026
One-click install
npx skills add https://github.com/aibtcdev/skills --skill btc-aibtcdev
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: btc
Source: https://github.com/aibtcdev/skills/tree/main/btc
Command: npx skills add https://github.com/aibtcdev/skills --skill btc-aibtcdev

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires commander.

What problem does it solve?

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.

Core Features & Use Cases

  • Balance: check total, confirmed, and unconfirmed BTC balances for a address or wallet.
  • Fees: fetch current fee estimates to guide transaction timing.
  • UTXOs & Inscriptions: list cardinal UTXOs (safe to spend), ordinal UTXOs (with inscriptions), and rune UTXOs.
  • Transfer: send BTC using cardinal UTXOs by default; option to include ordinals if needed (with risk).
  • Inscriptions & Rune: query inscriptions and rune-related UTXOs via Unisat API.

Quick Start

Run bun run btc/btc.ts balance to check the balance for your active Bitcoin address.

Frequently Asked Questions about btc

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

FAQPage Schema
How do I check my Bitcoin wallet balance and UTXOs?

Check Bitcoin wallet balances by running the CLI to query mempool.space, which returns total, confirmed, and unconfirmed BTC. You can also list UTXOs to identify safe-to-spend coins or inscriptions.

How do I classify Bitcoin UTXOs as cardinal, ordinal, or rune?

Classify Bitcoin UTXOs by querying the Unisat API with a valid UNISAT_API_KEY. This categorizes UTXOs into cardinal (safe to spend), ordinal (inscriptions), or rune tokens for automation workflows.

Do I need a UNISAT_API_KEY to transfer BTC or check fees?

You do not need a UNISAT_API_KEY to estimate fees or transfer BTC; fee estimates use mempool.space. The API key is only required for classifying UTXOs and querying inscriptions or rune tokens.

Can I send Bitcoin ordinals and inscriptions using this tool?

You can send ordinals by including them in a BTC transfer, though this carries risk. By default, transfers only use cardinal UTXOs to ensure safe-to-spend coins are spent without accidentally losing inscriptions.

What is the best way to automate Bitcoin L1 transfers on testnet?

Automate Bitcoin L1 transfers on testnet using the Bun-based CLI, which requires an unlocked wallet to sign transactions. It queries mempool.space for fees and transfers BTC using cardinal UTXOs by default.

Why does my Bitcoin UTXO classification fail without an API key?

UTXO classification fails without an API key because identifying ordinal inscriptions and rune tokens requires data from the Unisat API. You must configure the UNISAT_API_KEY environment variable to access this functionality.