Get inflows and outflows for a blockchain entity, filterable by chain.
What it does
BlockSearch Entity Flow is an x402-payable API endpoint that returns inflow and outflow data for a specified blockchain entity. Callers provide an entity identifier and an optional comma-separated list of chains to filter results. The endpoint is hosted on blocksearch.dev, which describes itself as an "AI Block Explorer."
Payment is handled via the x402 protocol on the Solana network using USDC (mint EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v). The maximum amount required per request is 10,000 USDC base units (i.e., 0.01 USDC given 6 decimals). The endpoint accepts HTTP GET requests with query parameters.
Documentation is extremely sparse—the site's /docs, /api, /pricing, and /README pages all return 404. No OpenAPI spec, ai-plugin manifest, or agents.txt is available. The only reliable metadata comes from the x402 challenge response itself, which defines the input schema (entity and chains query params) but provides no output schema or example responses. Consumers should expect JSON output describing fund flows but will need to experiment to understand the exact response shape.
Capabilities
Use cases
- —Analyze inflows and outflows for a specific blockchain wallet or entity
- —Filter fund-flow data by one or more blockchain networks
- —Build compliance or forensic dashboards tracking entity-level fund movements
- —Power AI agents that need on-chain flow intelligence for trading or risk analysis
Fit
Best for
- —Developers building blockchain analytics tools
- —AI agents needing on-chain entity flow data via pay-per-request
- —Compliance teams tracking cross-chain fund movements
Not for
- —Users needing detailed transaction-level data (endpoint focuses on entity-level flows)
- —Anyone requiring free or high-volume bulk blockchain data exports
Quick start
curl -H "X-PAYMENT: <x402_payment_token>" \
"https://blocksearch.dev/api/entity/flow?entity=SomeEntityName&chains=solana,ethereum"Endpoint
Quality
All metadata is derived solely from the x402 challenge; the site has no documentation, no OpenAPI spec, no example responses, and every docs/pricing page returns 404. The response schema is entirely unknown.
Warnings
- —Documentation pages (/docs, /api, /pricing, /README) all return 404
- —No OpenAPI or ai-plugin manifest available
- —No output/response schema provided—response shape is unknown
- —No example responses available; consumers must discover the format experimentally
- —Site branding is minimal ('AI Block Explorer') with no further context
Citations
- —The endpoint accepts query params 'entity' (required) and 'chains' (optional comma-separated list) via HTTP GEThttps://blocksearch.dev/api/entity/flow
- —Payment is on Solana using USDC (EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v) with maxAmountRequired of 10000 base unitshttps://blocksearch.dev/api/entity/flow
- —The site describes itself as 'AI Block Explorer'https://blocksearch.dev