Query blockchain transfers by address, entity, chain, token, and USD value via x402 micropayment.
What it does
BlockSearch is an AI-oriented block explorer that exposes a transfers API behind the x402 payment protocol. The `/api/transfers` endpoint returns on-chain transfer records filtered by a rich set of query parameters: base address or entity, chain(s), flow direction (in/out/self/all), sender, receiver, counterparties, token, time range, value range (raw or USD), and pagination/sorting controls. It supports multi-chain queries (e.g. "ethereum,bsc") and entity-level filtering such as "binance" or "type:cex", as well as deposit-address syntax like "deposit:binance".
Payment is handled via the x402 exact scheme on Solana. Each request costs up to 10,000 units of USDC (token EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v) with a 60-second payment timeout. The pay-to address is `5DHhYFTCwYcoUK9nh4omrcm6htGPThcnMHWcK4mCTtPz`. No OpenAPI spec or dedicated documentation page was found; all schema information is derived from the x402 challenge's `outputSchema` field.
The endpoint is a GET request. Results can be sorted by time, value, or USD amount in ascending or descending order, with configurable limit (default 50) and offset for pagination. Historical USD values are available for value-range filtering, making it useful for compliance screening, whale-watching, and cross-chain flow analysis.
Capabilities
Use cases
- —Tracking incoming and outgoing transfers for a specific wallet address across multiple chains
- —Monitoring large-value transfers (whale watching) by filtering on USD thresholds
- —Compliance screening by querying transfers between known entities and deposit addresses
- —Cross-chain flow analysis for a named entity like "binance" or "type:cex"
- —Building dashboards that aggregate transfer activity over configurable time windows
Fit
Best for
- —AI agents needing structured blockchain transfer data on demand
- —Cross-chain transfer analysis without managing multiple RPC endpoints
- —Entity-level blockchain intelligence (CEX, deposit addresses)
- —Pay-per-query blockchain analytics without subscription commitments
Not for
- —Real-time streaming of mempool or pending transactions
- —Querying non-transfer on-chain data such as smart contract state or NFT metadata
- —Users who need a free or subscription-based pricing model rather than per-request micropayments
Quick start
curl -H "X-PAYMENT: <x402_payment_token>" \
"https://blocksearch.dev/api/transfers?base=binance&chains=ethereum&flow=out&usdGte=1000000&timeLast=24h&sortKey=usd&sortDir=desc&limit=10"Example
Request
{
"url": "https://blocksearch.dev/api/transfers",
"method": "GET",
"headers": {
"X-PAYMENT": "<x402_payment_token>"
},
"queryParams": {
"base": "binance",
"flow": "out",
"limit": "20",
"chains": "ethereum,bsc",
"offset": "0",
"usdGte": 100000,
"sortDir": "desc",
"sortKey": "usd",
"timeLast": "7d"
}
}Endpoint
Quality
The x402 challenge provides a detailed input schema with well-documented query parameters, but there is no OpenAPI spec, no documentation page (all return 404), no example response, and no confirmed response schema. Pricing is only partially clear (maxAmountRequired in raw USDC units). The endpoint appears live but response format is entirely unknown.
Warnings
- —No documentation pages found — /docs, /api, /pricing, and /README all return 404.
- —No response schema or example response is available; consumers must discover the output format empirically.
- —maxAmountRequired of 10000 is in raw USDC units (likely 0.01 USDC given 6 decimals) but this is inferred and not explicitly documented.
- —No OpenAPI or ai-plugin manifest found.
Citations
- —The endpoint accepts x402 payment on Solana using USDC (EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v) with maxAmountRequired of 10000 and 60-second timeout.https://blocksearch.dev/api/transfers
- —Query parameters include base, chains, flow, from, to, tokens, counterparties, timeLast, timeGte, timeLte, valueGte, valueLte, usdGte, usdLte, sortKey, sortDir, limit, and offset as described in the outputSchema.https://blocksearch.dev/api/transfers
- —The site identifies itself as 'AI Block Explorer'.https://blocksearch.dev