query

Fetch read-only Stacks blockchain data via the Hiro API.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Read-only access to Stacks blockchain data via Hiro API to fetch account info, transaction histories, block details, mempool status, contract metadata, events, and network health without needing to unlock a wallet.

Core Features & Use Cases

  • Get account info and nonce with balance
  • Retrieve transaction history for addresses
  • Inspect blocks, mempool state, and chain health
  • Get contract metadata and events, and perform read-only function calls

Quick Start

Run bun run query/query.ts get-account-info --address SP2JKEZC09WVMR33NMHL8TNAVRCKDCJPAYV6510R6 to fetch account details.

Frequently Asked Questions about query

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

FAQPage Schema
How do I fetch Stacks account info and balance without unlocking a wallet?

Fetch Stacks account info and balance without unlocking a wallet by executing read-only queries via the Hiro API. This retrieves up-to-date address balances and nonces, outputting structured JSON suitable for downstream tooling.

Can I retrieve Stacks transaction history and mempool status using the Hiro API?

Yes, you can retrieve Stacks transaction history and mempool status using the Hiro API. The query tool fetches up-to-date read-only blockchain data across mainnet and testnet, outputting structured JSON for downstream analysis.

How do I perform read-only contract function calls on the Stacks blockchain?

Perform read-only contract function calls on the Stacks blockchain by querying contract metadata and events via the Hiro API. This supports read-only operation constraints and outputs structured JSON without needing wallet authorization.

Does the Hiro API query tool support both Stacks mainnet and testnet?

Yes, the Hiro API query tool supports both Stacks mainnet and testnet. It fetches network health, block details, and mempool state across both networks, returning structured JSON suitable for downstream tooling.

What is the best way to inspect Stacks block details and contract events?

The best way to inspect Stacks block details and contract events is using read-only Hiro API queries. This approach fetches up-to-date blockchain data directly, outputting structured JSON without requiring wallet access.

Do I need a specific address input to get Stacks blockchain data via the Hiro API?

You do not need a specific address input for general Stacks blockchain data like block details or network health, but address input is optional and required for targeted queries like retrieving specific account info or transaction histories.