> ## Documentation Index
> Fetch the complete documentation index at: https://paralens.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction to ParaLens: Ethereum Transaction API

> ParaLens is a stateless HTTP API that reconstructs full transaction intelligence from any Ethereum tx hash — no indexer, no wallet tracking required.

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

| Dimension       | Coverage                                                     |
| --------------- | ------------------------------------------------------------ |
| Network         | Ethereum mainnet only                                        |
| Granularity     | Single transaction — no multi-tx aggregation                 |
| Wallet history  | None — fully stateless, no prior context used                |
| PnL methodology | Atomic/self-closing flows only (no FIFO across transactions) |

***

## Base URL

| Environment | URL                                          |
| ----------- | -------------------------------------------- |
| Production  | `https://paralens-production.up.railway.app` |

***

Ready to try it? Head to the [Quickstart](/docs/quickstart) to send your first request in under 5 minutes.