Retention and churn

How to get it

get_sections · sections.retention

Status

Coming soon: the token page doesn't show it yet, so the API and the MCP don't serve it

Cost

2 credits a pull

Window

Up to 60 days

Get it

Ask get_sections for it by name. It answers only while the token's page shows this section; otherwise the answer leaves it out and names it in not_on_the_site_yet, and the pull is still charged. GET /v1/catalog lists the sections served right now, free

curl -X POST "https://api.blocktronics.xyz/v1/tools/get_sections" \
  -H "Authorization: Bearer $BLOCKTRONICS_KEY" \
  -H "content-type: application/json" \
  -d '{"token":"base:0x4ed4e862860bed51a9570b96d89af5e1b0efefed","section":"retention"}'

Understand this metric

Holder turnover: who arrived, who left, and what share stayed. Distinguishes a flat holder count that is churning underneath from one that is genuinely stable.

• Net change is new_holders minus exited_holders; it is not sent separately.
• Only days the retention build has written are returned.

In the answer

{
  "state": "ready",
  "sample": false,
  "origin": "engine",
  "cached_at": "2026-10-26T05:10:00.000Z",
  "age_seconds": 1800,
  "summary": "…",
  "data": [
    {
      "day": "2026-09-26",
      "new_holders": 120,
      "exited_holders": 85,
      "holders_total": 4041
    }
  ]
}

Availability and billing

A section the page shows answers with its data, cached_at and age_seconds; never a guess. See sections and credits and billing.

More parts