# Hedera Mirror Node

> Query Hedera Mirror Node REST API for account history, token balances, NFT ownership, topic messages, smart contract logs — pagination patterns, building explorer-like indexes. Use when user mentions mirror node REST, list transactions account, token balances API, NFT REST Hedera, contract logs mirror, pagination links.next.

- Skill: `evaluris-solutions/hedera-mirror-node` (Agent Skill, multi-file: 8 files)
- Install (CLI): `npx skillmds@latest add evaluris-solutions/hedera-mirror-node`
- Raw SKILL.md: https://api.skillmd.com/api/skills/evaluris-solutions/hedera-mirror-node/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: Evaluris-Solutions (https://skillmd.com/u/evaluris-solutions)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/evaluris-solutions/hedera-mirror-node

---


## Overview

Mirror Nodes expose **historical** protocol data via OpenAPI-compatible REST endpoints ([Mirror Node REST API](https://docs.hedera.com/hedera/sdks-and-apis/rest-api.md)).

## When to use this skill

- Constructing **explorer-like** views without running your own mirror.
- Paginating large responses via `links.next`.

## Prerequisites

- Base URLs from environment/setup references (`testnet`, `mainnet` hosts).

## Workflow

1. Choose host — see [references/mirror-endpoints.md](references/mirror-endpoints.md).

2. Query accounts, transactions, tokens, contracts, topics — recipes in [references/query-cookbook.md](references/query-cookbook.md).

3. Implement pagination loop — follow [references/pagination.md](references/pagination.md).

4. Use sample scripts: [scripts/query-account-history.js](scripts/query-account-history.js), [scripts/query-nft-ownership.js](scripts/query-nft-ownership.js), [scripts/query-contract-logs.js](scripts/query-contract-logs.js), [scripts/simple-explorer.js](scripts/simple-explorer.js).

## Examples

**Example 1**

> “List last 100 payments for account X.”

`GET /api/v1/transactions?account.id=X&limit=100`.

**Example 2**

> “Who owns NFT serial 12?”

NFT endpoints (`/tokens/{tokenId}/nfts/{serial}`) plus ownership transfers.

**Example 3**

> “Stream contract logs for USDC-like token.”

`/api/v1/contracts/{id}/results/logs` with timestamp constraints.

## Troubleshooting

| Issue | Tip |
| --- | --- |
| Stale data | Mirror lag vs consensus — seconds normally |
| Rate limits | Backoff + caching |

## References

- Local: [references/mirror-endpoints.md](references/mirror-endpoints.md), [references/query-cookbook.md](references/query-cookbook.md), [references/pagination.md](references/pagination.md)