All API methods

Every method is a GET under one prefix:

https://tracefast.xyz/api/v1/chains/1

The paths below continue it. Every method can also be called without a key, paid per call, at the same path on https://mpp.tracefast.xyz/api/v1/chains/1 — see Paying with x402 — and is a tool on the MCP server. The plan is the lowest one that opens the method; higher plans include it — see plans. What every method has in common is on Conventions.

Addresses

Method	Path and parameters	Returns	Plan
Resolve a name	`/resolve` `?q` `?limit`	the addresses a name, ENS name, token symbol or token name can mean, best first, each with the name TraceFast shows for it and how it is presented	Intelligence
One address	`/entities/{address}`	the address as the chain sees it now: whether it holds code, its native balance and nonce, when it was first and last seen	Enriched Data
Activity	`/entities/{address}/activity`	when it was first mentioned on chain, when its own state last changed and how often, and the newest block each activity source saw it at	Enriched Data
Daily activity	`/entities/{address}/daily-activity` `?period`	per day, how many blocks changed its state and which kind of change	Enriched Data
Balance history	`/entities/{address}/balance-history` `?limit`	its native balance at the end of each day it changed, with net change, USD value and totals	Enriched Data
Portfolio	`/entities/{address}/portfolio` `?block` `?limit`	everything it holds, valued in USD, with the count of what could not be valued	Intelligence
Token balance	`/entities/{address}/tokens/{token}/balance` `?block`	`balanceOf` for one token, for the covered tokens — or a refusal, never a fake zero	Intelligence
Counterparties	`/entities/{address}/counterparties` `?block` `?limit`	the addresses it deals with most, ranked by successful transactions	Intelligence
Transactions	`/entities/{address}/transactions` `?direction` `?status` `?fromBlock` `?toBlock` `?limit` `?cursor`	the transactions it sent or received, newest first	Investigation
Token transfers	`/entities/{address}/token-transfers` `?direction` `?token` `?fromBlock` `?toBlock` `?limit` `?cursor`	the token transfers it sent or received, newest first	Investigation
Internal transfers	`/entities/{address}/internal-transfers` `?direction` `?fromBlock` `?toBlock` `?limit` `?cursor`	the value-carrying call frames it sent or received inside transactions	Investigation

Attributes & relations

Method	Path and parameters	Returns	Plan
Attributes	`/entities/{address}/attributes`	the facts proven about the address now — what kind of account it is, how it has been used, what it is known to be	Intelligence
Attributes at a block	`/entities/{address}/attributes/at-block` `?block`	the attributes it held at the end of one block, each with the window it held for	Intelligence
Attribute history	`/entities/{address}/attributes/history` `?limit`	every attribute interval it has held, oldest first	Intelligence
Attribute proof	`/entities/{address}/attributes/{attribute_id}/proof`	the evidence behind one attribute: the facts checked, expected and observed values, the block it was pinned to	Intelligence
Relations	`/entities/{address}/relations` `?direction` `?attributeId` `?limit` `?cursor`	the relations it holds now — proxy implementation, beacon, admin, delegation — as subject or object	Intelligence
Relations at a block	`/entities/{address}/relations/at-block` `?block`	the relations it was the subject of at the end of one block	Intelligence
Relation history	`/entities/{address}/relations/history` `?direction` `?attributeId` `?limit` `?cursor`	every relation interval it has held, oldest first	Intelligence
Relation proof	`/entities/{address}/relations/{attribute_id}/{object}/proof`	the evidence behind one relation between two addresses	Intelligence

The attribute ids themselves are explained in the attribute dictionary and derived attributes.

Tokens

Method	Path and parameters	Returns	Plan
One token	`/tokens/{token}`	a token contract: its observed standard, the symbol, name and decimals it declares, its transfer count, its holders now and all-time	Enriched Data
Token holders	`/tokens/{token}/holders` `?limit`	its largest current holders and how many addresses hold it	Intelligence
Token transfers	`/tokens/{token}/transfers` `?from` `?to` `?eventType` `?fromBlock` `?toBlock` `?limit` `?cursor`	its transfer events, newest first	Enriched Data
Token statistics	`/tokens/stats`	how many token contracts, transfers and holder positions the chain has, in total and per standard	Enriched Data

Blocks

Method	Path and parameters	Returns	Plan
Latest block	`/blocks/latest`	the most recent block: its header and the totals of what it contains	Enriched Data
One block	`/blocks/{number}`	one block by height: its header and the totals of what it contains	Enriched Data
Block transactions	`/blocks/{number}/transactions` `?limit` `?cursor`	its transactions in block order, each with the receipt's outcome	Enriched Data
Block withdrawals	`/blocks/{number}/withdrawals` `?validatorIndex` `?address` `?limit` `?cursor`	the validator withdrawals paid out in the block: index, validator, recipient and amount	Enriched Data
Block authorizations	`/blocks/{number}/authorizations` `?limit` `?cursor`	every EIP-7702 authorization its transactions carried: delegation target, signer, chain id, nonce, signature and carrying transaction	Enriched Data
Block addresses	`/blocks/{number}/addresses` `?limit` `?cursor`	every account whose balance, nonce or code changed in the block, with the balance before and after	Intelligence

Transactions

Method	Path and parameters	Returns	Plan
One transaction	`/transactions/{hash}`	one transaction: parties, value, gas and fee fields, outcome and position	Enriched Data
Transaction events	`/transactions/{hash}/events` `?limit` `?cursor`	the event logs it emitted, decoded where the signature is known	Enriched Data
Why it reverted	`/transactions/{hash}/failures`	the failed call frames of a reverted transaction and the error each raised	Enriched Data
Execution trace	`/traces/{hash}` `?includeCalldata`	every call frame it executed, in order, with value, gas and outcome	Investigation
Call frames, paged	`/traces/{hash}/frames` `?limit` `?cursor`	the whole call tree frame by frame, page by page — no frame cap	Investigation
Storage writes	`/transactions/{hash}/storage-writes` `?limit` `?cursor`	every contract storage slot it wrote, in execution order, with the frame that wrote it	Investigation

Contracts

Method	Path and parameters	Returns	Plan
One contract	`/contracts/{address}`	a deployed contract: its code, what the code exposes, the proxy pattern and its lifecycle	Enriched Data
Bytecode	`/contracts/{address}/bytecode`	its runtime bytecode, code hash and a structural fingerprint	Enriched Data
Function selectors	`/contracts/{address}/selectors`	the 4-byte selectors in its bytecode, resolved to signatures where known	Enriched Data
Proxy implementations	`/contracts/{address}/proxy`	the implementations a proxy has been observed delegating to, newest first	Enriched Data
Contract events	`/contracts/{address}/events` `?topic0` `?fromBlock` `?toBlock` `?limit` `?cursor`	the event logs it emitted, newest first, decoded where known	Investigation

Consensus

Method	Path and parameters	Returns	Plan
Validator queues now	`/consensus/current`	the queues by the Electra rules at the newest sampled epoch — deposits, exits, consolidations, partial withdrawals — with churn, estimated waits and the validator counts by status	Intelligence
Validator queues over time	`/consensus/queues` `?limit`	the queues and status counts now plus one closing point per UTC day, up to 90 days	Intelligence
Block proposers	`/consensus/proposers` `?period` `?groupBy` `?limit`	who proposed the most blocks over a window, by validator or by withdrawal address	Intelligence
Validator withdrawals	`/consensus/validators/{index}/withdrawals` `?fromBlock` `?toBlock` `?limit` `?cursor`	the withdrawals paid out for one validator, newest first, in a window of about 30 days at most	Intelligence

Risk

Method	Path and parameters	Returns	Plan
Blacklist status	`/risk/blacklists/{address}`	every issuer contract that ever placed the address on its on-chain blacklist, listed now or not, with the first and latest events	Investigation
Blacklist events	`/risk/blacklists/{address}/events` `?issuerContract` `?action` `?limit` `?cursor`	every listing, unlisting and enforcement event about the address, newest first	Investigation

An on-chain listing is a fact about an issuer contract's state, not a legal or sanctions determination.

API overview — the ways to call
Connect an AI agent over MCP — the same methods as tools for AI agents
API keys — sending the key, plans and limits
Conventions — requests, responses, errors and pagination
Paying with x402 — the key-less way, for AI agents

Last updated 22 Oct 2026, 08:06 UTC · verified against TraceFast v1.0.261 · Markdown