Token holder concentration and distribution risk metrics via x402 micropayment on Base, Solana, or Lightning.
What it does
This endpoint from Einstein AI returns raw token holder distribution data with concentration risk metrics for any ERC-20 token. It is part of the Einstein AI x402 API suite, which wraps Bitquery on-chain data behind pay-per-request x402 micropayments. You POST a token contract address and optional chain parameter, and receive holder concentration analysis including distribution breakdowns.
The endpoint accepts payment on three networks: USDC on Base (0.40 USD), USDC on Solana (0.40 USD), or Bitcoin Lightning (524 sats, ~$0.40 equivalent). Supported chains for querying are Base (default), Ethereum, BSC, Arbitrum, and Polygon. The "/raw" variant returns structured data without AI-generated analysis text (the non-raw sibling at `/x402/bitquery/holderconcentration` costs $0.55 and includes AI commentary). No API keys are required; authentication is handled entirely through the x402 payment header.
The endpoint is live and returns a proper x402 challenge with version 1 payment requirements. The OpenAPI spec is comprehensive, documenting request schemas (BitqueryHolderRequest with required tokenAddress and optional chain), response schemas (status, result data, payment receipt), and full payment flow details. The provider also supports CDP Bazaar discovery for programmatic agent-to-agent commerce. Note that the `/api` route returned a 522 origin timeout during crawl, though the x402 endpoints themselves responded correctly.
Capabilities
Use cases
- —Assess concentration risk before investing in a token by checking how supply is distributed among holders
- —Integrate holder distribution checks into automated trading bots that screen tokens for rug-pull risk
- —Build dashboards that flag tokens where top holders control a disproportionate share of supply
- —Cross-chain comparison of holder concentration for the same token across Ethereum, Base, BSC, Arbitrum, and Polygon
- —Feed holder data into broader security audit pipelines alongside sniping and MEV detection endpoints
Fit
Best for
- —AI agents needing on-chain holder analytics without API key management
- —Automated token screening pipelines that pay per request
- —Multi-chain holder concentration checks across EVM chains
- —Raw structured data consumers who don't need AI narrative
Not for
- —Historical time-series holder snapshots (endpoint returns current state)
- —Non-EVM chains beyond the supported set (no Avalanche, Fantom, etc.)
- —Free or high-volume bulk queries (each call costs $0.40)
Quick start
curl -X POST https://emc2ai.io/x402/bitquery/holderconcentration/raw \
-H "Content-Type: application/json" \
-H "X-PAYMENT: <base64-encoded-signed-USDC-authorization>" \
-d '{"tokenAddress": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "chain": "base"}'Example
Request
{
"chain": "base",
"tokenAddress": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
}Response
{
"result": {
"chain": "base",
"holders": [
{
"address": "0xabc...",
"balance": "15000000",
"percentage": 12.5
}
],
"tokenAddress": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"concentration": {
"top10Pct": 45.2,
"top50Pct": 78.1,
"giniCoefficient": 0.82
}
},
"status": "completed",
"payment": {
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"amount": "400000",
"scheme": "exact",
"txHash": "0xdef...",
"network": "base",
"timestamp": "2025-01-15T12:00:00Z",
"x402Version": 1
}
}Endpoint
Quality
The endpoint is live with a well-formed x402 challenge, a comprehensive OpenAPI spec with full request/response schemas, clear pricing on three payment networks, and multi-chain support. Deducted points because the response body example is inferred (no actual 200 response captured), the /api route timed out (522), and the raw output schema fields are somewhat generic.
Warnings
- —The /api route returned HTTP 522 (origin timeout) during crawl, suggesting intermittent backend issues
- —Response body structure is inferred from the OpenAPI schema — no actual 200 response was captured in the probe
- —The example_response_json concentration fields (giniCoefficient, top10Pct, etc.) are plausible but not confirmed by documentation
Citations
- —Endpoint costs $0.40 in USDC on Base (400000 atomic units, 6 decimals)https://emc2ai.io/x402/bitquery/holderconcentration/raw
- —Also accepts USDC on Solana and 524 sats via Lightning (~$0.40 equivalent)https://emc2ai.io/x402/bitquery/holderconcentration/raw
- —Supported chains: ethereum, base, bsc, arbitrum, polygon; default chain is basehttps://emc2ai.io/x402/bitquery/holderconcentration/raw
- —Required parameter is tokenAddress; chain and limit are optionalhttps://emc2ai.io/x402/bitquery/holderconcentration/raw
- —Non-raw holderconcentration endpoint costs $0.55 and includes AI analysishttps://emc2ai.io
- —Einstein AI supports CDP Bazaar discovery for agent-to-agent commercehttps://emc2ai.io/docs
- —The /api route returned a 522 origin timeout error during crawlhttps://emc2ai.io/api