{
  "x402Version": 2,
  "id": 198,
  "slug": "198",
  "resource": "https://x402.ottoai.services/token-top-holders",
  "description": "Top holders for any Base ERC-20 (via Moralis), with computed concentration (top1/5/10/20% + contract-held%) and optional whale-risk read. Curated hot set refreshed hourly; long-tail tokens write-through on first call.",
  "type": "http",
  "accepts": [
    {
      "scheme": "exact",
      "network": "eip155:8453",
      "payTo": "0x0E84dDEdAaE6A779c462C22a59F301EC31B6b808",
      "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "amount": "20000",
      "maxTimeoutSeconds": 300
    }
  ],
  "outputSchema": {
    "bazaar": {
      "info": {
        "input": {
          "method": "GET",
          "queryParams": {
            "token": "0x4ed4e862860bed51a9570b96d89af5e1b0efefed"
          },
          "type": "http"
        },
        "output": {
          "example": {
            "data": {
              "chain": "base",
              "concentration": {
                "contractHeldPct": 22.8,
                "top10Pct": 27.1,
                "top1Pct": 5.69,
                "top20Pct": 38.55,
                "top5Pct": 18.42
              },
              "generatedAt": "2026-06-09T21:00:00.000Z",
              "holders": [
                {
                  "balanceFormatted": "2104566516.77",
                  "entity": "Uniswap",
                  "isContract": true,
                  "label": "Uniswap V3: DEGEN 3",
                  "ownerAddress": "0x3304e22ddaa22bcdc5fca2269b418046ae7b566a",
                  "pctOfSupply": 5.69,
                  "usdValue": 8418266.07
                },
                {
                  "balanceFormatted": "1610312029.43",
                  "entity": null,
                  "isContract": false,
                  "label": null,
                  "ownerAddress": "0xd28cb1e0bd2f1f57c50ff85b3bcdf6cf48ddcfc9",
                  "pctOfSupply": 4.36,
                  "usdValue": 6441248.12
                }
              ],
              "narrative": "Concentration is moderate: the top-10 wallets hold 27.1% of supply, led by a Uniswap V3 pool (5.7%). Contract-held supply (22.8%) is mostly DEX liquidity rather than team custody. No single EOA exceeds 4.4%.",
              "tokenAddress": "0x4ed4e862860bed51a9570b96d89af5e1b0efefed",
              "totalSupply": "36965935954.18"
            },
            "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": "20000",
              "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
              "network": "eip155:8453",
              "payTo": "0x0E84dDEdAaE6A779c462C22a59F301EC31B6b808",
              "resourceUrl": "https://x402.ottoai.services/token-top-holders",
              "scheme": "exact",
              "validUntil": 1788162520,
              "version": 1
            },
            "signature": "0xc9f0bc6bf80afa02b20166b868a9a28163b6f08299e93b4af1cb21b2a63e4e3c4479b2d4e0a7e64cad62f8390efef8db45ced89c064a1b12471b5f603b7d23361b"
          }
        ]
      },
      "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-31T07:43:40.804Z",
  "quality": {
    "calls30d": 3,
    "uniquePayers30d": 1,
    "lastCalledAt": "2026-08-31T07:43:40.544Z"
  },
  "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"
  }
}