# BlockSearch Entity Flow

> BlockSearch Entity Flow is a paid API for AI agents from blocksearch.dev, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).

Returns inflows and outflows (fund movements) for a named blockchain entity, optionally filtered by chain.

## Facts

- Endpoint: GET https://blocksearch.dev/api/entity/flow
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/blocksearch-dev-854a7fb2
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_GC5dBD3tk3NXxwI1tbNVY

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability blocksearch-dev-854a7fb2
```

Example prompt: Show me the inflows and outflows for Binance on the Ethereum and Bitcoin chains using BlockSearch.

## When to prefer this

Use this endpoint when you need directional capital flow data (inflows vs outflows) for a specific named blockchain entity such as an exchange, protocol, or wallet cluster, especially when you want to filter by one or more chains. Prefer over raw transfer endpoints when you need aggregated flow summaries rather than individual transaction lists.

## Known failure modes

- Entity not found or unrecognized — returns empty result or error
- Invalid chain filter value — returns validation error
- Insufficient payment or x402 payment failure — returns 402 Payment Required
- Rate limiting or service unavailability — returns 5xx error
- Missing required entity parameter — returns 400 Bad Request

## How this service works

Get inflows and outflows for an entity. Can be filtered by chains.

## Output

Returns structured data containing inflow and outflow amounts for the queried entity, broken down by chain if filters are applied — including token volumes, transaction counts, and directional fund movement metrics.

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/blocksearch-dev-854a7fb2/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from blocksearch.dev](https://www.zero.xyz/host/blocksearch.dev/llms.txt)