Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 0 additions & 1 deletion hedera/core-concepts/fee-model.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -373,5 +373,4 @@ If `free` is `true`, `baseFee` and `extras` are ignored during calculation but m
<Card title="HIP-1259: Fee Collection" icon="vault" href="https://hips.hedera.com/hip/hip-1259">
The fee collection account model that Simple Fees depends on.
</Card>

</CardGroup>
26 changes: 2 additions & 24 deletions hedera/sdks-and-apis/rest-api/network.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -16,31 +16,9 @@ The following endpoints are available for the Network object:
| --- | --- |
| `GET /api/v1/network/supply` | Retrieves the current total supply of HBAR. |
| `GET /api/v1/network/fees` | Fetches the latest transaction fee schedules. |
| `POST /api/v1/network/fees` | Estimates fees for a specific transaction before submission. [HIP-1261](https://hips.hedera.com/hip/hip-1261) |
| `POST /api/v1/network/fees` | Estimates node, network, and service fees for a protobuf-encoded transaction, including the [HIP-1313](https://hips.hedera.com/hip/hip-1313) `high_volume_multiplier`. |
| `GET /api/v1/network/exchangerate` | Retrieves exchange rates to estimate transaction costs. |
| `GET /api/v1/network/nodes` | Lists the network address book nodes. |
| `GET /api/v1/network/stake` | Fetches staking-related information. |

### Estimate Transaction Fees (POST)

`POST /api/v1/network/fees`

Introduced in [HIP-1261 (Simple Fees)](https://hips.hedera.com/hip/hip-1261), this endpoint estimates the node, network, and service fees for a transaction before it is submitted to the network. It accepts a serialized `Transaction` protobuf in the request body (`application/protobuf` or `application/x-protobuf` Content-Type) and returns a detailed fee breakdown in tinycents.

Two estimation modes are available via the `mode` query parameter:

| Mode | Behavior |
| --- | --- |
| `intrinsic` (default) | Estimates based on the transaction's inherent properties (size, signatures, keys). |
| `state` | Also considers the mirror node's latest known state (e.g., account existence, token associations). |

<Info>
For `state` mode, if the required network state is unavailable (e.g., due to data pruning), the endpoint falls back to `intrinsic` mode and includes a note in the response explaining the fallback.
</Info>

<Warning>
This endpoint currently returns stubbed (dummy) data as of mirror node `v0.145.1`. The full fee estimation implementation using the upstream fee estimation library will ship in a future release. You can integrate against the stub now to be ready when the production implementation goes live.
</Warning>

For full request/response details, parameters, and the interactive API playground, see the [API reference page](/api-reference/network/estimate-network-fees). For an overview of the Simple Fees model, see [Fee Model](/hedera/core-concepts/fee-model).
<table><thead><tr><th>Endpoint</th><th>Description</th></tr></thead><tbody><tr><td><code>GET /api/v1/network/supply</code></td><td>Retrieves the current total supply of HBAR.</td></tr><tr><td><code>GET /api/v1/network/fees</code></td><td>Fetches the latest transaction fee schedules.</td></tr><tr><td><code>POST /api/v1/network/fees</code></td><td>Estimates fees for a specific protobuf-encoded transaction, including the [HIP-1313](https://hips.hedera.com/hip/hip-1313) <code>high_volume_multiplier</code>.</td></tr><tr><td><code>GET /api/v1/network/exchangerate</code></td><td>Retrieves exchange rates to estimate transaction costs.</td></tr><tr><td><code>GET /api/v1/network/nodes</code></td><td>Lists the network address book nodes.</td></tr><tr><td><code>GET /api/v1/network/stake</code></td><td>Fetches staking-related information.</td></tr></tbody></table>
For full request/response details, parameters, and interactive API playgrounds for each endpoint, see the API reference pages in the sidebar. For an overview of the Simple Fees model, see [Fee Model](/hedera/core-concepts/fee-model).
2 changes: 0 additions & 2 deletions openapi.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -941,8 +941,6 @@ paths:
schema:
format: binary
type: string
description: A protobuf encoded HAPI Transaction
required: true
responses:
200:
description: OK
Expand Down
Loading