Honeycluster Docs – Get bucketed new/deleted account counts

network

Get bucketed new/deleted account counts

get

/network/accounts-churn

operationId: network-accountsChurn

Network-wide account churn aggregated into hourly or daily buckets. Each bucket reports sums of accounts_created and accounts_deleted plus per-ledger peaks — useful for spotting airdrop waves or spam bursts.

Authorizations

Name	Location	Details
`BearerAuth`	Authorization header · bearer	JWT issued by the Honeycluster auth service for the `indexer` audience. Present as `Authorization: Bearer <token>`.

Query Parameters

Name	Type	Default	Description
`interval`	enum<string>	`"hourly"`	Available `hourlydaily`
`startTime`	integer
`endTime`	integer
`limit`	integer	`500`

Responses

200

application/json

Successful response

Field	Type	Description
`items`	object[]
`items[].bucket`	integer	Start of the aggregation bucket, Unix-seconds.
`items[].newAccounts`	number	New accounts funded in the bucket.
`items[].deletedAccounts`	number	Accounts deleted in the bucket.
`items[].peakLedgerNew`	number	Max new accounts in any single ledger inside the bucket.
`items[].peakLedgerDeleted`	number	Max deletions in any single ledger inside the bucket.
`items[].sampleCount`	number	Number of ledgers sampled.

Example

Json

{
  "items": [
    {
      "bucket": 1745712000,
      "newAccounts": 142,
      "deletedAccounts": 8,
      "peakLedgerNew": 14,
      "peakLedgerDeleted": 2,
      "sampleCount": 360
    },
    {
      "bucket": 1745715600,
      "newAccounts": 187,
      "deletedAccounts": 5,
      "peakLedgerNew": 19,
      "peakLedgerDeleted": 1,
      "sampleCount": 360
    }
  ]
}

400

application/json

Invalid input data

Field	Type	Description
`message`	string	The error message
`code`	string	The error code
`issues`	object[]	An array of issues that were responsible for the error
`issues[].message`	string

Example

Json

{
  "code": "BAD_REQUEST",
  "message": "Invalid input data",
  "issues": []
}

401

application/json

Authorization not provided

Field	Type	Description
`message`	string	The error message
`code`	string	The error code
`issues`	object[]	An array of issues that were responsible for the error
`issues[].message`	string

Example

Json

{
  "code": "UNAUTHORIZED",
  "message": "Authorization not provided",
  "issues": []
}

403

application/json

Insufficient access

Field	Type	Description
`message`	string	The error message
`code`	string	The error code
`issues`	object[]	An array of issues that were responsible for the error
`issues[].message`	string

Example

Json

{
  "code": "FORBIDDEN",
  "message": "Insufficient access",
  "issues": []
}

404

application/json

Not found

Field	Type	Description
`message`	string	The error message
`code`	string	The error code
`issues`	object[]	An array of issues that were responsible for the error
`issues[].message`	string

Example

Json

{
  "code": "NOT_FOUND",
  "message": "Not found",
  "issues": []
}

500

application/json

Internal server error

Field	Type	Description
`message`	string	The error message
`code`	string	The error code
`issues`	object[]	An array of issues that were responsible for the error
`issues[].message`	string

Example

Json

{
  "code": "INTERNAL_SERVER_ERROR",
  "message": "Internal server error",
  "issues": []
}