> ## 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/trade/{chain}/activities
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/trade/{chain}/activities:
    get:
      tags:
        - Trade
      summary: アクティビティ - 一覧
      description: 取引、流動性操作、その他のトークン関連アクティビティを含むトークンアクティビティを取得
      operationId: get.activities
      parameters:
        - name: chain
          in: path
          description: サポートされているネットワークに記載されているチェーン名
          required: true
          schema:
            $ref: '#/components/schemas/ChainSymbol'
          example: sol
        - name: cursor
          in: query
          description: ページネーションカーソル
          required: false
          schema:
            type: string
          example: eyJpZCI6IjEyMyJ9
        - name: limit
          in: query
          description: ページあたりの結果数
          required: false
          schema:
            type: integer
            format: int64
            default: 20
          example: 20
        - name: direction
          in: query
          description: ページネーション方向（next または prev）
          required: false
          schema:
            oneOf:
              - $ref: '#/components/schemas/PageDirection'
            default: next
          example: next
        - name: tokenAddress
          in: query
          description: トークンのアドレス
          required: false
          schema:
            type: string
          example: 6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN
        - name: walletAddress
          in: query
          description: ウォレットのアドレス
          required: false
          schema:
            type: string
          example: 3xd4LGVWtYXLBspR6X5JWbW49NXmEehfPtX6Kqx98b4w
        - name: poolAddress
          in: query
          description: プールアドレス
          required: false
          schema:
            type: string
          example: 6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN
        - name: beforeTimestamp
          in: query
          description: 取引フィルタの開始タイムスタンプ（Unix エポック秒）
          required: false
          schema:
            type: integer
            format: int64
          example: 1717334400000
        - name: afterTimestamp
          in: query
          description: 取引フィルタの終了タイムスタンプ（Unix エポック秒）
          required: false
          schema:
            type: integer
            format: int64
          example: 1717334400000
        - name: beforeBlockHeight
          in: query
          description: このブロック高以前の取引をフィルタ
          required: false
          schema:
            type: integer
            format: int64
          example: 332417228
        - name: afterBlockHeight
          in: query
          description: このブロック高以降の取引をフィルタ
          required: false
          schema:
            type: integer
            format: int64
          example: 332417228
        - name: transactionsSignature
          in: query
          description: トランザクション署名/ハッシュ
          required: false
          schema:
            type: string
          example: >-
            37XpPt9Ak6JiE1V3sftJDtdUsvR9FVFRqkZmoT3dp4BTD9pgyTWn1XgHH6R7NjuJ4pBMAgj8JvZtxQrf4s6NTC5F
        - name: type
          in: query
          description: アクティビティタイプフィルタ
          required: false
          schema:
            $ref: '#/components/schemas/ActivityType'
          example: BUY
        - name: sortBy
          in: query
          description: >-
            DTO.TRADE.SORT_BY Sort by: timestampDesc (default) | timestampAsc |
            totalUsdDesc | totalUsdAsc.

            Legacy aliases: timestamp -> timestampDesc, totalUsd ->
            totalUsdDesc.
          required: false
          schema:
            oneOf:
              - $ref: '#/components/schemas/ActivitySortBy'
            default: timestampDesc
          example: timestampDesc
        - name: traderTags
          in: query
          description: >-
            Filter by trader tag(s). Comma-separated list from: kol, smart,
            sniper, dev, fresh, bundle, bluechip, insider.

            GMGN tags without existing activities data are unsupported: whale,
            top_holder, rat_trader, bot_degen, following, remarks.

            Returns activities where the trader has ANY of the specified tags.
          required: false
          schema:
            type: string
          example: kol,smart
        - name: minAmountUsd
          in: query
          description: Minimum trade value in USD (inclusive). Filters out small trades.
          required: false
          schema:
            type: string
          example: '1000'
        - name: maxAmountUsd
          in: query
          description: Maximum trade value in USD (inclusive).
          required: false
          schema:
            type: string
          example: '5000'
        - name: maker
          in: query
          description: >-
            Filter by one maker (trader) wallet address. Equivalent to filtering
            by accountOwnerAddress.
          required: false
          schema:
            type: string
          example: 3xd4LGVWtYXLBspR6X5JWbW49NXmEehfPtX6Kqx98b4w
      responses:
        '200':
          description: 成功レスポンス
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PageResponse_TradeDetail'
components:
  schemas:
    ChainSymbol:
      type: string
      description: Supported blockchain chains
      enum:
        - sol
        - eth
        - bsc
    PageDirection:
      type: string
      description: Pagination direction
      enum:
        - next
        - prev
    ActivityType:
      type: string
      description: Activity type (extends TradeType)
      enum:
        - BUY
        - SELL
        - LIQUIDITY_INITIALIZE
        - LIQUIDITY_ADD
        - LIQUIDITY_REMOVE
        - RED_PACKET_CREATE
        - RED_PACKET_CLAIM
        - RED_PACKET_COMPLETE
        - RED_PACKET_REFUND
        - MINT
        - BURN
    ActivitySortBy:
      type: string
      description: Sort field and direction for activities query
      enum:
        - timestampDesc
        - timestampAsc
        - totalUsdDesc
        - totalUsdAsc
    PageResponse_TradeDetail:
      type: object
      description: Generic pagination response
      required:
        - data
      properties:
        data:
          type: array
          items:
            type: object
            description: Trade detail
            required:
              - chain
              - blockHeight
              - blockTimestamp
              - accountOwnerAddress
              - transactionSignature
              - tokenName
              - tokenSymbol
              - tokenAddress
              - poolAddress
              - tokenAmount
              - tokenPriceInUsd
              - tokenAmountInUsd
              - tokenPriceInNative
              - tokenAmountInNative
              - type
              - sideTokenName
              - sideTokenSymbol
              - sideTokenAddress
              - sideTokenPriceInUsd
              - sideTokenPriceInNative
              - sideTokenAmount
              - sideTokenAmountInUsd
              - sideTokenAmountInNative
              - status
            properties:
              accountAddress:
                type:
                  - string
                  - 'null'
                description: >-
                  Solana token account address (ATA), distinct from
                  accountOwnerAddress (wallet owner).
              accountOwnerAddress:
                type: string
                description: Account owner address (trader wallet)
                example: 3xd4LGVWtYXLBspR6X5JWbW49NXmEehfPtX6Kqx98b4w
              addrType:
                type:
                  - integer
                  - 'null'
                format: int64
                description: >-
                  Address type from dexes_dwd.address_labels.

                  1=CEX, 2=Market Maker, 3=VC, 4=KOL, 5=DeFi, 6=Treasury,
                  7=Bridge, 8=Hacker.

                  Matches GMGN `addr_type`.
              blockHeight:
                type: integer
                format: int64
                description: Block height
                example: 332417228
              blockTimestamp:
                type: integer
                format: int64
                description: Block timestamp (milliseconds)
                example: 1717334400000
              chain:
                type: string
                description: Chain identifier
                example: sol
              dexFeeInNative:
                type:
                  - string
                  - 'null'
                description: >-
                  DEX protocol fee in native currency.

                  Aggregated from fees_processed[PROTOCOL] entries
                  (trade-processing-pipeline Bug A fix required).

                  Null when no PROTOCOL fee data is available (e.g. SOL — ETL
                  not yet populated).
                example: '0.00025'
              dexFeeInUsd:
                type:
                  - string
                  - 'null'
                description: >-
                  DEX protocol fee in USD.

                  Uses the same native-price snapshot as dex_fee_in_native;
                  satisfies same-snapshot constraint.

                  Null when no PROTOCOL fee data is available.
                example: '0.50'
              dexImage:
                type:
                  - string
                  - 'null'
                description: DEX image
                example: https://example.com/dex.png
              dexProgramAddress:
                type:
                  - string
                  - 'null'
                description: DEX program address
                example: whirLbMiicVdio4qvUfM5KAg6Ct8VwpYzGff3uctyCc
              dexProtocolFamily:
                type:
                  - string
                  - 'null'
                description: DEX protocol family
                example: OrcaWhirpool
              gasFee:
                type:
                  - integer
                  - 'null'
                format: int64
                description: 'Gas fee (raw: lamports for SOL, Gwei for BSC)'
                example: 5000
              gasFeeInNative:
                type:
                  - string
                  - 'null'
                description: Gas fee in native currency (SOL / BNB / ETH)
                example: '0.000073'
              gasFeeInUsd:
                type:
                  - string
                  - 'null'
                description: Gas fee in USD
                example: '0.011'
              historyBoughtAmount:
                type:
                  - string
                  - 'null'
                description: >-
                  Cumulative token quantity bought by this wallet (up to and
                  including this trade).

                  Matches GMGN `history_bought_amount`.
              historySoldAmount:
                type:
                  - string
                  - 'null'
                description: >-
                  Cumulative token quantity sold by this wallet (up to and
                  including this trade).

                  Matches GMGN `history_sold_amount`.
              historySoldIncome:
                type:
                  - string
                  - 'null'
                description: >-
                  Cumulative sell income (USD) for this wallet on this token (up
                  to and including this trade).

                  Matches GMGN `history_sold_income`.
              isOpenOrClose:
                type:
                  - integer
                  - 'null'
                format: int32
                description: >-
                  Position lifecycle: 0=normal, 1=open_position,
                  2=close_position

                  Matches GMGN `is_open_or_close` field.
              makerEventTags:
                type: array
                items:
                  type: string
                description: >-
                  Trade behaviour tags for this event (e.g. "open_position",
                  "dip_buy",

                  "take_profit", "stop_loss", "close_position", "accumulate",

                  "transfer_in", "transfer_out").

                  Matches GMGN `maker_token_tags` on the activity level.
              makerExchange:
                type:
                  - string
                  - 'null'
                description: >-
                  Entity / exchange name (e.g. "Binance"). Matches GMGN
                  `exchange`.
              makerName:
                type:
                  - string
                  - 'null'
                description: >-
                  Specific address label (e.g. "Binance Hot Wallet 1"). Matches
                  GMGN `maker_name`.
              marketCapInUsd:
                type:
                  - string
                  - 'null'
                description: Market cap in USD at trade time
                example: '1500000.00'
              poolAddress:
                type: string
                description: Pool address
                example: 58oQChx4yWmvKdwLLZzBi4ChoCc2fqCUWBkwMihLYQo2
              postBalance:
                type:
                  - string
                  - 'null'
                description: |-
                  Token balance after this trade (token quantity).
                  Matches GMGN `balance` in activity feed.
              priorityFeeInNative:
                type:
                  - string
                  - 'null'
                description: >-
                  EVM priority fee (fee_miner_reward ÷ 1e18) in native currency
                  (ETH/BNB).

                  Null on SOL (ETL does not yet provide compute-budget priority
                  fee).

                  Equals (effectiveGasPrice − baseFeePerGas) × gasUsed converted
                  to native units.
                example: '0.000005'
              realizedProfitInUsd:
                type:
                  - string
                  - 'null'
                description: >-
                  Realized PnL for this specific trade in USD (non-zero only on
                  Sell events).

                  Matches GMGN `realized_profit`.
              sideTokenAddress:
                type: string
                description: Side token address
                example: So11111111111111111111111111111111111111112
              sideTokenAmount:
                type: string
                description: Side token amount
                example: '1'
              sideTokenAmountInNative:
                type: string
                description: Side token amount in native currency
                example: '150'
              sideTokenAmountInUsd:
                type: string
                description: Side token amount in USD
                example: '150'
              sideTokenImageUrl:
                type:
                  - string
                  - 'null'
                description: Side token image URL
                example: https://arweave.net/sol.png
              sideTokenName:
                type: string
                description: Side token name
                example: Wrapped SOL
              sideTokenPriceInNative:
                type: string
                description: Side token price in native currency
                example: '1'
              sideTokenPriceInUsd:
                type: string
                description: Side token price in USD
                example: '150'
              sideTokenSymbol:
                type: string
                description: Side token symbol
                example: SOL
              status:
                type: string
                description: Transaction status
                example: SUCCEEDED
              tokenAddress:
                type: string
                description: Token address
                example: 6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN
              tokenAmount:
                type: string
                description: Token amount
                example: '1000000'
              tokenAmountInNative:
                type: string
                description: Token amount in native currency
                example: '100'
              tokenAmountInUsd:
                type: string
                description: Token amount in USD
                example: '8800000'
              tokenImageUrl:
                type:
                  - string
                  - 'null'
                description: Token image URL
                example: https://arweave.net/token.png
              tokenName:
                type: string
                description: Token name
                example: TRUMP
              tokenPriceInNative:
                type: string
                description: Token price in native currency
                example: '0.0001'
              tokenPriceInUsd:
                type: string
                description: Token price in USD
                example: '8.80'
              tokenSymbol:
                type: string
                description: Token symbol
                example: TRUMP
              totalTrade:
                type:
                  - integer
                  - 'null'
                format: int64
                description: >-
                  Total historical trade count for this wallet on this token
                  (buy + sell, up to and including this trade).

                  Matches GMGN `total_trade`.
              traderTags:
                type: array
                items:
                  type: string
                description: >-
                  Trader classification tags (e.g. "kol", "smart", "sniper",
                  "dev", "fresh", "bundle", "bluechip", "insider")
              transactionSignature:
                type: string
                description: Transaction signature
                example: >-
                  37XpPt9Ak6JiE1V3sftJDtdUsvR9FVFRqkZmoT3dp4BTD9pgyTWn1XgHH6R7NjuJ4pBMAgj8JvZtxQrf4s6NTC5F
              type:
                type: string
                description: Trade type (BUY/SELL)
                example: BUY
              unrealizedProfitInUsd:
                type:
                  - string
                  - 'null'
                description: >-
                  Unrealized profit in USD at the moment of this trade:

                  post_balance × token_price_in_usd − position_cost_in_usd.

                  Only populated when PnL pipeline has processed the row and
                  cost basis > 0.

                  Matches GMGN `unrealized_profit`.
          description: Page data
        endCursor:
          type:
            - string
            - 'null'
          description: Cursor for the end of current page
          example: eyJpZCI6ImVuZCJ9
        hasNext:
          type: boolean
          description: Whether there is a next page
          example: false
        hasPrev:
          type: boolean
          description: Whether there is a previous page
          example: false
        startCursor:
          type:
            - string
            - 'null'
          description: Cursor for the start of current page
          example: eyJpZCI6InN0YXJ0In0=
        total:
          type:
            - integer
            - 'null'
          format: int64
          description: >-
            Total number of items matching the query (not just the current
            page).

            When `None`, the caller should treat it as unknown
            (backward-compatible).
          example: 564094
  securitySchemes:
    bearer_auth:
      type: http
      scheme: bearer
      bearerFormat: JWT
    api_key_auth:
      type: apiKey
      in: header
      name: X-API-KEY

````