DEX 거래

DEX 거래 데이터에 대한 쿼리 예제

DEXTrades Cube에는 DEX 스왑 이벤트가 거래 단위로 들어 있으며, 제공되는 데이터 중 가장 세분화된 거래 데이터입니다. 개별 거래 조회, 지갑 활동 분석, 토큰 가격 추적, 상위 트레이더 찾기 등에 사용할 수 있습니다.

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

---

​

최신 DEX 거래를 어떻게 가져오나요?

Solana에서 가장 최근 DEX 거래 10건을 가져옵니다. 블록 정보, 트랜잭션 해시, 매수/매도 상세, DEX 프로토콜을 포함합니다.

query {
  Solana {
    DEXTrades(
      limit: {count: 10}
      orderBy: {descending: Block_Time}
    ) {
      Block { Time, Slot }
      Transaction { Hash }
      Trade {
        Buy {
          Currency { MintAddress }
          Amount
          PriceInUSD
          Account { Owner }
        }
        Sell {
          Currency { MintAddress }
          Amount
          Account { Owner }
        }
        Dex { ProgramAddress, ProtocolName }
      }
      Pool { Address }
    }
  }
}

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

주요 필드

필드	설명
Block.Time	블록 타임스탬프(ISO 8601)
Block.Slot	Solana 슬롯 번호(Solana 전용)
Transaction.Hash	온체인 트랜잭션 해시 — 익스플로러에서 해당 tx 조회에 사용
Trade.Buy.Currency.MintAddress	매수 자산의 토큰 주소
Trade.Buy.PriceInUSD	거래 시점 매수 토큰의 USD 가격
Trade.Buy.Account.Owner	매수자 지갑 주소
Trade.Dex.ProtocolName	DEX 이름(예: Raydium, Orca, Jupiter)
Pool.Address	거래가 실행된 유동성 풀 주소

맞춤 설정 팁

• 체인 전환: network: sol을 network: eth, network: bsc, network: polygon으로 변경
• 결과 수 늘리기: count: 10을 최대 10000까지 변경
• 시간 필터 추가: where: {Block: {Time: {after: "2025-03-01T00:00:00Z"}}}로 기간 한정
• DEX로 필터: where: {Trade: {Dex: {ProtocolName: {is: "Raydium"}}}}로 특정 프로토콜만

---

​

특정 토큰의 거래를 어떻게 가져오나요?

tokenAddress 셀렉터로 토큰 주소를 넘겨 해당 토큰의 거래를 조회합니다.

query {
  Solana {
    DEXTrades(
      limit: {count: 10}
      tokenAddress: {is: "TOKEN_ADDRESS"}
      orderBy: {descending: Block_Time}
    ) {
      Block { Time }
      Trade {
        Buy { Amount, PriceInUSD, Account { Owner } }
        Sell { Currency { MintAddress }, Amount }
        Dex { ProtocolName }
      }
      Pool { Address }
    }
  }
}

TOKEN_ADDRESS를 실제 토큰 mint 주소로 바꿉니다(예: Solana USDC는 EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v). 이름으로 주소를 찾으려면 토큰 메타데이터를 참고하세요.

주요 필드

필드	설명
Trade.Buy.Amount	매수한 토큰 수량
Trade.Buy.PriceInUSD	거래 시점 토큰당 가격
Trade.Buy.Account.Owner	매수를 실행한 지갑
Trade.Sell.Currency.MintAddress	매도 자산의 토큰 주소(페어의 반대쪽)
Trade.Dex.ProtocolName	DEX 프로토콜 이름

맞춤 설정 팁

• 최소 금액으로 필터: where: {Trade: {Buy: {Amount: {gt: 1000}}}}로 대량 거래만
• 가격 구간: where: {Trade: {Buy: {PriceInUSD: {gte: 0.001, lte: 1.0}}}}로 구간 한정
• 의심 거래 제외: IsSuspect = false 필터가 기본 적용되어 봇/MEV 거래는 이미 제외됨

---

​

지갑의 모든 거래를 어떻게 가져오나요?

특정 지갑 주소의 모든 거래를 조회합니다.

query {
  Solana {
    DEXTrades(
      limit: {count: 20}
      walletAddress: {is: "WALLET_ADDRESS"}
      orderBy: {descending: Block_Time}
    ) {
      Block { Time }
      Trade {
        Buy { Currency { MintAddress }, Amount, PriceInUSD }
        Sell { Currency { MintAddress }, Amount }
        Dex { ProtocolName }
      }
      Transaction { Hash, FeeInNative }
    }
  }
}

walletAddress 셀렉터는 해당 지갑이 매수자이거나 매도자인 거래와 일치합니다.

주요 필드

필드	설명
Trade.Buy.Currency.MintAddress	매수한 토큰
Trade.Sell.Currency.MintAddress	매도한 토큰
Transaction.FeeInNative	네이티브 토큰 단위 가스 수수료(Solana에서는 SOL)

맞춤 설정 팁

• 단일 토큰만: tokenAddress: {is: "TOKEN_ADDRESS"}와 함께 사용해 해당 지갑의 특정 토큰 거래만
• 시간 구간: where: {Block: {Time: {after: "2025-03-01T00:00:00Z"}}}로 최근 거래만
• limit 늘리기: count: 100으로 더 많은 이력(최대 10,000)

---

​

토큰의 현재 가격을 어떻게 가져오나요?

가장 최근의 비의심(non-suspect) 거래에서 토큰의 최신 가격을 가져옵니다.

query {
  Solana {
    DEXTrades(
      limit: {count: 1}
      tokenAddress: {is: "TOKEN_ADDRESS"}
      where: {IsSuspect: {eq: false}}
      orderBy: {descending: Block_Time}
    ) {
      Trade {
        Buy { PriceInUSD, PriceInNative }
      }
      Block { Time }
    }
  }
}

주요 필드

필드	설명
Trade.Buy.PriceInUSD	가장 최근 거래 기준 USD 가격
Trade.Buy.PriceInNative	체인 네이티브 토큰(SOL, ETH, BNB) 단위 가격
Block.Time	거래 타임스탬프 — 가격이 얼마나 최신인지 표시

맞춤 설정 팁

• 여러 시점 가격: count를 늘려 최근 가격 시리즈를 가져와 평균 등에 활용
• 크로스 체인: network: eth로 Ethereum에서 동일 토큰 가격 조회(해당 체인에 존재할 경우)

시간에 따른 안정적인 토큰 가격이 필요하면 Pairs Cube 사용을 고려하세요 — 분 단위 시가/고가/저가/종가가 미리 계산된 캔들 데이터를 제공합니다.

---

​

토큰의 상위 트레이더를 어떻게 찾나요?

집계로 토큰의 상위 트레이더를 찾습니다. 이 쿼리는 거래를 매수 지갑별로 묶어 총 매수 횟수와 거래량을 반환합니다.

query {
  Solana {
    DEXTrades(
      limit: {count: 100}
      tokenAddress: {is: "TOKEN_ADDRESS"}
      where: {IsSuspect: {eq: false}}
    ) {
      Trade {
        Buy {
          Account { Owner }
          Amount
          PriceInUSD
        }
      }
      count
      sum(of: Trade_Buy_Amount)
    }
  }
}

주요 필드

필드	설명
Trade.Buy.Account.Owner	지갑 주소(그룹 키)
count	해당 지갑의 거래 수
sum(of: Trade_Buy_Amount)	해당 지갑이 매수한 총 토큰량

맞춤 설정 팁

• 거래량 기준 정렬: 결과는 차원 필드별로 그룹화됨 — 차원을 줄이면 더 상위 수준 집계
• 기간 한정 리더보드: where: {Block: {Time: {after: "2025-03-01T00:00:00Z"}}} 추가
• 소액 거래 제외: where에 Trade: {Buy: {Amount: {gt: 100}}} 추가

메트릭 필드(count, sum)와 차원 필드를 함께 선택하면 API가 선택한 차원으로 결과를 자동 그룹화합니다. 자세한 내용은 Metrics & Aggregation을 참고하세요.

---

​

멀티체인 예시

동일한 쿼리는 지원되는 모든 체인에서 동작합니다 — network 파라미터만 바꾸면 됩니다.

Solana

query {
  Solana {
    DEXTrades(
      limit: {count: 5}
      orderBy: {descending: Block_Time}
    ) {
      Block { Time, Slot }
      Trade {
        Buy { Currency { MintAddress }, PriceInUSD }
        Dex { ProtocolName }
      }
    }
  }
}

Ethereum

query {
  EVM(network: eth) {
    DEXTrades(
      limit: {count: 5}
      orderBy: {descending: Block_Time}
    ) {
      Block { Time, Height }
      Trade {
        Buy { Currency { MintAddress }, PriceInUSD }
        Dex { ProtocolName }
      }
    }
  }
}

BSC

query {
  EVM(network: bsc) {
    DEXTrades(
      limit: {count: 5}
      orderBy: {descending: Block_Time}
    ) {
      Block { Time, Height }
      Trade {
        Buy { Currency { MintAddress }, PriceInUSD }
        Dex { ProtocolName }
      }
    }
  }
}

---

​

다음 단계

전송

온체인 토큰 전송 데이터를 조회합니다.

잔액 및 홀더

지갑 잔액, 잔액 이력, 상위 홀더를 조회합니다.

풀 및 유동성

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

OHLC 및 통계

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