Analyze wallet API

Consolidate wallet balances and observed transfer activity on Base Mainnet with block range coverage information.

The Analyze wallet operation is part of the Wallet Intelligence API on BRAINIAC.software. Consolidate wallet balances and observed transfer activity on Base Mainnet with block range coverage information. It is exposed as POST /api/v1/wallet-intelligence/analyze and priced at $0.10 USDC on Base. Payment uses the x402 exact scheme: an unpaid call returns HTTP 402 with payment requirements; after paying the exact USDC amount, retry the same request with a payment-signature header and Idempotency-Key. No account and no API key are required. Data sources for this product: Base public JSON-RPC for blockchain data (mainnet.base.org). DeFiLlama free price API for token valuations (api.llama.fi). GoPlus Labs API for address security and approval checks (api.gopluslabs.io). Limitations: Only Base Mainnet (chain ID 8453) is supported. Token balances require explicit token contract addresses. USD valuations depend on DeFiLlama price availability. Does not claim complete wallet transaction history or token holdings. Historical transfer valuation is not profit/loss. Block range scans are limited to 10,000 blocks to respect public RPC rate limits. Security checks are based on GoPlus Labs threat intelligence and may not detect all threats. Outputs are compliance prechecks, drafts, or data lookups for human review. They are not official determinations, legal advice, identity confirmation, or certified filings. Related operations in this group include Get wallet snapshot, Get wallet transfers, Inspect transaction, Check address security. Open the group documentation for the full request schema, field notes, and response examples before integrating.

POST$0.10 USDC
/api/v1/wallet-intelligence/analyze

Example request

curl -i -X POST "https://www.brainiac.software/api/v1/wallet-intelligence/analyze" \
  -H 'content-type: application/json' \
  -H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
  --data-binary @- <<'JSON'
{
  "walletAddress": "0x1234567890123456789012345678901234567890",
  "tokenAddresses": [
    "0x833589fCD6eDb6E08f4c7C32D4f71b54bA029339b"
  ],
  "fromBlock": 18000000
}
JSON

An unpaid probe returns HTTP 402 with x402 payment requirements. After paying the exact USDC amount on Base, retry the identical request with a payment-signature header.

FAQ

  • Do I need an API key? No. Pay the listed USDC amount with x402.
  • What network? Base (eip155:8453), USDC.
  • Is this an official determination? No. Results are for human review against the cited sources.

Related APIs

Wallet Intelligence APIFull docsHow it works