잔액 및 홀더

이 페이지는 지갑·홀더 분석을 위한 네 가지 Cube를 다룹니다:

BalanceUpdates (DWD) — 지갑별 잔액 변화 이벤트
TokenHolders (DWS) — 토큰의 현재 홀더 스냅샷
WalletTokenPnL (DWS) — 지갑별 토큰 손익(PnL)

아래 예시는 모두 network: sol(Solana)을 사용합니다. 다른 지원 체인은 eth, bsc, polygon 등으로 바꿉니다.

지갑의 토큰 잔액을 어떻게 가져오나요?

지갑의 현재 토큰 잔액을 조회합니다. 이 쿼리는 지갑이 보유한 각 토큰에 대해 가장 최근 잔액 업데이트 이벤트를 반환합니다.

query {
  Solana {
    BalanceUpdates(
      limit: {count: 50}
      ownerAddress: {is: "WALLET_ADDRESS"}
    ) {
      BalanceUpdate {
        Currency { MintAddress }
        Account { Owner }
        PostBalance
        PostBalanceInUSD
      }
      Block { Time }
    }
  }
}

GraphQL IDE에서 열기 — 위 쿼리를 붙여넣어 자동 완성과 스키마 탐색으로 대화형 실행할 수 있습니다.

WALLET_ADDRESS를 조사할 지갑으로 바꿉니다. ownerAddress 셀렉터는 지갑 소유자 기준으로 잔액 업데이트 이벤트를 필터링합니다.

주요 필드

필드	설명
`BalanceUpdate.Currency.MintAddress`	토큰 주소
`BalanceUpdate.Account.Owner`	지갑 소유자 주소
`BalanceUpdate.PostBalance`	업데이트 후 토큰 잔액
`BalanceUpdate.PostBalanceInUSD`	USD 기준 잔액 가치
`Block.Time`	잔액 업데이트 타임스탬프

맞춤 설정 팁

limit 늘리기: count: 200으로 더 많은 토큰(보유가 많은 지갑)
가치로 필터: where: {BalanceUpdate: {PostBalanceInUSD: {gt: 1}}}로 먼지 잔액 제외

잔액 변화 이력을 어떻게 가져오나요?

특정 토큰에 대해 지갑 잔액이 시간에 따라 어떻게 바뀌는지 추적합니다.

query {
  Solana {
    BalanceUpdates(
      limit: {count: 20}
      ownerAddress: {is: "WALLET_ADDRESS"}
      tokenAddress: {is: "TOKEN_ADDRESS"}
      orderBy: {descending: Block_Time}
    ) {
      BalanceUpdate {
        PreBalance
        PostBalance
        PostBalanceInUSD
      }
      Block { Time }
      Transaction { Hash }
    }
  }
}

주요 필드

필드	설명
`BalanceUpdate.PreBalance`	이벤트 이전 잔액
`BalanceUpdate.PostBalance`	이벤트 이후 잔액
`BalanceUpdate.PostBalanceInUSD`	이벤트 후 잔액의 USD 가치
`Block.Time`	잔액이 바뀐 시각
`Transaction.Hash`	변화를 일으킨 트랜잭션

맞춤 설정 팁

축적 감지: PreBalance와 PostBalance 비교 — PostBalance > PreBalance이면 지갑이 축적 중
기간: where: {Block: {Time: {since: "2025-03-01T00:00:00Z"}}}로 특정 기간 한정
더 긴 이력: count를 최대 10000까지 늘려 전체 잔액 이력

PostBalance와 PreBalance의 차이는 이벤트당 순변화를 나타냅니다. 양수면 유입, 음수면 유출입니다.

토큰의 상위 홀더를 어떻게 가져오나요?

잔액 기준으로 정렬된 토큰의 상위 홀더를 조회합니다.

query {
  Solana {
    TokenHolders(
      limit: {count: 100}
      tokenAddress: {is: "TOKEN_ADDRESS"}
    ) {
      Token { Address }
      Holder { Address }
      LatestBalance
      LatestBalanceUSD
      FirstSeen
      LastSeen
    }
  }
}

주요 필드

필드	설명
`Token.Address`	토큰 주소
`Holder.Address`	홀더 지갑 주소
`LatestBalance`	현재 토큰 잔액
`LatestBalanceUSD`	현재 잔액의 USD 가치
`FirstSeen`	이 홀더가 처음 해당 토큰을 보유한 시각
`LastSeen`	이 토큰과 관련된 가장 최근 트랜잭션

맞춤 설정 팁

고래 기준: where: {LatestBalanceUSD: {gt: 10000}}로 대형 홀더만
활성 홀더: where: {LastSeen: {after: "2025-03-01T00:00:00Z"}}로 최근 활동 홀더만
홀더 수: count 메트릭으로 총 홀더 수 조회

TokenHolders Cube는 DWS(Summary) 레이어 테이블로, 개별 잔액 업데이트를 스캔하는 것보다 훨씬 빠릅니다. 홀더 순위와 분포 분석에 사용하세요.

지갑 손익(PnL)을 어떻게 가져오나요?

지갑의 토큰별 손익 데이터를 조회합니다. 매수/매도 거래량과 거래 횟수를 포함합니다.

query {
  Solana {
    WalletTokenPnL(
      limit: {count: 20}
      walletAddress: {is: "WALLET_ADDRESS"}
    ) {
      Wallet { Address }
      Token { Address }
      BuyVolumeUSDState
      SellVolumeUSDState
      BuyCountState
      SellCountState
      FirstTradeState
      LastTradeState
    }
  }
}

주요 필드

필드	설명
`Wallet.Address`	지갑 주소
`Token.Address`	토큰 주소
`BuyVolumeUSDState`	이 토큰 매수에 쓴 총 USD
`SellVolumeUSDState`	이 토큰 매도로 받은 총 USD
`BuyCountState`	매수 거래 수
`SellCountState`	매도 거래 수
`FirstTradeState`	첫 거래 시각
`LastTradeState`	가장 최근 거래 시각

맞춤 설정 팁

PnL 계산: SellVolumeUSDState - BuyVolumeUSDState가 토큰별 실현 손익
보유 중 포지션: SellCountState < BuyCountState인 토큰으로 아직 보유 중인 자산 찾기
거래가 잦은 토큰: BuyCountState 또는 SellCountState로 정렬해 가장 자주 거래된 토큰 파악

WalletTokenPnL Cube는 ownerAddress가 아니라 walletAddress 셀렉터를 사용합니다. 누적 거래 메트릭을 제공하며 포트폴리오 분석·성과 리더보드에 적합합니다.

멀티체인 예시

Solana
Ethereum
BSC
Polygon

query {
  Solana {
    BalanceUpdates(
      limit: {count: 10}
      ownerAddress: {is: "WALLET_ADDRESS"}
    ) {
      BalanceUpdate {
        Currency { MintAddress }
        PostBalance
        PostBalanceInUSD
      }
    }
  }
}

query {
  EVM(network: eth) {
    BalanceUpdates(
      limit: {count: 10}
      ownerAddress: {is: "WALLET_ADDRESS"}
    ) {
      BalanceUpdate {
        Currency { MintAddress }
        PostBalance
        PostBalanceInUSD
      }
    }
  }
}

query {
  EVM(network: bsc) {
    BalanceUpdates(
      limit: {count: 10}
      ownerAddress: {is: "WALLET_ADDRESS"}
    ) {
      BalanceUpdate {
        Currency { MintAddress }
        PostBalance
        PostBalanceInUSD
      }
    }
  }
}

query {
  EVM(network: polygon) {
    BalanceUpdates(
      limit: {count: 10}
      ownerAddress: {is: "WALLET_ADDRESS"}
    ) {
      BalanceUpdate {
        Currency { MintAddress }
        PostBalance
        PostBalanceInUSD
      }
    }
  }
}

다음 단계

DEX 거래

DEX 거래 데이터 — 토큰 거래, 지갑 활동, 상위 트레이더를 조회합니다.

전송

지갑 간 온체인 토큰 전송을 추적합니다.

풀 및 유동성

DEX 풀과 유동성 데이터를 탐색합니다.

OHLC 및 통계

캔들 데이터, 거래 통계, TokenSupplyUpdates, 토큰 메타데이터를 가져옵니다.

시작하기

GraphQL IDE

스키마 & 데이터 모델

쿼리 예제

빌링 & 크레딧

지갑의 토큰 잔액을 어떻게 가져오나요?

잔액 변화 이력을 어떻게 가져오나요?

토큰의 상위 홀더를 어떻게 가져오나요?

지갑 손익(PnL)을 어떻게 가져오나요?

멀티체인 예시

다음 단계

DEX 거래

전송

풀 및 유동성

OHLC 및 통계

​지갑의 토큰 잔액을 어떻게 가져오나요?

​잔액 변화 이력을 어떻게 가져오나요?

​토큰의 상위 홀더를 어떻게 가져오나요?

​지갑 손익(PnL)을 어떻게 가져오나요?

​멀티체인 예시

​다음 단계

DEX 거래

전송

풀 및 유동성

OHLC 및 통계

지갑의 토큰 잔액을 어떻게 가져오나요?

잔액 변화 이력을 어떻게 가져오나요?

토큰의 상위 홀더를 어떻게 가져오나요?

지갑 손익(PnL)을 어떻게 가져오나요?

멀티체인 예시

다음 단계