DecenterAI · Token Holder Balance Changes

Served byDecenterAI API (unavailable) Indexed external

Query historical balance change events for holders of a specific ERC-20 token contract.

What it does

Query historical balance change events for holders of a specific ERC-20 token contract.

  • Track whale wallet accumulation patterns
  • Analyze token distribution shifts over time
  • Identify insider trading signals
  • Build holder concentration metrics

Ideal buyer

Onchain analysts and token researchers tracking holder behavior patterns.

Use with AXON

Run this through your governed agent wallet.

  1. 01
    Bootstrap AXON once with npx @axon402/init.
  2. 02
    Use the AXON runtime MCP tools to search_x402_services or inspect_x402_offer for this service.
  3. 03
    Quote, test-buy, then run the governed paid fetch through AXON.

Send this

Prompt for your agent

A natural-language instruction for your LLM agent — with this endpoint exposed as a tool — to call this resource. Not sent to the endpoint; the endpoint consumes the JSON body below.

Pasting this prompt into a raw ChatGPT or unconfigured agent will notexecute the paid endpoint flow. Run it through an agent with the AXON runtime / MCP tools exposed (see “Use with AXON” above) so the 402 challenge, quote, and governed fetch are handled for you.

“Show me all balance changes for holders of token 0x781dB9A4D8Ae055571e8796DD4423bc13CeE5dD6 in the last 30 days.”

Endpoint request body

The JSON payload your agent sends to the endpoint.

application/json
{
  "contractAddress": "0x781dB9A4D8Ae055571e8796DD4423bc13CeE5dD6"
}

Advanced HTTP details

For integrators who need the raw protocol surface. Most agents should use AXON above instead of calling these directly.

curl fallback

curl https://api.decenterai.dev/x402/token/token-holder-balance-changes/0x781dB9A4D8Ae055571e8796DD4423bc13CeE5dD6 \
  -H "Content-Type: application/json" \
  -H "X-PAYMENT: [signed_payment_envelope]" \
  -d '{"contractAddress":"0x781dB9A4D8Ae055571e8796DD4423bc13CeE5dD6"}'

Payment & settlement details

Raw on-chain settlement parameters. AXON above handles these automatically through quote / test-buy / governed fetch.

baseexact
$0.150
per call
Pay-to address0x3fd2d9435f463854988cf4e71b68732a70973e8e
T/O: 300s asset 0x8335…2913

Price & network

Cheapest call$0.150
Networks
base

Trust & risk

Trust tier Indexed external
Pricing sanityExpensive vs. categoryratio 5.00×
Risk flagsNo risks flagged
View JSON bundle

Indexed from facilitator discovery data

Last enriched:

More in Data APIs

Browse all →

Other resources in this category

Category proxy — we don't track live co-purchase signals yet.