Query blockchain insights filtered by entity, token, chain, tag, and time range via x402 micropayment.
What it does
The BlockSearch Insights List endpoint returns a paginated list of blockchain-related insights covering entities, chains, tokens, and market events. Callers can filter results by time range (absolute timestamps or relative like "24h", "7d"), search query, token IDs, entity IDs, specific insight IDs, and a curated set of tags including hack, listing, delisting, airdrop, macroeconomic, burn, whale, buyback, partnership, regulation, political, pump, dump, sentiment, and on-chain_trade. A `topN` parameter lets you scope results to only the top N tokens.
The endpoint is accessed via HTTP GET with query parameters and is gated by the x402 micropayment protocol on Solana. Each request costs up to 10,000 units of the USDC token (EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v) — likely 0.01 USDC given 6-decimal precision. Payment is made through the X-PAYMENT header using the "exact" scheme. The endpoint returned a valid 402 challenge during probing, confirming it is live.
BlockSearch brands itself as an "AI Block Explorer." Documentation pages (/docs, /api, /pricing) all return 404, so detailed response schemas and usage guides are unavailable. The output schema in the x402 challenge fully documents the accepted query parameters but does not describe the response body structure. Users should expect JSON insight objects but will need to inspect actual responses to determine exact fields.
Capabilities
Use cases
- —Retrieve recent blockchain insights about hacks, airdrops, or whale movements for a trading bot
- —Filter crypto news by specific tokens or entities to build a research dashboard
- —Monitor regulatory and macroeconomic events affecting top N tokens
- —Search for sentiment or pump/dump signals across the blockchain ecosystem
- —Paginate through historical blockchain insights within a custom time window
Fit
Best for
- —AI agents needing structured blockchain event data
- —Crypto trading bots filtering on-chain signals by tag or token
- —Research tools aggregating blockchain news and insights
Not for
- —Real-time streaming of blockchain transactions (this is a paginated list endpoint)
- —Non-crypto use cases — all data is blockchain/token focused
- —Users who need free access — every request requires x402 USDC micropayment
Quick start
curl -H "X-PAYMENT: <x402_payment_header>" \
"https://blocksearch.dev/api/insights/list?timeLast=24h&tags=whale,hack&pageFrom=0&pageTo=5"Endpoint
Quality
The x402 challenge is live and provides a detailed input schema with well-documented query parameters and tags. However, no response schema, documentation, examples, or pricing page is available — all doc URLs return 404. The response body structure must be inferred from actual calls.
Warnings
- —No documentation available — /docs, /api, and /pricing all return 404
- —Response body schema is not documented; only input query parameters are described in the x402 challenge
- —Exact cost interpretation is uncertain: maxAmountRequired is 10000 in USDC (likely 0.01 USDC with 6 decimals) but not explicitly confirmed
Citations
- —The endpoint returns a 402 challenge with x402Version 1 on GET requests, confirming it is livehttps://blocksearch.dev/api/insights/list
- —Payment is in USDC on Solana (asset EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v) with maxAmountRequired of 10000https://blocksearch.dev/api/insights/list
- —Allowed tags include hack, listing, delisting, airdrop, macroeconomic, burn, whale, buyback, partnership, regulation, political, pump, dump, sentiment, on-chain_tradehttps://blocksearch.dev/api/insights/list
- —BlockSearch brands itself as an AI Block Explorerhttps://blocksearch.dev
- —Documentation pages /docs, /api, /pricing all return 404https://blocksearch.dev/docs