blocksearch.dev · list

Get list of insights about entities, chains, tokens, and more with configurable filters.

Call it in 30 seconds

// This service settles on solana.
// Use an x402 client with a matching signer (e.g. an @x402 Solana client).
// First, inspect the payment terms for free:
const r = await fetch("https://blocksearch.dev/api/insights/list"); // returns HTTP 402 + machine-readable terms
console.log(r.status, await r.json());

# This service settles on solana.
# Use an x402 client with a matching signer. To see the terms first, for free:
import httpx
r = httpx.get("https://blocksearch.dev/api/insights/list")  # HTTP 402 + machine-readable payment terms
print(r.status_code, r.json())

# 1) An unpaid request returns HTTP 402 with the exact payment terms:
curl -i "https://blocksearch.dev/api/insights/list?entityIds={'description': 'Comma-separated list of entity IDs to filter by', 'type': 'string'}&fromTime={'description': 'Filter insights from this time (timestamp in milliseconds)', 'type': 'string'}&insightIds={'description': 'Comma-separated list of specific insight IDs to retrieve', 'type': 'string'}&pageFrom={'description': 'Starting page number for pagination. Default: 0', 'type': 'number'}&pageTo={'description': 'Ending page number for pagination. Default: 10', 'type': 'number'}&searchQuery={'description': 'Search query to filter insights', 'type': 'string'}&tags={'description': 'Comma-separated list of tags to filter by. These are the only allowable tags: hack, listing, delisting, airdrop, macroeconomic, burn, whale, buyback, partnership, regulation, political, pump, dump, sentiment, on-chain_trade', 'type': 'string'}&timeLast={'description': 'Relative time filter. For example: "24h" for last 24 hours, "7d" for last 7 days', 'type': 'string'}&toTime={'description': 'Filter insights to this time (timestamp in milliseconds)', 'type': 'string'}&tokenIds={'description': 'Comma-separated list of token IDs to filter by', 'type': 'string'}&topN={'description': 'The number of top tokens to retrieve insights for. If provided, only news from the top N tokens will be retrieved.', 'type': 'string'}"

# 2) Paying + retrying requires an x402 client that can sign the USDC
#    authorization (curl alone cannot). See the JS / Python tabs below.

New to x402? Read the 5-minute quickstart →