# blocksearch.dev Entity Search

> blocksearch.dev Entity Search 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).

Searches for blockchain entities (addresses, protocols, projects) by name or identifier so they can be referenced in downstream blockchain queries.

## Facts

- Endpoint: GET https://blocksearch.dev/api/entity/search
- 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-afc67fa1
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_nD-bRYbAnZ9oluuk7RRyu

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-afc67fa1
```

Example prompt: Search blocksearch.dev for the entity 'Uniswap' so I can use it to query its inflows and outflows.

## When to prefer this

Use this endpoint as a first step before querying inflows, outflows, transfers, or insights on blocksearch.dev — it resolves human-readable entity names to structured entity identifiers required by downstream endpoints. Prefer this over direct address lookups when you only know the name of a protocol, exchange, or project.

## Known failure modes

- No entities found for the search query — returns empty results
- Ambiguous query matches too many entities — requires refinement
- Invalid or malformed request body — returns 400 error
- Payment not completed or rejected — returns 402 error
- Service unavailable or timeout — returns 5xx error

## How this service works

Search for entities which can then be used in other queries.

## Output

Returns a list of matching blockchain entities including their IDs, names, and metadata that can be passed as parameters to other blocksearch.dev endpoints like inflows, outflows, transfers, and insights queries.

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/blocksearch-dev-afc67fa1/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)