> ## Documentation Index
> Fetch the complete documentation index at: https://kb.talostrading.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Miner Entity

## Definition

Name of the entity that mined a block.

| Name | MetricID | Unit | Interval |
| - | - | - | - |
| Miner Entity | MinerEntity | N/A | 1 block |

## Details

* Identifies the mining pool or solo miner responsible for producing each block.
* Entity identification is performed by matching coinbase transaction signatures and known pool tags against Coin Metrics' internal entity registry.
* Returned as a text string (e.g. `"Foundry USA"`, `"AntPool"`). Blocks from unknown or unidentified miners are returned as `null` or an empty string.
* Available at 1-block granularity; not aggregated to daily intervals.

## API Endpoints

Miner entity data can be accessed using the `timeseries/asset-metrics` endpoint:

`GET /timeseries/asset-metrics`

> [tab] Shell
>
> ```shell theme={null}
> curl --compressed "https://api.coinmetrics.io/v4/timeseries/asset-metrics?metrics=MinerEntity&assets=btc&frequency=1b&pretty=true&api_key=<your_key>"
> ```

> [tab] Python
>
> ```python theme={null}
> import requests
> response = requests.get('https://api.coinmetrics.io/v4/timeseries/asset-metrics?metrics=MinerEntity&assets=btc&frequency=1b&pretty=true&api_key=<your_key>').json()
> print(response)
> ```

> [tab] Python Client
>
> ```python theme={null}
> from coinmetrics.api_client import CoinMetricsClient
>
> api_key = "<API_KEY>"
> client = CoinMetricsClient(api_key)
>
> print(
>     client.get_asset_metrics(
>         metrics="MinerEntity",
>         assets="btc",
>         frequency="1b",
>     ).to_dataframe()
> )
> ```
