---
title: "Feed Block Detail"
method: GET
path: "/v1/feed/block/{chain}/{block_number}"
tags: ["feed"]
---

# Feed Block Detail

`GET /v1/feed/block/{chain}/{block_number}`

## Request

- Base URL: `https://api.bitpoort.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.bitpoort.com/v1/feed/block/{chain}/{block_number}`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer

Get full detail for a single block: metadata + narrative events + whale txs.

## Path parameters

- `chain` string, required
- `block_number` integer, required

## Response `200`

Successful Response

- BlockDetailResponse
  - `chain` string, required
  - `block_number` integer, required
  - `block_hash` string, required
  - `timestamp` string, date-time, required
  - `tx_count` integer, required
  - `gas_used` integer, required
  - `gas_limit` integer, required
  - `gas_pct` number, required
  - `base_fee` integer, required
  - `miner` string, required
  - `events` FeedEvent[], required
    - `chunk_id` string, required
    - `topic` string, required
    - `type` string, required: Derived event type: whale, intent, risk, deploy, digest, swap, liquidity
    - `text` string, required
    - `tokens` integer, required
    - `tx_hash` string, nullable: Full tx hash from provenance (for etherscan links)
    - `entities` string[]: Named entities (e.g. Binance, Curve)
    - `meta_tags` string[]: Topic tags (e.g. whale, transfer)
    - `tier` string, nullable: Severity tier (LARGE, MID, etc.)
    - `confidence` integer, nullable: Confidence percentage (0-100)
    - `value_usd` number, nullable: Primary USD value extracted from text
    - `tags` object[]: User-applied tags
  - `whale_txs` WhaleTxDetail[], required
    - `tx_hash` string, required
    - `block_number` integer
    - `from_address` string, required
    - `from_label` string, nullable
    - `to_address` string, required
    - `to_label` string, nullable
    - `value_usd` number, required
    - `tier` string, required
    - `tx_type` string, required
    - `description` string, required
    - `risk_flag` string, nullable
    - `timestamp` string, date-time, nullable
    - `method_name` string, nullable
    - `protocol` string, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/bitpoort/apis/bitpoort-api.md) · [All operations](https://skmtc.dev/bitpoort/apis/bitpoort-api/llms.txt) · [OpenAPI document](https://skmtc.dev/bitpoort/apis/bitpoort-api/revisions/1a51d8566777?raw)