Hedera Mirror Node

The Hedera Consensus Service (HCS) gRPC API is a public mirror node managed by Hedera. It offers the ability to subscribe to HCS topics and receive messages for the topic subscribed. API docs for the mirror nodes can be found here:

Mainnet:

Public Mirror Node

The non-production public mainnet mirror node serves to help developers build their applications without having to run their own mirror node. For production-ready mainnet mirror nodes please check out Dragonglass and Kabuto. When building your Hedera client via SDK, you can use setMirrorNetwork() and enter the public mainnet mirror node endpoint. The gRPC API requires TLS. The following SDK versions support TLS:

  • Java: v2.0.6+

  • JavaScript: v2.0.23+

  • Go: v2.1.9+

Requests are throttled at 100 requests per second (rps). This may change in the future depending upon performance or security considerations. At this time, no authentication is required.

Java
JavaScript
Go
Java
//You will need to upgrade to v2.0.6 or higher
Client client = Client.forMainnet();
client.setMirrorNetwork(Collections.singletonList("mainnet-public.mirrornode.hedera.com:443"))
JavaScript
//You will need to upgrade to v2.0.23 or higher
const client = Client.forMainnet()
client.setMirrorNetwork("mainnet-public.mirrornode.hedera.com:443")
Go
client := hedera.ClientForMainnet()
client.SetMirrorNetwork([]string{"mainnet-public.mirrornode.hedera.com:443"})

Mainnet Mirror Node Endpoint: mainnet-public.mirrornode.hedera.com:443 REST API Mainnet Root Endpoint: https://mainnet-public.mirrornode.hedera.com

Whitelisted Mirror Node

The whitelisted mainnet mirror node is available for our partners, including exchanges and wallets. The SDK defaults to this mirror node when building the Hedera client via SDK.

HCS Mainnet Mirror Node Endpoint: hcs.mainnet.mirrornode.hedera.com:5600 REST API Mainnet Root Endpoint: https://mainnet.mirrornode.hedera.com

Testnet:

The endpoints provided below allows developers to access the testnet mirror node which contains testnet transaction data.

HCS Testnet Mirror Node Endpoints: hcs.testnet.mirrornode.hedera.com:5600

REST API Testnet Root Endpoint: https://testnet.mirrornode.hedera.com

Previewnet:

The endpoints provided below allows developers to access the previewnet mirror node which contains previewnet transaction data.

HCS Preview Testnet Mirror Node Endpoints: hcs.previewnet.mirrornode.hedera.com:5600

REST API Preview Testnet Root Endpoint: https://previewnet.mirrornode.hedera.com