---
title: "Fees"
method: GET
path: "/btc/network-data/fees"
tags: ["BTC Network Data"]
---

# Fees

`GET /btc/network-data/fees`

This endpoint returns the statistics related to fees that are paid to bitcoin miners. In general, fees are calculated by subtracting the newly issued bitcoin from the total block reward of each blocks. We provide three statistics, `fees_total`, the sum of all fees, `fees_block_mean`, the average fee per block, and `fees_reward_percent`, the percentage of fees relative to the total block reward. Additionally, these can be viewed in terms of USD.

## Query parameters

- `window` string
- `from` string
- `to` string
- `limit` integer
- `format` string

## Response `200`

fees_total, fees_total_usd, fees_block_mean, fees_block_mean_usd, fees_reward_percent.

- object
  - `status` object, required — The status object is return with most of requests and indicates if the request was successful. If it is not successful, error information is included.
    - `code` integer, required — HTTP status code
    - `message` string, required — Text description of the error or success.
  - `result` object, required
    - `window` string, required — The size of window. It can be day, hour, or block, and it depends on the user request.
    - `data` object[], required
      - `blockheight` string — The height of the block. This optional field only appears when window=block is used.
      - `date` string — The date in YYYY-DD-MM. This optional field only appears when window=day is used.
      - `datetime` string — The date and time formatted as YYYY-MM-DD HH:MM:SS (UTC time). This field only appears when window=block is used.
      - `fees_block_mean` number, required — The average fee per block.
      - `fees_block_mean_usd` number, required — The average fee per block, calculated in USD.
      - `fees_total` number, required — The sum of all fees that are paid to bitcoin miners.
      - `fees_total_usd` number, required — The sum of all fees that are paid to bitcoin miners, calculated in USD.
      - `fees_reward_percent` number, required — The percentage of fee in total block reward. Values are between 0 and 1.

---

[API](https://skmtc.net/cryptoquant/apis/cryptoquant-data-api.md) · [All operations](https://skmtc.net/cryptoquant/apis/cryptoquant-data-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cryptoquant/cryptoquant-data-api/revisions/81ee223d4908/schema)
