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

# Btc Feed Recent

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

Recent Bitcoin whale flows, enriched with entity + intent data.

Returns significant BTC movements after 1-block confirmation.
order=recent (default): block_number DESC, then net_transfer_btc DESC.
order=size: net_transfer_btc DESC, then block_number DESC (largest flows first).

## Query parameters

- `limit` integer
- `min_btc` number: Minimum BTC value
- `hours` integer
- `entity_only` boolean: Only return flows with known entities
- `order` string: recent = newest blocks first; size = largest flows first

## Response `200`

Successful Response

- BtcFeedEvent[]
  - `txid` string, required
  - `block_number` integer, required
  - `block_timestamp` string, required
  - `flow_type` string, required
  - `net_btc` number, required
  - `net_usd` number, required
  - `from_entity` string, nullable
  - `from_entity_type` string, nullable
  - `to_entity` string, nullable
  - `to_entity_type` string, nullable
  - `intent` string, nullable
  - `market_signal` string, nullable
  - `signal_strength` number, nullable
  - `is_coinbase` boolean
  - `input_count` integer
  - `output_count` integer
  - `from_address` string, nullable
  - `to_address` 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)