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

# ParaLens — Ethereum Transaction Intelligence API

> ParaLens turns any Ethereum transaction hash into a structured TxReport — covering intent, value flow, economics, and DeFi context.

ParaLens is a free HTTP API that decodes any Ethereum transaction into a structured **TxReport** JSON object. Whether you're building a transaction explorer, an AI agent that reasons about on-chain activity, a wallet history enricher, or a compliance triage tool — ParaLens gives you a clean, machine-readable breakdown covering intent classification, token flows, economics, DeFi position effects, structural motifs, and actor attribution. No signup. No API key. Just POST a hash and read the report.

<CardGroup cols={2}>
  <Card title="Quick Start" icon="rocket" href="/docs/quickstart">
    Send your first /analyze request in under 5 minutes
  </Card>

  <Card title="API Reference" icon="code" href="/docs/api-reference/overview">
    Full endpoint and schema documentation
  </Card>

  <Card title="Use Cases" icon="chart-network" href="/docs/use-cases/transaction-visualizer">
    See how teams use ParaLens in production
  </Card>

  <Card title="Integration Guides" icon="puzzle-piece" href="/docs/guides/frontend-integration">
    Connect ParaLens to your app or agent
  </Card>
</CardGroup>

## How It Works

<Steps>
  <Step title="No signup needed">
    The API is free and requires no authentication today. Just pick a transaction hash and start querying.
  </Step>

  <Step title="POST a transaction hash to /analyze">
    Send a JSON body containing your `chain` and `tx_hash` to `https://paralens-production.up.railway.app/analyze`.
  </Step>

  <Step title="Read the TxReport">
    The response contains a full structured report: intent classification, token economics, actor attribution, and more.
  </Step>

  <Step title="Build your UI or feed the report to an LLM">
    Use the TxReport directly in your frontend, pipe it into an AI agent, or stream it into a compliance workflow.
  </Step>
</Steps>

## Feature Highlights

<CardGroup cols={3}>
  <Card title="25+ Intent Kinds" icon="tag">
    Swap, Arbitrage, MEV, Liquidation, Bridge, Deposit, Withdrawal, and more — every transaction gets a label.
  </Card>

  <Card title="Actor Attribution" icon="user-magnifying-glass">
    Identifies the true economic actor, even when the signer is a router, bot, or smart wallet.
  </Card>

  <Card title="Token Flow" icon="arrow-right-arrow-left">
    Per-subject inventory deltas show exactly who sent what to whom and in which direction.
  </Card>

  <Card title="Realized PnL" icon="chart-line">
    Computes profit and loss for atomic, self-closing flows such as on-chain arbitrage.
  </Card>

  <Card title="DeFi Position Effects" icon="building-columns">
    Surfaces borrow, repay, collateral, and liquidity events from lending and AMM protocols.
  </Card>

  <Card title="Motif Proofs" icon="fingerprint">
    Structural patterns like ProtocolSwap and ClosedValueFlow serve as auditable evidence behind every classification.
  </Card>
</CardGroup>