---
title: "Per-Entity DAT Data"
method: GET
path: "/v1/dat/entity"
tags: ["DAT Analytics"]
---

# Per-Entity DAT Data

`GET /v1/dat/entity`

## Request

- Base URL: `https://api.blocklens.co` (the document declares no server; this is the origin it was published from)
- URL: `https://api.blocklens.co/v1/dat/entity`
- Auth: HTTP bearer

Returns daily BTC holdings data for a single entity (bitcoin only).

**Parameters:**
- **id**: Entity/company ID (integer)
- **entity**: Entity name or ticker (e.g., 'strategy', 'MSTR', 'tesla') — alternative to id
- **from_date**: Start date filter (YYYY-MM-DD)
- **to_date**: End date filter (YYYY-MM-DD)
- **limit**: Number of records (default 100, max 10000)

**Fields returned:**
- **amount**: BTC held by the entity
- **total_current_value_usd**: Current USD value of holdings
- **percentage_of_total_supply**: Percentage of total BTC supply held
- **net_flow_btc**: Daily change in BTC holdings
- **cumulative_flow_btc**: Running sum of daily BTC flow changes
- **market_share_pct**: Entity share of total DAT BTC holdings
- **aum**: Assets under management (BTC × price)
- **realized_price**: Average cost basis (purchase price) per BTC

## Query parameters

- `id` integer, nullable: Entity/company ID
- `entity` string, nullable: Entity name or ticker (e.g., 'strategy', 'MSTR', 'tesla')
- `from_date` string, date, nullable: Start date (YYYY-MM-DD)
- `to_date` string, date, nullable: End date (YYYY-MM-DD)
- `limit` integer: Number of records to return
- `fields` string, nullable: Comma-separated field names to include (date columns always kept)

## Response `200`

Successful Response

- ApiResponse: Standard API response model
  - `success` boolean, required
  - `data` unknown, required
  - `message` string, nullable
  - `count` integer, nullable
  - `timestamp` string, date-time

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/blocklens/apis/blocklens-on-chain-api.md) · [All operations](https://skmtc.dev/blocklens/apis/blocklens-on-chain-api/llms.txt) · [OpenAPI document](https://skmtc.dev/blocklens/apis/blocklens-on-chain-api/revisions/dacc02ae0f9a?raw)