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
| Parameter | In | Type | Notes |
|---|---|---|---|
address | path | string | 0x-prefixed, 40 hex characters, any case |
period | query | string, optional | 30d, 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
pointscan hold fewer entries thandays— 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.asOfBlockis 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
| Field | Meaning |
|---|---|
chainId | the chain the facts are about; 1 is Ethereum mainnet |
address | the address, lowercase |
days | the length of the window in days: 30, 90 or 365 |
activeDays | days in the window with at least one active block — the number of entries in points |
totalBlocksActive | the sum of blocksActive over the window |
points[] | one entry per active day, oldest first |
A point
| Field | Meaning |
|---|---|
date | the day, YYYY-MM-DD, UTC |
blocksActive | blocks in which the address's account state changed that day |
balanceChangeBlocks | of those, blocks with a balance change |
nonceChangeBlocks | of those, blocks with a nonce change — the address sent a transaction |
codeChangeBlocks | of those, blocks with a code change |
createdBlocks | of 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
| Status | code | When | details |
|---|---|---|---|
| 400 | bad_request | period is not one of 30d, 90d, 365d | reason: period_invalid, period |
| 404 | chain_not_supported | a 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.
Related pages
- Activity of an address — last activity in any form, not only the address's own state
- Native balance history — what the balance changes added up to, per day
- One address — the current balance, nonce and counters
- Accounts & Wallets — the 30-day activity sparkline in the app
Last updated 22 Oct 2026, 08:06 UTC · verified against TraceFast v1.0.261 · Markdown