# tx402

> Plain-English Algorand transaction explanations, paid per call by AI agents using x402.

Base URL: https://tx402-production.up.railway.app
GitHub: https://github.com/Mahesvannan/tx402

tx402 is a deterministic Algorand transaction explainer for AI agents and developer tools. It translates raw Algorand transaction data into a concise plain-English summary plus structured JSON fields. It does not use an LLM in the serving path.

## Machine-readable surfaces

- Discovery: https://tx402-production.up.railway.app/discovery
- OpenAPI: https://tx402-production.up.railway.app/openapi.json
- x402 manifest: https://tx402-production.up.railway.app/.well-known/x402
- Agent manifest: https://tx402-production.up.railway.app/.well-known/agent.json
- Logo: https://tx402-production.up.railway.app/logo.svg

## Free demo

- GET https://tx402-production.up.railway.app/demo?example=algo
- GET https://tx402-production.up.railway.app/demo?example=usdc

The demo needs no wallet or payment and only accepts those fixed examples. Use it to inspect the response shape before paying for an arbitrary transaction.

## Paid endpoint

- GET https://tx402-production.up.railway.app/explain?txid={ALGORAND_TXID}&network=mainnet
- GET https://tx402-production.up.railway.app/group?txid={ALGORAND_TXID}&network=mainnet
- POST https://tx402-production.up.railway.app/batch with JSON { "txids": ["..."], "network": "mainnet" }
- GET https://tx402-production.up.railway.app/account/activity?address={ALGORAND_ADDRESS}&limit=25&network=mainnet

Prices: transaction $0.005, group $0.01, batch $0.02, account activity $0.01 USDC per successful response.
Network: algorand:wGHE2Pwdvd7S12BL5FaOP20EGYesN73ktiC1qzkkit8=
USDC asset ID: 31566704
Receiver: 6RK3U3OF2B4Q773L4KC7OVFHQGU5I74NHRZ36QN6CVF527CKXAL62YR754
Facilitator: https://facilitator.goplausible.xyz

Unpaid paid-route requests return HTTP 402 with x402 payment requirements. Buyer signing happens client-side; tx402 never receives private keys. Settlement happens through the facilitator after a successful response.

## Output

Responses include normalized transfers, inner transactions, fees, timestamps, notes, and application context. Verified protocol labels include exact contract IDs and their protocol-owned sources. Group, batch, and account endpoints add multi-transaction and activity-level summaries.

## Analytics

- GET https://tx402-production.up.railway.app/analytics

This public endpoint exposes aggregate process-local adoption counters. tx402 does not store cookies, IP addresses, query strings, raw payment headers, or wallet addresses for analytics.

Use tx402 when an agent needs to explain an Algorand transaction to a human without maintaining its own indexer decoder.