---
title: "Feed Recent"
method: GET
path: "/v1/feed/recent"
tags: ["feed"]
---

# Feed Recent

`GET /v1/feed/recent`

## 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/recent`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer

Get recent blocks with pre-joined narrative events and whale counts.

Returns blocks ordered by block_number DESC, each annotated with
any event-level RAG chunks and whale transaction counts. Supports
optional since/until ISO 8601 time-window filtering and ``cursor``
keyset pagination; response includes ``next_cursor`` and
``has_more`` for the next page.

## Query parameters

- `chain` string: Chain to get feed for
- `limit` integer: Number of recent blocks
- `min_usd` number: Minimum USD volume for actions
- `since` string, nullable: ISO 8601 datetime, e.g. 2026-05-01T00:00:00Z
- `until` string, nullable: ISO 8601 datetime, e.g. 2026-05-02T00:00:00Z
- `cursor` string, nullable: Opaque cursor from a previous response's next_cursor field

## Response `200`

Successful Response

- FeedRecentResponse
  - `blocks` FeedBlock[], required
    - `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: Gas utilization percentage
    - `base_fee` integer, required
    - `events` FeedEvent[]
      - `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
    - `swap_actions` FeedSwapAction[]: Structured swap actions from swap_routes
      - `tx_hash` string, required
      - `block_number` integer, required
      - `timestamp` string, date-time, required
      - `trader_address` string, required
      - `hop_count` integer
      - `token_in` string
      - `token_in_symbol` string, nullable
      - `token_in_decimals` integer
      - `token_in_amount` number, nullable
      - `amount_in_usd` number, nullable
      - `token_out` string
      - `token_out_symbol` string, nullable
      - `token_out_decimals` integer
      - `token_out_amount` number, nullable
      - `amount_out_usd` number, nullable
      - `usd_volume` number, nullable
      - `protocol` string
      - `dex_label` string, nullable
    - `actions` FeedAction[]: Canonical actions (unified, structured)
      - `action_id` string, required
      - `action_type` string, required
      - `tx_hash` string, required
      - `actor` string, required
      - `counterparty` string, nullable
      - `actor_label` string, nullable
      - `actor_classification` string, nullable
      - `counterparty_label` string, nullable
      - `counterparty_classification` string, nullable
      - `token_in` string
      - `token_in_symbol` string, nullable
      - `token_in_amount` number, nullable
      - `amount_in_usd` number, nullable
      - `token_out` string
      - `token_out_symbol` string, nullable
      - `token_out_amount` number, nullable
      - `amount_out_usd` number, nullable
      - `usd_volume` number, nullable
      - `protocol` string, nullable
      - `label` string, nullable
      - `evidence` object
      - `data_quality` object
      - `metadata` object
    - `token_transfers` object[]: Notable ERC-20 transfers (stablecoins $1M+, other tokens $50K+
    - `intelligence` BlockIntelligence: Deterministic block-level analytics from BehaviorAnalyzer.
      - `total_actions` integer
      - `total_usd_volume` number
      - `pricing_coverage_ratio` number
      - `top_action_types` object[]
      - `top_protocols` object[]
      - `top_tokens` object[]
      - `swap_token_stats` object[]
      - `top_actors` object[]
      - `anomaly_flags` object
      - `narrative` string
      - `confidence` number
      - `confidence_components` object
      - `denominators` object
      - `evidence` object
    - `whale_count` integer
    - `whale_volume` number
    - `swap_count` integer
    - `swap_volume` number
    - `lp_count` integer
    - `lp_volume` number
    - `defi_count` integer
  - `chain` string, required
  - `count` integer, required
  - `next_cursor` string, nullable
  - `has_more` boolean

## 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)