x402basequality 0.78

Token holder concentration and distribution risk metrics via x402 micropayment on Base, Solana, or Lightning.

Price
0.4 USDC / call
Protocol
x402
Verified
no

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

token-holder-distributionconcentration-risk-metricsmulti-chain-queryx402-micropaymentusdc-base-paymentusdc-solana-paymentlightning-btc-paymentraw-data-outputbitquery-data

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

Transporthttp
Protocolx402
Pay to0xc9368b30BD620164FD1a05a5d99dcaf8Ae754775
CurrencyUSD COIN

Quality

0.78/ 1.00

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

Provenance

Indexed fromx402_bazaar
Enriched2026-04-22 00:08:50Z · anthropic/claude-opus-4.6 · v2
First seen2026-04-21
Last seen2026-04-22

Agent access