> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chainstream.io/llms.txt
> Use this file to discover all available pages before exploring further.

# トークン - 保有者トレンド

> トークンの保有者数推移データを取得。解像度と期間を指定可能



## OpenAPI

````yaml /jp/api-reference/openapi-data-jp.yaml GET /v2/token/{chain}/{tokenAddress}/holderTrend
openapi: 3.1.0
info:
  title: Services API
  description: Services API
  contact:
    name: AI
    email: ai@sx.ai
  license:
    name: MIT
  version: '1.0'
servers:
  - url: https://api.chainstream.io
    description: Production
security:
  - bearer_auth: []
  - api_key_auth: []
tags:
  - name: Blockchain
    description: ブロックチェーン関連の操作
  - name: Token
    description: トークン関連の操作
  - name: Trade
    description: 取引関連の操作
  - name: Wallet
    description: ウォレット関連の操作
  - name: Dex
    description: DEX 関連の操作
  - name: Ranking
    description: ランキング関連の操作
  - name: DexPool
    description: DEX プール関連の操作
  - name: Watchlist
    description: ウォッチリスト関連の操作
  - name: KYT
    description: KYT 関連の操作
  - name: Webhook
    description: Webhook 関連の操作
  - name: RedPacket
    description: レッドパケット関連の操作
  - name: IPFS
    description: IPFS 関連の操作
  - name: DexScreener
    description: DexScreener 関連の操作
paths:
  /v2/token/{chain}/{tokenAddress}/holderTrend:
    get:
      tags:
        - Token
      summary: トークン - 保有者トレンド
      description: トークンの保有者数推移データを取得。解像度と期間を指定可能
      operationId: get.holder.trend
      parameters:
        - name: chain
          in: path
          description: サポートされているネットワークに記載されているチェーン名
          required: true
          schema:
            $ref: '#/components/schemas/ChainSymbol'
          example: sol
        - name: tokenAddress
          in: path
          description: トークンのアドレス
          required: true
          schema:
            type: string
          example: 6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN
        - name: resolution
          in: query
          description: >-
            DTO.TOKEN.HOLDER_TREND.RESOLUTION Aggregation resolution: 1h
            (default) | 1d
          required: false
          schema:
            type: string
            default: 1h
          example: 1h
        - name: from
          in: query
          description: >-
            DTO.TOKEN.HOLDER_TREND.FROM Start timestamp in Unix milliseconds
            (default: 30 days ago)
          required: false
          schema:
            type: integer
            format: int64
          example: 1743465600000
        - name: to
          in: query
          description: >-
            DTO.TOKEN.HOLDER_TREND.TO End timestamp in Unix milliseconds
            (default: now)
          required: false
          schema:
            type: integer
            format: int64
          example: 1746144000000
      responses:
        '200':
          description: 保有者トレンドデータ
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/TokenHolderTrendPoint'
components:
  schemas:
    ChainSymbol:
      type: string
      description: Supported blockchain chains
      enum:
        - sol
        - eth
        - bsc
    TokenHolderTrendPoint:
      type: object
      description: Single time-point in the holder waterline trend (sparkline data)
      required:
        - timestamp
        - holders
        - top10HoldersRatio
        - top50HoldersRatio
        - top100HoldersRatio
        - devAmountRatio
        - insiderAmountRatio
        - proAmountRatio
        - sniperAmountRatio
        - bundleAmountRatio
        - freshAmountRatio
        - sandwichAmountRatio
        - kolAmountRatio
        - phishingAmountRatio
        - bluechipAmountRatio
        - ratAmountRatio
        - smartAmountRatio
        - creatorsAmountRatio
      properties:
        bluechipAmountRatio:
          type: string
          description: Bluechip holder ratio (0–1)
          example: '0.0200'
        bundleAmountRatio:
          type: string
          description: Bundle (bundler) wallet holding ratio (0–1)
          example: '0.0006'
        creatorsAmountRatio:
          type: string
          description: Creator wallet holding ratio (0–1)
          example: '0.0050'
        devAmountRatio:
          type: string
          description: Dev wallet holding ratio (0–1)
          example: '0.0100'
        freshAmountRatio:
          type: string
          description: Fresh wallet holding ratio (0–1)
          example: '0.1500'
        holders:
          type: string
          description: Total holder count
          example: '644381'
        insiderAmountRatio:
          type: string
          description: Insider wallet holding ratio (0–1)
          example: '0.0200'
        kolAmountRatio:
          type: string
          description: KOL wallet holding ratio (0–1)
          example: '0.0300'
        phishingAmountRatio:
          type: string
          description: Phishing (entrapment) wallet holding ratio (0–1)
          example: '0.1400'
        proAmountRatio:
          type: string
          description: Pro wallet holding ratio (0–1)
          example: '0.0300'
        ratAmountRatio:
          type: string
          description: Rat trader holding ratio (0–1)
          example: '0.0001'
        sandwichAmountRatio:
          type: string
          description: Sandwich bot holding ratio (0–1)
          example: '0.0020'
        smartAmountRatio:
          type: string
          description: Smart wallet holding ratio (0–1)
          example: '0.0800'
        sniperAmountRatio:
          type: string
          description: Sniper wallet holding ratio (0–1)
          example: '0.0050'
        timestamp:
          type: integer
          format: int64
          description: Unix timestamp in milliseconds (start of the hour or day bucket)
          example: 1747353600000
        top100HoldersRatio:
          type: string
          description: Top-100 holder ratio (0–1)
          example: '0.2500'
        top10HoldersRatio:
          type: string
          description: Top-10 holder ratio (0–1)
          example: '0.0832'
        top50HoldersRatio:
          type: string
          description: Top-50 holder ratio (0–1)
          example: '0.1500'
  securitySchemes:
    bearer_auth:
      type: http
      scheme: bearer
      bearerFormat: JWT
    api_key_auth:
      type: apiKey
      in: header
      name: X-API-KEY

````