Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Hedera network API

The network API from Hedera — 6 operation(s) for network.

Hedera network API is one of 10 APIs that Hedera publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include network. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and rate-limit docs.

This API exposes 7 operations across 6 paths, and defines 37 schemas. It is described by OpenAPI 3.1.0, at version 0.156.0.

Requests are made against a single base URL, {scheme}://{network}.mirrornode.hedera.com.

7 operations 6 paths 37 schemas 6 GET1 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
0.156.0
Base URL
https://mainnet.mirrornode.hedera.com
License
Resource Areas
1

Paths & Operations 7

Across 6 paths, the API surfaces 7 operations — 6 GET, 1 POST. Each is listed below with its method, path, parameters, and response codes.

network 7
GET
/api/v1/network/exchangerate
Get the network exchange rate to estimate costs
getNetworkExchangeRate 1 param → 200400404500
GET
/api/v1/network/fees
Get the network fees
getNetworkFees 2 params → 200400404500
POST
/api/v1/network/fees
Estimate network fees
estimateFees 2 params body → 200400500
GET
/api/v1/network/nodes
Get the network address book nodes
getNetworkNodes 4 params → 200400
GET
/api/v1/network/registered-nodes
Get registered nodes
getRegisteredNodes 4 params → 200400
GET
/api/v1/network/stake
Get network stake information
getNetworkStake → 200400404500
GET
/api/v1/network/supply
Get the network supply
getNetworkSupply 1 param → 200400404

Schemas 37

The contract defines 37 schemas that model the data the API accepts and returns. The most detailed are NetworkNode (20 properties), NetworkStakeResponse (14 properties), RegisteredServiceEndpoint (9 properties), RegisteredNode (6 properties). Each schema is shown below with its type and property counts.

NetworkNodesResponse
object
2 properties 2 required
RegisteredNodeType
string
Registered node type.
NetworkNodes
array
EntityIdQuery
string
RegisteredServiceEndpoint
object
9 properties 7 required
RegisteredBlockNodeApi
string
ServiceEndpoint
object
3 properties 3 required
Key
objectnull
The public key which controls access to various network entities.
2 properties
NetworkFeesResponse
object
2 properties
ServiceEndpoints
array
TimestampRange
object
A timestamp range an entity is valid for
2 properties
TimestampNullable
stringnull
A Unix timestamp in seconds.nanoseconds format
RegisteredNodesResponse
object
2 properties 2 required
NetworkFees
array
NetworkNode
object
20 properties 20 required
RegisteredServiceEndpoints
array
ExchangeRate
object
3 properties
Links
object
1 property
FeeEstimateNetwork
object
The network fee component which covers the cost of gossip, consensus, signature verifications, fee payment, and storage.
2 properties 2 required
EntityId
stringnull
Network entity ID in the format of shard.realm.num
NetworkSupplyResponse
object
3 properties
NetworkFee
object
2 properties
FeeExtra
object
The extra fee charged for the transaction.
6 properties 6 required
RegisteredMirrorNodeEndpoint
object
Timestamp
string
A Unix timestamp in seconds.nanoseconds format
FeeEstimate
object
The fee estimate for the network component. Includes the base fee and any extras associated with it.
2 properties 2 required
NetworkExchangeRateSetResponse
object
3 properties
Error
object
1 property
RegisteredNode
object
6 properties 6 required
RegisteredGeneralServiceEndpoint
object
1 property
FeeEstimateMode
string
Estimate solely based on the transaction's inherent properties or use network state.
RegisteredRpcRelayEndpoint
object
NetworkStakeResponse
object
14 properties 14 required
TimestampRangeNullable
objectnull
A timestamp range an entity is valid for
2 properties
RegisteredNodes
array
FeeEstimateResponse
object
The response containing the estimated transaction fees.
5 properties 5 required
RegisteredBlockNodeEndpoint
object
1 property

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

hedera-network-api-openapi.yml Raw ↑

Other APIs Hedera publishes across the network.

Hedera accounts API
Hedera airdrops API
Hedera balances API
Hedera blocks API
Hedera contracts API
Hedera schedules API
Hedera tokens API
Hedera topics API
Hedera transactions API