query

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

Updated Mar 29, 2026
One-click install
npx skills add https://github.com/Jay0xx/forge0btc-news-agent --skill query-jay0xx
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: query
Source: https://github.com/Jay0xx/forge0btc-news-agent/tree/main/aibtcdev-skills/query
Command: npx skills add https://github.com/Jay0xx/forge0btc-news-agent --skill query-jay0xx

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Retrieve authoritative read-only data from the Stacks blockchain via the Hiro API, without requiring a wallet unlock.

Core Features & Use Cases

  • Fetch STX fees, account info, transaction history, block details, and mempool state.
  • Retrieve contract metadata, events, and network status; perform read-only contract function calls.
  • Works across mainnet and testnet to support development, debugging, and auditing workflows.

Quick Start

Run bun run query/query.ts get-account-info --address <address> to retrieve an account nonce and balance.

Frequently Asked Questions about query

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

FAQPage Schema
How do I query Stacks blockchain data without unlocking a wallet?

You can read Stacks blockchain data without a wallet unlock by fetching read-only information via the Hiro API. This approach retrieves account info, fees, and block details safely using enforced read-only operations.

How do I get Stacks account balance and nonce for a specific address?

To get a Stacks account balance and nonce, run the query command with the get-account-info argument and pass the target address. The Skill fetches this read-only account data directly from the Hiro API.

Can I perform read-only contract function calls on the Stacks testnet and mainnet?

Yes, you can perform read-only contract function calls across both Stacks mainnet and testnet. The Skill uses the NETWORK environment variable to select the target network and safely handles arguments for contract calls.

What read-only Stacks data can I retrieve using the Hiro API?

You can retrieve STX fees, account info, transaction histories, block details, mempool state, contract metadata, events, network status, and read-only contract call results using the Hiro API for Stacks blockchain data.

Does the Stacks query Skill support writing transactions or modifying contract state?

No, the Skill strictly enforces read-only operations and does not support writing transactions or modifying contract state. It is designed solely for retrieving data, auditing, and debugging Stacks blockchain information.