Token holder distribution and concentration risk metrics via Bitquery, paid per-call with USDC on Base, Solana, or Lightning.
What it does
This endpoint returns raw token holder distribution data along with concentration risk metrics for any token on supported EVM chains and Solana. It is part of the Einstein AI x402 API suite, which wraps Bitquery on-chain data behind x402 micropayment gates. The "/raw" suffix indicates this endpoint returns structured data without AI-generated analysis layered on top.
The endpoint accepts a POST request with a JSON body specifying the token contract address, blockchain network (base, ethereum, bsc, arbitrum, polygon, optimism, or solana), and an optional result limit (up to 500). It costs $0.40 per request, payable in USDC on Base (EIP-155:8453), USDC on Solana, or 524 sats via Lightning Network. Payment is made via the x402 protocol's X-PAYMENT header — no API keys are needed.
Supported chains include Base, Ethereum, BSC, Arbitrum, Polygon, Optimism, and Solana. The response includes a status field, result data object with holder distribution and concentration metrics, and a payment receipt. The endpoint has a 90-second timeout on Base and 60 seconds on Solana. The broader Einstein AI platform also offers related endpoints for rug-pull scanning, token sniping detection, whale intelligence, and more, all at varying price points from $0.25 to $1.15 per call.
Capabilities
Use cases
- —Assess concentration risk before investing in a token by checking how supply is distributed among holders
- —Detect potential rug-pull signals by identifying tokens where a few wallets hold a disproportionate share
- —Integrate holder distribution checks into automated trading agent pipelines via x402 payments
- —Monitor changes in token holder concentration over time for portfolio risk management
- —Screen new token launches for healthy distribution patterns
Fit
Best for
- —AI agents needing programmatic, pay-per-call holder concentration data without API keys
- —DeFi researchers analyzing token supply distribution across multiple chains
- —Automated risk-scoring pipelines that need raw structured holder data
Not for
- —Users who need free or unlimited-volume holder data (each call costs $0.40)
- —Historical time-series holder snapshots (this returns current-state distribution)
- —Non-blockchain or non-token-related analytics
Quick start
curl -X POST https://emc2ai.io/x402/bitquery/bagcheck/raw \
-H "Content-Type: application/json" \
-H "X-PAYMENT: <base64-encoded-x402-payment>" \
-d '{"tokenAddress": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "chain": "base", "limit": "10"}'Example
Request
{
"chain": "base",
"limit": "10",
"tokenAddress": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
}Response
{
"result": {
"holders": [
{
"address": "0xabc...123",
"balance": "15000000.00",
"percentOfSupply": 12.5
}
],
"concentration": {
"giniCoefficient": 0.81,
"top10HoldersPct": 45.2,
"top50HoldersPct": 72.8
}
},
"status": "completed",
"payment": {
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"amount": "400000",
"scheme": "exact",
"txHash": "0xdef...789",
"network": "base",
"x402Version": 1
}
}Endpoint
Quality
The endpoint is live (402 challenge confirmed on POST) with a full OpenAPI spec, clear pricing ($0.40 USDC), multi-network payment options, and well-defined input schema from the outputSchema in the challenge. The response schema is generic (BitqueryResponse) without specific holder-distribution field definitions, and no actual successful response example is available, so the example_response_json is inferred from the description and related schemas.
Warnings
- —The /api path returned a 522 (host timeout) during crawl, suggesting occasional backend instability
- —The exact fields in the holder distribution response are inferred — the OpenAPI spec uses a generic BitqueryResponse schema with an untyped 'data' object
- —The example_response_json is illustrative and not sourced from an actual API call
Citations
- —Endpoint costs $0.40 per call (400000 atomic units USDC, 6 decimals)https://emc2ai.io/x402/bitquery/bagcheck/raw
- —Accepts payment on Base (USDC), Solana (USDC), and Lightning Network (524 sats)https://emc2ai.io/x402/bitquery/bagcheck/raw
- —Supported chains include base, ethereum, bsc, arbitrum, polygon, optimism, solanahttps://emc2ai.io/x402/bitquery/bagcheck/raw
- —Input fields: tokenAddress (required), chain, limit per the outputSchemahttps://emc2ai.io/x402/bitquery/bagcheck/raw
- —Einstein AI x402 API prices range from $0.25 to $1.15 per requesthttps://emc2ai.io/docs
- —Pay-per-feature model with holdings-based discounts up to 60%https://emc2ai.io/docs