smithery/b-open-io

lookup-bsv-address

This skill should be used when the user asks to "lookup address", "check address balance", "address UTXOs", "address history", or needs to retrieve BSV address information from WhatsOnChain API.

Installation

$ npx skills add smithery/b-open-io --skill lookup-bsv-address

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

Also in this package

Other skills from smithery/b-open-io · top by installs.

npx skills add smithery/b-open-io

Browse all from smithery/b-open-io

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Skill metadata

Parsed from SKILL.md frontmatter.

Allowed toolsBash(bun:*)

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 2,065 B
  • docs SUMMARY.md 220 B

History

  1. First recorded snapshot · 0 installs

SKILL.md

Lookup BSV Address

Look up BSV address information using WhatsOnChain API.

Status

Complete - All tests passing

When to Use

  • Check address balance
  • View transaction history
  • List unspent outputs (UTXOs)
  • Verify address activity

Usage

# Balance, UTXOs, and history (default granularity: all)
bun run /path/to/skills/lookup-bsv-address/scripts/lookup.ts <address>

# Balance only
bun run /path/to/skills/lookup-bsv-address/scripts/lookup.ts <address> balance

# Transaction history (tx_hash + height)
bun run /path/to/skills/lookup-bsv-address/scripts/lookup.ts <address> history

# Unspent outputs (outpoint + value + block height)
bun run /path/to/skills/lookup-bsv-address/scripts/lookup.ts <address> utxos

# JSON output (for scripting / reconciliation)
bun run /path/to/skills/lookup-bsv-address/scripts/lookup.ts <address> all --json

The positional granularity selects which sections to fetch: balance, history, utxos, or all (default). Only the requested endpoints are called.

API Endpoints

WhatsOnChain Address API:

  • Balance: GET /v1/bsv/main/address/{address}/balance
  • History: GET /v1/bsv/main/address/{address}/history
  • UTXOs: GET /v1/bsv/main/address/{address}/unspent

Response

  • balance: confirmed + unconfirmed satoshis, plus totalBsv.
  • utxos: each unspent output as { outpoint, satoshis, height }, with

utxoCount and utxoTotal (the UTXO total reconciles against the balance).

  • history: each transaction as { txid, height }, with historyCount.

Example

$ bun run lookup.ts 19Ao4zVRF6yzRaxiSHD34LCw7fBFn9nrDP utxos
Address: 19Ao4zVRF6yzRaxiSHD34LCw7fBFn9nrDP
UTXOs: 1 (216919 satoshis)
  3ff71eb82058eb45062044091fad0ff9e115d7bb8a0f6b10d5d7f811a1a4fd2d.0  216919 sats  (block 957877)