blocksearch.dev · transfers

Get transfers for an address or entity 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/transfers"); // 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/transfers")  # 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/transfers?base={'description': 'Filter by specific entity or address. For example: "0x123abc" or "binance". For entity, use the entity ID.', 'type': 'string'}&chains={'description': 'Comma-separated list of chains. For example: "ethereum,bsc".', 'type': 'string'}&counterparties={'description': 'Comma-separated list of addresses or entities to treat strictly as counterparties (only base <-> counterparty transfers).', 'type': 'string'}&flow={'description': 'Transfer direction: "in" for incoming, "out" for outgoing, "self" for self-transfers, or "all" for all transfers.', 'enum': ['in', 'out', 'self', 'all'], 'type': 'string'}&from={'description': 'Comma-separated list of addresses, entities, or deposit services for the \'from\' side. You can also use special syntax like "type:cex" to filter on entity types or "deposit:binance" to filter on deposit addresses.', 'type': 'string'}&limit={'description': 'Maximum number of results to return. Default: 50', 'type': 'string'}&offset={'description': 'Pagination offset. Default: 0', 'type': 'string'}&sortDir={'description': 'Sort direction: "asc" (ascending) or "desc" (descending).', 'enum': ['asc', 'desc'], 'type': 'string'}&sortKey={'description': 'Sort key for ordering results. One of: "time", "value", "usd".', 'enum': ['time', 'value', 'usd'], 'type': 'string'}&timeGte={'description': 'Time range filter (from) in milliseconds (e.g. 1696630274000).', 'type': 'string'}&timeLast={'description': 'Time range filter using relative durations. For example: "24h" for transfers in the last 24 hours, "7d" for last 7 days.', 'type': 'string'}&timeLte={'description': 'Time range filter (to) in milliseconds (e.g. 1696716674000).', 'type': 'string'}&to={'description': "Comma-separated list of addresses, entities, or deposit services for the 'to' side.", 'type': 'string'}&tokens={'description': 'Comma-separated list of token addresses or token IDs. E.g. "ethereum", "usd-coin", or "0x...tokenAddress".', 'type': 'string'}&usdGte={'description': 'Minimum historical USD value.', 'type': 'number'}&usdLte={'description': 'Maximum historical USD value.', 'type': 'number'}&valueGte={'description': 'Minimum raw token value (on-chain units).', 'type': 'number'}&valueLte={'description': 'Maximum raw token value (on-chain units).', 'type': 'number'}"

# 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 →