{
  "x402Version": 2,
  "id": 206,
  "slug": "206",
  "resource": "https://x402.ottoai.services/holder-analytics",
  "description": "Full holder analytics for any Base ERC-20: total holders with 24h/3d/7d/30d holder-change momentum, whale-tier distribution, acquisition mix (swap vs transfer vs airdrop), top-10/25/50/100 supply share, labeled top holders with concentration (top1/5/10/20% + contract-held%) and an AI concentration-risk read. Bag check, holder analytics, holder concentration, whale distribution. $0.03 per call.",
  "type": "http",
  "accepts": [
    {
      "scheme": "exact",
      "network": "eip155:8453",
      "payTo": "0x0E84dDEdAaE6A779c462C22a59F301EC31B6b808",
      "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "amount": "30000",
      "maxTimeoutSeconds": 300
    }
  ],
  "outputSchema": {
    "bazaar": {
      "info": {
        "input": {
          "method": "GET",
          "queryParams": {
            "token": "0x4ed4e862860bed51a9570b96d89af5e1b0efefed"
          },
          "type": "http"
        },
        "output": {
          "example": {
            "data": {
              "analysisStatus": "ok",
              "chain": "base",
              "concentration": {
                "contractHeldPct": 22.8,
                "top10Pct": 27.1,
                "top1Pct": 5.69,
                "top20Pct": 38.55,
                "top5Pct": 18.42
              },
              "generatedAt": "2026-06-11T12:00:00.000Z",
              "holderChange": {
                "24h": {
                  "change": -312,
                  "changePercent": -0.06
                },
                "30d": {
                  "change": -8204,
                  "changePercent": -1.53
                },
                "3d": {
                  "change": 1204,
                  "changePercent": 0.23
                },
                "7d": {
                  "change": 4810,
                  "changePercent": 0.92
                }
              },
              "holderDistribution": {
                "crabs": 98200,
                "dolphins": 2150,
                "fish": 11800,
                "octopus": 24500,
                "sharks": 310,
                "shrimps": 391650,
                "whales": 124
              },
              "holderSupply": {
                "top10": {
                  "supply": "13497000000",
                  "supplyPercent": 36.5
                },
                "top100": {
                  "supply": "24530000000",
                  "supplyPercent": 66.4
                },
                "top25": {
                  "supply": "17890000000",
                  "supplyPercent": 48.4
                },
                "top50": {
                  "supply": "21260000000",
                  "supplyPercent": 57.5
                }
              },
              "holdersByAcquisition": {
                "airdrop": 21000,
                "swap": 311200,
                "transfer": 196534
              },
              "riskRead": "The holder base is large (529k) and stable over 24h with mild 7d growth, so distribution risk is structural rather than momentum-driven. Top-10 wallets hold 36.5% of supply, but the largest positions are DEX liquidity contracts rather than EOAs — contract-held supply (22.8%) is mostly Uniswap pools. Acquisition skews to swaps over airdrops, consistent with an organically bought base; no single EOA above 4.4% means dump risk from any one wallet is contained.",
              "tokenAddress": "0x4ed4e862860bed51a9570b96d89af5e1b0efefed",
              "topHolders": [
                {
                  "balanceFormatted": "2104566516.77",
                  "entity": "Uniswap",
                  "isContract": true,
                  "label": "Uniswap V3: DEGEN 3",
                  "ownerAddress": "0x3304e22ddaa22bcdc5fca2269b418046ae7b566a",
                  "pctOfSupply": 5.69,
                  "usdValue": 8418266.07
                }
              ],
              "totalHolders": 528734
            },
            "meta": {
              "degraded": false,
              "generatedAt": "",
              "stalenessSec": 0,
              "validUntil": ""
            },
            "status": "success"
          },
          "type": "json"
        }
      },
      "schema": {
        "$schema": "https://json-schema.org/draft/2020-12/schema",
        "properties": {
          "input": {
            "additionalProperties": false,
            "properties": {
              "method": {
                "enum": [
                  "GET"
                ],
                "type": "string"
              },
              "queryParams": {
                "properties": {
                  "token": {
                    "description": "Base ERC-20 token contract address (0x...). Common symbols also accepted as shorthand: weth, usdc, cbbtc, cbxrp, cbdoge, usol.",
                    "type": "string"
                  }
                },
                "required": [
                  "token"
                ],
                "type": "object"
              },
              "type": {
                "const": "http",
                "type": "string"
              }
            },
            "required": [
              "type",
              "method"
            ],
            "type": "object"
          },
          "output": {
            "properties": {
              "example": {
                "properties": {
                  "data": {
                    "description": "Endpoint payload (see meta.generatedAt for freshness)"
                  },
                  "meta": {
                    "type": "object"
                  },
                  "status": {
                    "enum": [
                      "success"
                    ],
                    "type": "string"
                  }
                },
                "required": [
                  "status",
                  "data",
                  "meta"
                ],
                "type": "object"
              },
              "type": {
                "type": "string"
              }
            },
            "required": [
              "type"
            ],
            "type": "object"
          }
        },
        "required": [
          "input"
        ],
        "type": "object"
      }
    },
    "builder-code": {
      "info": {
        "a": "bc_hc2dhq09"
      },
      "schema": {
        "$schema": "https://json-schema.org/draft/2020-12/schema",
        "additionalProperties": false,
        "properties": {
          "a": {
            "description": "App builder code",
            "pattern": "^[a-z0-9_]{1,32}$",
            "type": "string"
          },
          "s": {
            "description": "Service builder codes",
            "items": {
              "pattern": "^[a-z0-9_]{1,32}$",
              "type": "string"
            },
            "type": "array"
          },
          "w": {
            "description": "Wallet builder code",
            "pattern": "^[a-z0-9_]{1,32}$",
            "type": "string"
          }
        },
        "type": "object"
      }
    },
    "offer-receipt": {
      "info": {
        "offers": [
          {
            "acceptIndex": 0,
            "format": "eip712",
            "payload": {
              "amount": "30000",
              "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
              "network": "eip155:8453",
              "payTo": "0x0E84dDEdAaE6A779c462C22a59F301EC31B6b808",
              "resourceUrl": "https://x402.ottoai.services/holder-analytics",
              "scheme": "exact",
              "validUntil": 1788096580,
              "version": 1
            },
            "signature": "0xba79204b50f873e76ac70347006ce15e793253bf31f09e93103fd2ea6ec70750729ec6622c283732142707979fb8a7ee330f85bb0de3ce342e9d62780862f50b1c"
          }
        ]
      },
      "schema": {
        "$schema": "https://json-schema.org/draft/2020-12/schema",
        "properties": {
          "offers": {
            "items": {
              "properties": {
                "acceptIndex": {
                  "type": "integer"
                },
                "format": {
                  "type": "string"
                },
                "payload": {
                  "properties": {
                    "amount": {
                      "type": "string"
                    },
                    "asset": {
                      "type": "string"
                    },
                    "network": {
                      "type": "string"
                    },
                    "payTo": {
                      "type": "string"
                    },
                    "resourceUrl": {
                      "type": "string"
                    },
                    "scheme": {
                      "type": "string"
                    },
                    "validUntil": {
                      "type": "integer"
                    },
                    "version": {
                      "type": "integer"
                    }
                  },
                  "required": [
                    "version",
                    "resourceUrl",
                    "scheme",
                    "network",
                    "asset",
                    "payTo",
                    "amount"
                  ],
                  "type": "object"
                },
                "signature": {
                  "type": "string"
                }
              },
              "required": [
                "format",
                "signature"
              ],
              "type": "object"
            },
            "type": "array"
          }
        },
        "required": [
          "offers"
        ],
        "type": "object"
      }
    },
    "otto-content-receipt": {}
  },
  "tags": [
    "bazaar",
    "builder-code",
    "offer-receipt",
    "otto-content-receipt"
  ],
  "sourceHost": "x402.ottoai.services",
  "lastUpdated": "2026-08-30T13:24:40.643Z",
  "quality": {
    "calls30d": 1,
    "uniquePayers30d": 1,
    "lastCalledAt": "2026-08-30T13:24:40.363Z"
  },
  "liveness": {},
  "verified": false,
  "featured": false,
  "provider": {
    "host": "x402.ottoai.services",
    "manifest_name": "x402.ottoai.services",
    "source": "cdp-mirror",
    "source_manifest_url": "https://api.cdp.coinbase.com/platform/v2/x402/discovery/resources",
    "submitted_at": "2026-09-18T22:00:31.484Z"
  }
}