Skip to content
TraceFast Docs

Daily activity of an address

Open this address in TraceFast →

For each day in a window, how many blocks changed the address's own account state, and which kind of change it was: balance, nonce, code or creation. Use it to tell a dormant address from a busy one, or to see when an address woke up.

GET https://tracefast.xyz/api/v1/chains/1/entities/{address}/daily-activity
ParameterInTypeNotes
addresspathstring0x-prefixed, 40 hex characters, any case
periodquerystring, optional30d, 90d or 365d. Default 90d

Access — an API key on the Enriched Data plan or higher (plans), or no key at all: pay per call with x402 at the same path on https://mpp.tracefast.xyz/api/v1, at the price its 402 states. As a tool for AI agents: get_entity_daily_activity on the MCP server. Stable — see stability.

chains/1 is a literal: the method serves Ethereum mainnet data. Other chain ids answer 404 chain_not_supported. There are no other parameters — an unknown one is refused rather than ignored.

What it covers, and what it does not

  • Only the address's own state. A block counts when the address's balance, nonce or code changed in it, or the account was created in it. Receiving a token or being called by a contract does not change the address's own state, so it is not counted here — for that, see activity of an address.
  • Only active days are listed. A day without activity has no entry, so points can hold fewer entries than days — or none at all.
  • The window ends at the latest day the daily aggregate holds, which can be a day or more before today. The response states no block height: meta.asOfBlock is absent on this method.
  • Days are UTC.

Response

200 application/json, here with ?period=30d. The example shows three of the 30 points in the real response:

{
  "data": {
    "chainId": 1,
    "address": "0xf977814e90da44bfa03b6295a0616a897441acec",
    "days": 30,
    "activeDays": 30,
    "totalBlocksActive": 269,
    "points": [
      {
        "date": "2026-08-27",
        "blocksActive": 97,
        "balanceChangeBlocks": 97,
        "nonceChangeBlocks": 96,
        "codeChangeBlocks": 0,
        "createdBlocks": 0
      },
      {
        "date": "2026-08-28",
        "blocksActive": 1,
        "balanceChangeBlocks": 1,
        "nonceChangeBlocks": 1,
        "codeChangeBlocks": 0,
        "createdBlocks": 0
      },
      {
        "date": "2026-09-07",
        "blocksActive": 1,
        "balanceChangeBlocks": 1,
        "nonceChangeBlocks": 1,
        "codeChangeBlocks": 0,
        "createdBlocks": 0
      }
    ]
  },
  "meta": {
    "chain": "ethereum",
    "timestamp": 1789047651680,
    "cached": false,
    "docs": "https://docs.tracefast.xyz/api/address-daily-activity"
  }
}

On 2026-08-27, 97 blocks changed the balance but only 96 changed the nonce: in one block the address received ETH without sending a transaction.

data

FieldMeaning
chainIdthe chain the facts are about; 1 is Ethereum mainnet
addressthe address, lowercase
daysthe length of the window in days: 30, 90 or 365
activeDaysdays in the window with at least one active block — the number of entries in points
totalBlocksActivethe sum of blocksActive over the window
points[]one entry per active day, oldest first

A point

FieldMeaning
datethe day, YYYY-MM-DD, UTC
blocksActiveblocks in which the address's account state changed that day
balanceChangeBlocksof those, blocks with a balance change
nonceChangeBlocksof those, blocks with a nonce change — the address sent a transaction
codeChangeBlocksof those, blocks with a code change
createdBlocksof those, blocks in which the account was created

The four kinds overlap: one block that sends a transaction changes both the nonce and the balance, so the kinds do not add up to blocksActive.

Errors

StatuscodeWhendetails
400bad_requestperiod is not one of 30d, 90d, 365dreason: period_invalid, period
404chain_not_supporteda chain id other than 1—

Malformed input, unknown parameters and the key check's 401/403/429 are the same for every method — see conventions and API keys.


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