# TraceFast

> Answers about Ethereum addresses, tokens and transactions for agents: who an address is (exchange, project, ENS, token), whether a token can be paused, minted, upgraded or blacklisted, whether USDC, USDT or another issuer has blacklisted an address, why a transaction reverted — each with the evidence behind it. 46 methods: 45 paid per call over x402, 1 free — no API key, no account.

Data: Ethereum mainnet only (chain id 1). Payment: USDC 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 on Base (eip155:8453) — the payment network is not the data network.

## Try it free

- `GET /api/v1/chains/1/blocks/latest` — The latest block — free, no payment. Docs: https://docs.tracefast.xyz/api/block-latest.md
- `GET /api/v1/openapi.json` — OpenAPI document: every method with its parameters and response schema.
- `GET /.well-known/x402` — service manifest: every method with its id, tier and price.

## Endpoints

Price per call, by the depth of the answer: 0.005 / 0.01 / 0.025 / 0.05 / 0.10 USDC. A call that ends in an error (4xx, 5xx) is not charged. Path {address}, {token} and {object}: 0x-prefixed, 40 hex; {hash}: 0x-prefixed, 64 hex; {number}: block height; {index}: validator index. Query parameters are in each method's docs.

### Who is this address, and can it be trusted

- `GET /api/v1/chains/1/resolve` — Who is this address — its known name (exchange, project, ENS, token); or find an address by name or symbol. 0.025 USDC. Docs: https://docs.tracefast.xyz/api/entity-resolve.md
- `GET /api/v1/chains/1/entities/{address}/attributes` — What an address is: wallet or contract, proxy, token — and whether the token can be paused, minted, upgraded or blacklisted. 0.025 USDC. Docs: https://docs.tracefast.xyz/api/address-attributes.md
- `GET /api/v1/chains/1/risk/blacklists/{address}` — Is an address on a token issuer's on-chain blacklist (USDC, USDT and others), and were its funds frozen. 0.10 USDC. Docs: https://docs.tracefast.xyz/api/risk-blacklist-status.md
- `GET /api/v1/chains/1/risk/blacklists/{address}/events` — Blacklist history of an address: listed, unlisted, funds frozen. 0.10 USDC. Docs: https://docs.tracefast.xyz/api/risk-blacklist-events.md
- `GET /api/v1/chains/1/entities/{address}/counterparties` — Who an address deals with most: its top 100 counterparties. 0.05 USDC. Docs: https://docs.tracefast.xyz/api/address-counterparties.md
- `GET /api/v1/chains/1/entities/{address}/portfolio` — Everything an address holds, valued in USD. 0.05 USDC. Docs: https://docs.tracefast.xyz/api/address-portfolio.md
- `GET /api/v1/chains/1/entities/{address}/relations` — What an address is tied to: implementation, beacon, admin, delegation. 0.025 USDC. Docs: https://docs.tracefast.xyz/api/address-relations.md
- `GET /api/v1/chains/1/entities/{address}/attributes/{attribute_id}/proof` — The evidence behind one proven trait of an address. 0.025 USDC. Docs: https://docs.tracefast.xyz/api/address-attribute-proof.md
- `GET /api/v1/chains/1/entities/{address}/relations/{attribute_id}/{object}/proof` — The evidence behind one proven tie between two addresses. 0.025 USDC. Docs: https://docs.tracefast.xyz/api/address-relation-proof.md
- `GET /api/v1/chains/1/entities/{address}/attributes/at-block` — What an address was at a past block. 0.025 USDC. Docs: https://docs.tracefast.xyz/api/address-attributes-at-block.md
- `GET /api/v1/chains/1/entities/{address}/attributes/history` — How an address changed over time: every trait it held and when. 0.025 USDC. Docs: https://docs.tracefast.xyz/api/address-attribute-history.md
- `GET /api/v1/chains/1/entities/{address}/relations/at-block` — What an address was tied to at a past block. 0.025 USDC. Docs: https://docs.tracefast.xyz/api/address-relations-at-block.md
- `GET /api/v1/chains/1/entities/{address}/relations/history` — How the ties of an address changed over time. 0.025 USDC. Docs: https://docs.tracefast.xyz/api/address-relation-history.md

### Is this token or contract safe to touch

- `GET /api/v1/chains/1/contracts/{address}` — What a contract is: its code, proxy pattern and who deployed it. 0.005 USDC. Docs: https://docs.tracefast.xyz/api/contract.md
- `GET /api/v1/chains/1/contracts/{address}/proxy` — Where a proxy points: its current and past implementations. 0.01 USDC. Docs: https://docs.tracefast.xyz/api/contract-proxy.md
- `GET /api/v1/chains/1/contracts/{address}/selectors` — Which functions a contract exposes, by decoded selector. 0.005 USDC. Docs: https://docs.tracefast.xyz/api/contract-selectors.md
- `GET /api/v1/chains/1/contracts/{address}/bytecode` — Runtime bytecode of a contract. 0.005 USDC. Docs: https://docs.tracefast.xyz/api/contract-bytecode.md
- `GET /api/v1/chains/1/contracts/{address}/events` — Events emitted by a contract. 0.10 USDC. Docs: https://docs.tracefast.xyz/api/contract-events.md
- `GET /api/v1/chains/1/tokens/{token}` — One token: standard, symbol, decimals, transfer and holder counts. 0.005 USDC. Docs: https://docs.tracefast.xyz/api/token.md
- `GET /api/v1/chains/1/tokens/{token}/holders` — Largest holders of a token. 0.05 USDC. Docs: https://docs.tracefast.xyz/api/token-holders.md
- `GET /api/v1/chains/1/tokens/{token}/transfers` — Transfers of a token. 0.05 USDC. Docs: https://docs.tracefast.xyz/api/token-transfers.md
- `GET /api/v1/chains/1/entities/{address}/tokens/{token}/balance` — Balance of one token on an address, now or at a past block. 0.01 USDC. Docs: https://docs.tracefast.xyz/api/address-token-balance.md
- `GET /api/v1/chains/1/tokens/stats` — Token statistics of the network. 0.005 USDC. Docs: https://docs.tracefast.xyz/api/token-stats.md

### What did this transaction do, and why did it fail

- `GET /api/v1/chains/1/transactions/{hash}/failures` — Why a transaction reverted: the failed calls and their decoded errors. 0.01 USDC. Docs: https://docs.tracefast.xyz/api/transaction-failures.md
- `GET /api/v1/chains/1/traces/{hash}` — Everything a transaction executed, call by call. 0.10 USDC. Docs: https://docs.tracefast.xyz/api/trace.md
- `GET /api/v1/chains/1/traces/{hash}/frames` — Call frames of a transaction, paged. 0.10 USDC. Docs: https://docs.tracefast.xyz/api/trace-frames.md
- `GET /api/v1/chains/1/transactions/{hash}/storage-writes` — Storage writes of a transaction. 0.10 USDC. Docs: https://docs.tracefast.xyz/api/transaction-storage-writes.md
- `GET /api/v1/chains/1/transactions/{hash}/events` — Decoded event logs of a transaction. 0.005 USDC. Docs: https://docs.tracefast.xyz/api/transaction-events.md
- `GET /api/v1/chains/1/transactions/{hash}` — One transaction. 0.005 USDC. Docs: https://docs.tracefast.xyz/api/transaction.md

### What has this address been doing

- `GET /api/v1/chains/1/entities/{address}` — One address at a glance: balance, nonce, code, first and last activity. 0.005 USDC. Docs: https://docs.tracefast.xyz/api/address.md
- `GET /api/v1/chains/1/entities/{address}/activity` — When an address was first seen and last active. 0.01 USDC. Docs: https://docs.tracefast.xyz/api/address-activity.md
- `GET /api/v1/chains/1/entities/{address}/daily-activity` — Daily activity of an address. 0.01 USDC. Docs: https://docs.tracefast.xyz/api/address-daily-activity.md
- `GET /api/v1/chains/1/entities/{address}/balance-history` — Native balance of an address day by day, with USD value. 0.01 USDC. Docs: https://docs.tracefast.xyz/api/address-balance-history.md
- `GET /api/v1/chains/1/entities/{address}/transactions` — Transactions of an address. 0.10 USDC. Docs: https://docs.tracefast.xyz/api/entity-transactions.md
- `GET /api/v1/chains/1/entities/{address}/token-transfers` — Token transfers of an address. 0.10 USDC. Docs: https://docs.tracefast.xyz/api/entity-token-transfers.md
- `GET /api/v1/chains/1/entities/{address}/internal-transfers` — Internal transfers of an address. 0.10 USDC. Docs: https://docs.tracefast.xyz/api/entity-internal-transfers.md

### Blocks and validators

- `GET /api/v1/chains/1/blocks/latest` — The latest block — free, no payment. free. Docs: https://docs.tracefast.xyz/api/block-latest.md
- `GET /api/v1/chains/1/blocks/{number}` — One block: header and totals. 0.005 USDC. Docs: https://docs.tracefast.xyz/api/block.md
- `GET /api/v1/chains/1/blocks/{number}/transactions` — Transactions of one block. 0.01 USDC. Docs: https://docs.tracefast.xyz/api/block-transactions.md
- `GET /api/v1/chains/1/blocks/{number}/addresses` — Accounts touched by one block. 0.025 USDC. Docs: https://docs.tracefast.xyz/api/block-addresses.md
- `GET /api/v1/chains/1/blocks/{number}/authorizations` — EIP-7702 authorizations of one block. 0.01 USDC. Docs: https://docs.tracefast.xyz/api/block-authorizations.md
- `GET /api/v1/chains/1/blocks/{number}/withdrawals` — Validator withdrawals of one block. 0.01 USDC. Docs: https://docs.tracefast.xyz/api/block-withdrawals.md
- `GET /api/v1/chains/1/consensus/current` — Validator entry and exit queues now. 0.005 USDC. Docs: https://docs.tracefast.xyz/api/consensus-current.md
- `GET /api/v1/chains/1/consensus/queues` — Validator queues over time. 0.025 USDC. Docs: https://docs.tracefast.xyz/api/consensus-queues.md
- `GET /api/v1/chains/1/consensus/proposers` — Block-proposal leaderboard. 0.05 USDC. Docs: https://docs.tracefast.xyz/api/consensus-proposers.md
- `GET /api/v1/chains/1/consensus/validators/{index}/withdrawals` — Withdrawals of a validator. 0.025 USDC. Docs: https://docs.tracefast.xyz/api/validator-withdrawals.md

## Paying

x402 v2, scheme `exact`. An unpaid request answers 402: the JSON body states the price and what the call returns, the `PAYMENT-REQUIRED` header carries the payment requirements. Sign them with an x402 client and repeat the request with the `PAYMENT-SIGNATURE` header.

## Docs

- https://docs.tracefast.xyz/api.md — public API
- https://docs.tracefast.xyz/api/x402.md — paying per call over x402