잔액 및 홀더

지갑 잔액, 잔액 이력, 토큰 홀더에 대한 쿼리 예제

이 페이지는 지갑·홀더 분석을 위한 네 가지 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

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

Ethereum

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

BSC

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

Polygon

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

---

​

다음 단계

DEX 거래

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

전송

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

풀 및 유동성

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

OHLC 및 통계

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