{
  "version": 1,
  "description": "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.",
  "instructions": "Data: Ethereum mainnet only (chain id 1). Payment: USDC 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 on Base (eip155:8453) — the payment network is not the data network. Pay per call over x402, scheme \"exact\". The price follows the depth of the answer, five tiers: 0.005 / 0.01 / 0.025 / 0.05 / 0.10 USDC; each method's price is in its 402 challenge and in \"methods\" below, and the methods under \"free\" need no payment. 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 documented per method (its docs link). No API key and no account: an unpaid request answers 402 — the body states the price and what the call returns, the PAYMENT-REQUIRED header carries the payment requirements.",
  "paymentProtocols": [
    "x402"
  ],
  "resources": [
    "GET /api/v1/chains/1/blocks/latest",
    "GET /api/v1/chains/1/blocks/{number}",
    "GET /api/v1/chains/1/consensus/current",
    "GET /api/v1/chains/1/contracts/{address}",
    "GET /api/v1/chains/1/contracts/{address}/bytecode",
    "GET /api/v1/chains/1/contracts/{address}/selectors",
    "GET /api/v1/chains/1/entities/{address}",
    "GET /api/v1/chains/1/tokens/stats",
    "GET /api/v1/chains/1/tokens/{token}",
    "GET /api/v1/chains/1/transactions/{hash}",
    "GET /api/v1/chains/1/transactions/{hash}/events",
    "GET /api/v1/chains/1/blocks/{number}/authorizations",
    "GET /api/v1/chains/1/blocks/{number}/transactions",
    "GET /api/v1/chains/1/blocks/{number}/withdrawals",
    "GET /api/v1/chains/1/contracts/{address}/proxy",
    "GET /api/v1/chains/1/entities/{address}/activity",
    "GET /api/v1/chains/1/entities/{address}/balance-history",
    "GET /api/v1/chains/1/entities/{address}/daily-activity",
    "GET /api/v1/chains/1/entities/{address}/tokens/{token}/balance",
    "GET /api/v1/chains/1/transactions/{hash}/failures",
    "GET /api/v1/chains/1/blocks/{number}/addresses",
    "GET /api/v1/chains/1/consensus/queues",
    "GET /api/v1/chains/1/consensus/validators/{index}/withdrawals",
    "GET /api/v1/chains/1/entities/{address}/attributes",
    "GET /api/v1/chains/1/entities/{address}/attributes/at-block",
    "GET /api/v1/chains/1/entities/{address}/attributes/history",
    "GET /api/v1/chains/1/entities/{address}/attributes/{attribute_id}/proof",
    "GET /api/v1/chains/1/entities/{address}/relations",
    "GET /api/v1/chains/1/entities/{address}/relations/at-block",
    "GET /api/v1/chains/1/entities/{address}/relations/history",
    "GET /api/v1/chains/1/entities/{address}/relations/{attribute_id}/{object}/proof",
    "GET /api/v1/chains/1/resolve",
    "GET /api/v1/chains/1/consensus/proposers",
    "GET /api/v1/chains/1/entities/{address}/counterparties",
    "GET /api/v1/chains/1/entities/{address}/portfolio",
    "GET /api/v1/chains/1/tokens/{token}/holders",
    "GET /api/v1/chains/1/tokens/{token}/transfers",
    "GET /api/v1/chains/1/contracts/{address}/events",
    "GET /api/v1/chains/1/entities/{address}/internal-transfers",
    "GET /api/v1/chains/1/entities/{address}/token-transfers",
    "GET /api/v1/chains/1/entities/{address}/transactions",
    "GET /api/v1/chains/1/risk/blacklists/{address}",
    "GET /api/v1/chains/1/risk/blacklists/{address}/events",
    "GET /api/v1/chains/1/traces/{hash}",
    "GET /api/v1/chains/1/traces/{hash}/frames",
    "GET /api/v1/chains/1/transactions/{hash}/storage-writes",
    "GET /api/v1/openapi.json"
  ],
  "methods": [
    {
      "id": "entity-resolve",
      "resource": "GET /api/v1/chains/1/resolve",
      "summary": "Who is this address — its known name (exchange, project, ENS, token); or find an address by name or symbol",
      "group": "Who is this address, and can it be trusted",
      "tier": 3,
      "price": "0.025",
      "amount": "25000",
      "docs": "https://docs.tracefast.xyz/api/entity-resolve.md"
    },
    {
      "id": "entity-attributes",
      "resource": "GET /api/v1/chains/1/entities/{address}/attributes",
      "summary": "What an address is: wallet or contract, proxy, token — and whether the token can be paused, minted, upgraded or blacklisted",
      "group": "Who is this address, and can it be trusted",
      "tier": 3,
      "price": "0.025",
      "amount": "25000",
      "docs": "https://docs.tracefast.xyz/api/address-attributes.md"
    },
    {
      "id": "risk-blacklist-status",
      "resource": "GET /api/v1/chains/1/risk/blacklists/{address}",
      "summary": "Is an address on a token issuer's on-chain blacklist (USDC, USDT and others), and were its funds frozen",
      "group": "Who is this address, and can it be trusted",
      "tier": 5,
      "price": "0.10",
      "amount": "100000",
      "docs": "https://docs.tracefast.xyz/api/risk-blacklist-status.md"
    },
    {
      "id": "risk-blacklist-events",
      "resource": "GET /api/v1/chains/1/risk/blacklists/{address}/events",
      "summary": "Blacklist history of an address: listed, unlisted, funds frozen",
      "group": "Who is this address, and can it be trusted",
      "tier": 5,
      "price": "0.10",
      "amount": "100000",
      "docs": "https://docs.tracefast.xyz/api/risk-blacklist-events.md"
    },
    {
      "id": "entity-counterparties",
      "resource": "GET /api/v1/chains/1/entities/{address}/counterparties",
      "summary": "Who an address deals with most: its top 100 counterparties",
      "group": "Who is this address, and can it be trusted",
      "tier": 4,
      "price": "0.05",
      "amount": "50000",
      "docs": "https://docs.tracefast.xyz/api/address-counterparties.md"
    },
    {
      "id": "entity-portfolio",
      "resource": "GET /api/v1/chains/1/entities/{address}/portfolio",
      "summary": "Everything an address holds, valued in USD",
      "group": "Who is this address, and can it be trusted",
      "tier": 4,
      "price": "0.05",
      "amount": "50000",
      "docs": "https://docs.tracefast.xyz/api/address-portfolio.md"
    },
    {
      "id": "entity-relations",
      "resource": "GET /api/v1/chains/1/entities/{address}/relations",
      "summary": "What an address is tied to: implementation, beacon, admin, delegation",
      "group": "Who is this address, and can it be trusted",
      "tier": 3,
      "price": "0.025",
      "amount": "25000",
      "docs": "https://docs.tracefast.xyz/api/address-relations.md"
    },
    {
      "id": "entity-attribute-proof",
      "resource": "GET /api/v1/chains/1/entities/{address}/attributes/{attribute_id}/proof",
      "summary": "The evidence behind one proven trait of an address",
      "group": "Who is this address, and can it be trusted",
      "tier": 3,
      "price": "0.025",
      "amount": "25000",
      "docs": "https://docs.tracefast.xyz/api/address-attribute-proof.md"
    },
    {
      "id": "entity-relation-proof",
      "resource": "GET /api/v1/chains/1/entities/{address}/relations/{attribute_id}/{object}/proof",
      "summary": "The evidence behind one proven tie between two addresses",
      "group": "Who is this address, and can it be trusted",
      "tier": 3,
      "price": "0.025",
      "amount": "25000",
      "docs": "https://docs.tracefast.xyz/api/address-relation-proof.md"
    },
    {
      "id": "entity-attributes-at-block",
      "resource": "GET /api/v1/chains/1/entities/{address}/attributes/at-block",
      "summary": "What an address was at a past block",
      "group": "Who is this address, and can it be trusted",
      "tier": 3,
      "price": "0.025",
      "amount": "25000",
      "docs": "https://docs.tracefast.xyz/api/address-attributes-at-block.md"
    },
    {
      "id": "entity-attribute-history",
      "resource": "GET /api/v1/chains/1/entities/{address}/attributes/history",
      "summary": "How an address changed over time: every trait it held and when",
      "group": "Who is this address, and can it be trusted",
      "tier": 3,
      "price": "0.025",
      "amount": "25000",
      "docs": "https://docs.tracefast.xyz/api/address-attribute-history.md"
    },
    {
      "id": "entity-relations-at-block",
      "resource": "GET /api/v1/chains/1/entities/{address}/relations/at-block",
      "summary": "What an address was tied to at a past block",
      "group": "Who is this address, and can it be trusted",
      "tier": 3,
      "price": "0.025",
      "amount": "25000",
      "docs": "https://docs.tracefast.xyz/api/address-relations-at-block.md"
    },
    {
      "id": "entity-relation-history",
      "resource": "GET /api/v1/chains/1/entities/{address}/relations/history",
      "summary": "How the ties of an address changed over time",
      "group": "Who is this address, and can it be trusted",
      "tier": 3,
      "price": "0.025",
      "amount": "25000",
      "docs": "https://docs.tracefast.xyz/api/address-relation-history.md"
    },
    {
      "id": "contract-detail",
      "resource": "GET /api/v1/chains/1/contracts/{address}",
      "summary": "What a contract is: its code, proxy pattern and who deployed it",
      "group": "Is this token or contract safe to touch",
      "tier": 1,
      "price": "0.005",
      "amount": "5000",
      "docs": "https://docs.tracefast.xyz/api/contract.md"
    },
    {
      "id": "contract-proxy",
      "resource": "GET /api/v1/chains/1/contracts/{address}/proxy",
      "summary": "Where a proxy points: its current and past implementations",
      "group": "Is this token or contract safe to touch",
      "tier": 2,
      "price": "0.01",
      "amount": "10000",
      "docs": "https://docs.tracefast.xyz/api/contract-proxy.md"
    },
    {
      "id": "contract-selectors",
      "resource": "GET /api/v1/chains/1/contracts/{address}/selectors",
      "summary": "Which functions a contract exposes, by decoded selector",
      "group": "Is this token or contract safe to touch",
      "tier": 1,
      "price": "0.005",
      "amount": "5000",
      "docs": "https://docs.tracefast.xyz/api/contract-selectors.md"
    },
    {
      "id": "contract-bytecode",
      "resource": "GET /api/v1/chains/1/contracts/{address}/bytecode",
      "summary": "Runtime bytecode of a contract",
      "group": "Is this token or contract safe to touch",
      "tier": 1,
      "price": "0.005",
      "amount": "5000",
      "docs": "https://docs.tracefast.xyz/api/contract-bytecode.md"
    },
    {
      "id": "contract-events",
      "resource": "GET /api/v1/chains/1/contracts/{address}/events",
      "summary": "Events emitted by a contract",
      "group": "Is this token or contract safe to touch",
      "tier": 5,
      "price": "0.10",
      "amount": "100000",
      "docs": "https://docs.tracefast.xyz/api/contract-events.md"
    },
    {
      "id": "token-detail",
      "resource": "GET /api/v1/chains/1/tokens/{token}",
      "summary": "One token: standard, symbol, decimals, transfer and holder counts",
      "group": "Is this token or contract safe to touch",
      "tier": 1,
      "price": "0.005",
      "amount": "5000",
      "docs": "https://docs.tracefast.xyz/api/token.md"
    },
    {
      "id": "token-holders",
      "resource": "GET /api/v1/chains/1/tokens/{token}/holders",
      "summary": "Largest holders of a token",
      "group": "Is this token or contract safe to touch",
      "tier": 4,
      "price": "0.05",
      "amount": "50000",
      "docs": "https://docs.tracefast.xyz/api/token-holders.md"
    },
    {
      "id": "token-transfers",
      "resource": "GET /api/v1/chains/1/tokens/{token}/transfers",
      "summary": "Transfers of a token",
      "group": "Is this token or contract safe to touch",
      "tier": 4,
      "price": "0.05",
      "amount": "50000",
      "docs": "https://docs.tracefast.xyz/api/token-transfers.md"
    },
    {
      "id": "entity-token-balance",
      "resource": "GET /api/v1/chains/1/entities/{address}/tokens/{token}/balance",
      "summary": "Balance of one token on an address, now or at a past block",
      "group": "Is this token or contract safe to touch",
      "tier": 2,
      "price": "0.01",
      "amount": "10000",
      "docs": "https://docs.tracefast.xyz/api/address-token-balance.md"
    },
    {
      "id": "token-stats",
      "resource": "GET /api/v1/chains/1/tokens/stats",
      "summary": "Token statistics of the network",
      "group": "Is this token or contract safe to touch",
      "tier": 1,
      "price": "0.005",
      "amount": "5000",
      "docs": "https://docs.tracefast.xyz/api/token-stats.md"
    },
    {
      "id": "transaction-failures",
      "resource": "GET /api/v1/chains/1/transactions/{hash}/failures",
      "summary": "Why a transaction reverted: the failed calls and their decoded errors",
      "group": "What did this transaction do, and why did it fail",
      "tier": 2,
      "price": "0.01",
      "amount": "10000",
      "docs": "https://docs.tracefast.xyz/api/transaction-failures.md"
    },
    {
      "id": "trace",
      "resource": "GET /api/v1/chains/1/traces/{hash}",
      "summary": "Everything a transaction executed, call by call",
      "group": "What did this transaction do, and why did it fail",
      "tier": 5,
      "price": "0.10",
      "amount": "100000",
      "docs": "https://docs.tracefast.xyz/api/trace.md"
    },
    {
      "id": "trace-frames",
      "resource": "GET /api/v1/chains/1/traces/{hash}/frames",
      "summary": "Call frames of a transaction, paged",
      "group": "What did this transaction do, and why did it fail",
      "tier": 5,
      "price": "0.10",
      "amount": "100000",
      "docs": "https://docs.tracefast.xyz/api/trace-frames.md"
    },
    {
      "id": "transaction-storage-writes",
      "resource": "GET /api/v1/chains/1/transactions/{hash}/storage-writes",
      "summary": "Storage writes of a transaction",
      "group": "What did this transaction do, and why did it fail",
      "tier": 5,
      "price": "0.10",
      "amount": "100000",
      "docs": "https://docs.tracefast.xyz/api/transaction-storage-writes.md"
    },
    {
      "id": "transaction-events",
      "resource": "GET /api/v1/chains/1/transactions/{hash}/events",
      "summary": "Decoded event logs of a transaction",
      "group": "What did this transaction do, and why did it fail",
      "tier": 1,
      "price": "0.005",
      "amount": "5000",
      "docs": "https://docs.tracefast.xyz/api/transaction-events.md"
    },
    {
      "id": "transaction-detail",
      "resource": "GET /api/v1/chains/1/transactions/{hash}",
      "summary": "One transaction",
      "group": "What did this transaction do, and why did it fail",
      "tier": 1,
      "price": "0.005",
      "amount": "5000",
      "docs": "https://docs.tracefast.xyz/api/transaction.md"
    },
    {
      "id": "entity-overview",
      "resource": "GET /api/v1/chains/1/entities/{address}",
      "summary": "One address at a glance: balance, nonce, code, first and last activity",
      "group": "What has this address been doing",
      "tier": 1,
      "price": "0.005",
      "amount": "5000",
      "docs": "https://docs.tracefast.xyz/api/address.md"
    },
    {
      "id": "entity-activity",
      "resource": "GET /api/v1/chains/1/entities/{address}/activity",
      "summary": "When an address was first seen and last active",
      "group": "What has this address been doing",
      "tier": 2,
      "price": "0.01",
      "amount": "10000",
      "docs": "https://docs.tracefast.xyz/api/address-activity.md"
    },
    {
      "id": "entity-daily-activity",
      "resource": "GET /api/v1/chains/1/entities/{address}/daily-activity",
      "summary": "Daily activity of an address",
      "group": "What has this address been doing",
      "tier": 2,
      "price": "0.01",
      "amount": "10000",
      "docs": "https://docs.tracefast.xyz/api/address-daily-activity.md"
    },
    {
      "id": "entity-balance-history",
      "resource": "GET /api/v1/chains/1/entities/{address}/balance-history",
      "summary": "Native balance of an address day by day, with USD value",
      "group": "What has this address been doing",
      "tier": 2,
      "price": "0.01",
      "amount": "10000",
      "docs": "https://docs.tracefast.xyz/api/address-balance-history.md"
    },
    {
      "id": "entity-transactions",
      "resource": "GET /api/v1/chains/1/entities/{address}/transactions",
      "summary": "Transactions of an address",
      "group": "What has this address been doing",
      "tier": 5,
      "price": "0.10",
      "amount": "100000",
      "docs": "https://docs.tracefast.xyz/api/entity-transactions.md"
    },
    {
      "id": "entity-token-transfers",
      "resource": "GET /api/v1/chains/1/entities/{address}/token-transfers",
      "summary": "Token transfers of an address",
      "group": "What has this address been doing",
      "tier": 5,
      "price": "0.10",
      "amount": "100000",
      "docs": "https://docs.tracefast.xyz/api/entity-token-transfers.md"
    },
    {
      "id": "entity-internal-transfers",
      "resource": "GET /api/v1/chains/1/entities/{address}/internal-transfers",
      "summary": "Internal transfers of an address",
      "group": "What has this address been doing",
      "tier": 5,
      "price": "0.10",
      "amount": "100000",
      "docs": "https://docs.tracefast.xyz/api/entity-internal-transfers.md"
    },
    {
      "id": "block-detail",
      "resource": "GET /api/v1/chains/1/blocks/{number}",
      "summary": "One block: header and totals",
      "group": "Blocks and validators",
      "tier": 1,
      "price": "0.005",
      "amount": "5000",
      "docs": "https://docs.tracefast.xyz/api/block.md"
    },
    {
      "id": "block-transactions",
      "resource": "GET /api/v1/chains/1/blocks/{number}/transactions",
      "summary": "Transactions of one block",
      "group": "Blocks and validators",
      "tier": 2,
      "price": "0.01",
      "amount": "10000",
      "docs": "https://docs.tracefast.xyz/api/block-transactions.md"
    },
    {
      "id": "block-addresses",
      "resource": "GET /api/v1/chains/1/blocks/{number}/addresses",
      "summary": "Accounts touched by one block",
      "group": "Blocks and validators",
      "tier": 3,
      "price": "0.025",
      "amount": "25000",
      "docs": "https://docs.tracefast.xyz/api/block-addresses.md"
    },
    {
      "id": "block-authorizations",
      "resource": "GET /api/v1/chains/1/blocks/{number}/authorizations",
      "summary": "EIP-7702 authorizations of one block",
      "group": "Blocks and validators",
      "tier": 2,
      "price": "0.01",
      "amount": "10000",
      "docs": "https://docs.tracefast.xyz/api/block-authorizations.md"
    },
    {
      "id": "block-withdrawals",
      "resource": "GET /api/v1/chains/1/blocks/{number}/withdrawals",
      "summary": "Validator withdrawals of one block",
      "group": "Blocks and validators",
      "tier": 2,
      "price": "0.01",
      "amount": "10000",
      "docs": "https://docs.tracefast.xyz/api/block-withdrawals.md"
    },
    {
      "id": "consensus-current",
      "resource": "GET /api/v1/chains/1/consensus/current",
      "summary": "Validator entry and exit queues now",
      "group": "Blocks and validators",
      "tier": 1,
      "price": "0.005",
      "amount": "5000",
      "docs": "https://docs.tracefast.xyz/api/consensus-current.md"
    },
    {
      "id": "consensus-queues",
      "resource": "GET /api/v1/chains/1/consensus/queues",
      "summary": "Validator queues over time",
      "group": "Blocks and validators",
      "tier": 3,
      "price": "0.025",
      "amount": "25000",
      "docs": "https://docs.tracefast.xyz/api/consensus-queues.md"
    },
    {
      "id": "consensus-proposers",
      "resource": "GET /api/v1/chains/1/consensus/proposers",
      "summary": "Block-proposal leaderboard",
      "group": "Blocks and validators",
      "tier": 4,
      "price": "0.05",
      "amount": "50000",
      "docs": "https://docs.tracefast.xyz/api/consensus-proposers.md"
    },
    {
      "id": "validator-withdrawals",
      "resource": "GET /api/v1/chains/1/consensus/validators/{index}/withdrawals",
      "summary": "Withdrawals of a validator",
      "group": "Blocks and validators",
      "tier": 3,
      "price": "0.025",
      "amount": "25000",
      "docs": "https://docs.tracefast.xyz/api/validator-withdrawals.md"
    }
  ],
  "free": [
    {
      "id": "block-latest",
      "resource": "GET /api/v1/chains/1/blocks/latest",
      "summary": "The latest block — free, no payment",
      "docs": "https://docs.tracefast.xyz/api/block-latest.md"
    }
  ],
  "documentation": "https://docs.tracefast.xyz/api.md"
}