Estimate network fees

Given a protobuf-encoded HAPI transaction, returns an itemized fee estimate in tinycents. The response is broken down into node, network, and service components, each with a base price and a list of extras (e.g., signatures, memo bytes). The total field is the sum of all subtotals.

When the request transaction sets the HIP-1313 high_volume flag, the response includes a high_volume_multiplier. The totals in the response are not pre-multiplied — multiply total by high_volume_multiplier / 1000 to obtain the high-volume price.

mode'INTRINSIC' | 'STATE'

Estimate solely based on the transaction's inherent properties or use network state.

high_volume_throttleinteger

The high-volume throttle utilization in basis points where 10000 equals 100%. A value of 0, the default, indicates no high-volume pricing.

Response

OK

high_volume_multiplierinteger required

The high-volume pricing multiplier per HIP-1313. A value of 1 indicates no high-volume pricing. A value greater than 1 applies when the transaction's highVolume flag is true and throttle utilization is non-zero.

notesstring[]

An array of strings for any caveats.

totalinteger required

The sum of the network, node, and service subtotals in tinycents.

Example response

{
  "high_volume_multiplier": 100,
  "network": {
    "multiplier": 2,
    "subtotal": 1200
  },
  "node": {
    "base": 1000,
    "extras": [
      {
        "charged": 1,
        "count": 2,
        "fee_per_unit": 100,
        "included": 1,
        "name": "Signatures",
        "subtotal": 100
      }
    ]
  },
  "notes": [
    "Fallback to worst-case due to missing state"
  ],
  "service": {
    "base": 1000,
    "extras": [
      {
        "charged": 1,
        "count": 2,
        "fee_per_unit": 100,
        "included": 1,
        "name": "Signatures",
        "subtotal": 100
      }
    ]
  },
  "total": 1000
}

v1

Estimate network fees

Query parameters

Response

Example response