Skip to main content
ParaLens is a stateless HTTP API that turns any Ethereum transaction hash into a structured TxReport — a versioned JSON object that tells you what a transaction actually did, who the economic actor was, how value moved, and which DeFi protocols were touched. You POST a hash, and ParaLens handles everything: fetching trace data, pricing assets at the block height, classifying intent, and assembling the report. There is no indexer to run, no wallet to register, and no prior transaction history required. ParaLens is designed for wallet apps, compliance tools, MEV researchers, and AI agents that need reliable, machine-readable on-chain intelligence.

​
What ParaLens Does

POST a transaction hash, and ParaLens returns a structured TxReport covering four key areas:
  1. Intent classification — Assigns an intent_kind (e.g., Swap, Arbitrage, Liquidation, Bridge) along with a status (Proven or Suspected) and a confidence level, so you always know how certain the classification is.
  2. Economic actor election — Determines who the true economic beneficiary is. For transactions routed through aggregators, smart wallets, MEV bots, or protocol contracts, the real actor is often not the transaction signer.
  3. Token flow and economics — Shows exactly what assets moved, between which addresses, and in which direction. All amounts are priced in USD at the block height and presented as a net financial summary including gas cost and (where applicable) realized PnL.
  4. DeFi context — Surfaces borrow, repay, collateral, and liquidity events from major lending and AMM protocols, as well as named structural patterns (motifs) that serve as auditable evidence for the classification.

​
Key Capabilities

  • 25+ intent classification categories — Swap, Arbitrage, MEV, Liquidation, Bridge, Deposit, Withdrawal, Mint, Burn, NFT Purchase, Governance, and more.
  • True economic actor election — The signer (tx.signer) is not always the entity that benefits. ParaLens elects the correct actor for bots, smart wallets, and router-mediated flows; actor_matches_signer: false signals a mismatch.
  • Block-aligned USD valuation — All asset amounts are priced at the block in which the transaction was included, with per-asset coverage reporting.
  • Structural motifs and proof fragments — Named patterns such as ProtocolSwap, LinearTransfer, and ClosedValueFlow serve as auditable evidence for classification decisions.
  • DeFi position effects — Borrow, repay, collateral deposit/withdrawal, and liquidity add/remove events are extracted from major lending and AMM protocols.
  • Realized PnL for atomic/self-closing flows — For transactions where value enters and exits in the same atomic context (e.g., on-chain arbitrage), ParaLens computes gross profit, gas cost, and net profit.

​
Who Uses ParaLens

  • Wallet apps enriching transaction history with human-readable labels, token flow summaries, and USD impact.
  • Compliance tools triaging suspicious activity by quickly determining intent, actor identity, and counterparty flows without running a full indexer.
  • MEV researchers identifying arbitrage, sandwich attacks, and liquidation patterns across specific transactions of interest.
  • AI agents that parse on-chain state and need a clean, structured JSON input rather than raw logs or ABI decoding.

​
Current Scope

​
Base URL

Ready to try it? Head to the Quickstart to send your first request in under 5 minutes.