> ## 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.

# 전송 쿼리

> 온체인 전송 데이터에 대한 쿼리 예제

**Transfers** Cube에는 온체인 토큰 전송 이벤트가 들어 있습니다 — 토큰이 한 지갑에서 다른 지갑으로 이동할 때마다 기록됩니다. 지갑 활동 추적, 고래 움직임 모니터링, 토큰 흐름 분석, 거래소 입출금 감지 등에 사용할 수 있습니다.

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

***

## 최신 전송을 어떻게 가져오나요?

Solana에서 가장 최근 토큰 전송 10건을 가져옵니다. 발신자, 수신자, 수량, USD 가치를 포함합니다.

```graphql theme={null}
query {
  Solana {
    Transfers(
      limit: {count: 10}
      orderBy: {descending: Block_Time}
    ) {
      Block { Time }
      Transaction { Hash }
      Transfer {
        Currency { MintAddress }
        Sender { Address }
        Receiver { Address }
        Amount
        AmountInUSD
      }
    }
  }
}
```

<Tip>
  [GraphQL IDE에서 열기](https://ide.chainstream.io) — 위 쿼리를 붙여넣어 자동 완성과 스키마 탐색으로 대화형 실행할 수 있습니다.
</Tip>

<AccordionGroup>
  <Accordion title="주요 필드">
    | 필드                              | 설명                 |
    | :------------------------------ | :----------------- |
    | `Block.Time`                    | 블록 타임스탬프(ISO 8601) |
    | `Transaction.Hash`              | 온체인 트랜잭션 해시        |
    | `Transfer.Currency.MintAddress` | 전송되는 토큰 주소         |
    | `Transfer.Sender.Address`       | 토큰을 보낸 지갑          |
    | `Transfer.Receiver.Address`     | 토큰을 받은 지갑          |
    | `Transfer.Amount`               | 전송된 토큰 수           |
    | `Transfer.AmountInUSD`          | 전송 시점의 USD 가치      |
  </Accordion>

  <Accordion title="맞춤 설정 팁">
    * **토큰으로 필터**: `tokenAddress: {is: "TOKEN_ADDRESS"}`로 특정 토큰 전송만
    * **대액 전송만**: `where: {Transfer: {AmountInUSD: {gt: 10000}}}`로 고래 움직임 탐지
    * **기간**: `where: {Block: {Time: {after: "2025-03-01T00:00:00Z"}}}`로 기간 한정
  </Accordion>
</AccordionGroup>

***

## 지갑에서 나가는 전송을 어떻게 가져오나요?

`senderAddress` 셀렉터로 특정 지갑의 발신 전송을 조회합니다.

```graphql theme={null}
query {
  Solana {
    Transfers(
      limit: {count: 20}
      senderAddress: {is: "WALLET_ADDRESS"}
      orderBy: {descending: Block_Time}
    ) {
      Block { Time }
      Transfer {
        Currency { MintAddress }
        Receiver { Address }
        Amount
        AmountInUSD
      }
    }
  }
}
```

<Tip>
  `WALLET_ADDRESS`를 조사하려는 실제 지갑 주소로 바꿉니다.
</Tip>

<AccordionGroup>
  <Accordion title="주요 필드">
    | 필드                              | 설명           |
    | :------------------------------ | :----------- |
    | `Transfer.Currency.MintAddress` | 어떤 토큰을 보냈는지  |
    | `Transfer.Receiver.Address`     | 누가 받았는지      |
    | `Transfer.Amount`               | 보낸 토큰 수      |
    | `Transfer.AmountInUSD`          | 전송 시점 USD 가치 |
  </Accordion>

  <Accordion title="맞춤 설정 팁">
    * **특정 토큰만**: `tokenAddress: {is: "TOKEN_ADDRESS"}`로 한 토큰으로 좁히기
    * **결과 수 늘리기**: `count: 20`을 최대 `10000`까지 변경해 더 깊은 이력
    * **수신자 필터**: `where: {Transfer: {Receiver: {Address: {is: "RECEIVER_ADDRESS"}}}}`로 두 지갑 간 전송 추적
  </Accordion>
</AccordionGroup>

***

## 지갑으로 들어오는 전송을 어떻게 가져오나요?

`receiverAddress` 셀렉터로 지갑으로 들어오는 전송을 찾습니다.

```graphql theme={null}
query {
  Solana {
    Transfers(
      limit: {count: 20}
      receiverAddress: {is: "WALLET_ADDRESS"}
      orderBy: {descending: Block_Time}
    ) {
      Block { Time }
      Transfer {
        Currency { MintAddress }
        Sender { Address }
        Amount
        AmountInUSD
      }
    }
  }
}
```

<Tip>
  Transfers Cube는 `senderAddress`와 `receiverAddress` 셀렉터를 모두 지원합니다. `where`와 조합해 추가 필터(예: 기간, 최소 금액)를 걸 수 있습니다.
</Tip>

***

## 특정 토큰의 모든 전송을 어떻게 가져오나요?

네트워크 전체에서 특정 토큰의 전송을 추적합니다.

```graphql theme={null}
query {
  Solana {
    Transfers(
      limit: {count: 20}
      tokenAddress: {is: "TOKEN_ADDRESS"}
      orderBy: {descending: Block_Time}
    ) {
      Block { Time }
      Transaction { Hash }
      Transfer {
        Sender { Address }
        Receiver { Address }
        Amount
        AmountInUSD
      }
    }
  }
}
```

<AccordionGroup>
  <Accordion title="맞춤 설정 팁">
    * **고래 알림**: `where: {Transfer: {AmountInUSD: {gt: 100000}}}`로 대액 전송만(>\$100K)
    * **먼지 제외**: `where: {Transfer: {Amount: {gt: 0.01}}}`로 무시할 만한 소액 제외
    * **기간 한정**: `where: {Block: {Time: {since: "2025-03-27T00:00:00Z"}}}`와 조합해 당일 전송 등
  </Accordion>
</AccordionGroup>

***

## 멀티체인 예시

<Tabs>
  <Tab title="Solana">
    ```graphql theme={null}
    query {
      Solana {
        Transfers(
          limit: {count: 5}
          orderBy: {descending: Block_Time}
        ) {
          Block { Time }
          Transfer {
            Currency { MintAddress }
            Sender { Address }
            Receiver { Address }
            Amount
          }
        }
      }
    }
    ```
  </Tab>

  <Tab title="Ethereum">
    ```graphql theme={null}
    query {
      EVM(network: eth) {
        Transfers(
          limit: {count: 5}
          orderBy: {descending: Block_Time}
        ) {
          Block { Time }
          Transfer {
            Currency { MintAddress }
            Sender { Address }
            Receiver { Address }
            Amount
          }
        }
      }
    }
    ```
  </Tab>

  <Tab title="BSC">
    ```graphql theme={null}
    query {
      EVM(network: bsc) {
        Transfers(
          limit: {count: 5}
          orderBy: {descending: Block_Time}
        ) {
          Block { Time }
          Transfer {
            Currency { MintAddress }
            Sender { Address }
            Receiver { Address }
            Amount
          }
        }
      }
    }
    ```
  </Tab>

  <Tab title="Polygon">
    ```graphql theme={null}
    query {
      EVM(network: polygon) {
        Transfers(
          limit: {count: 5}
          orderBy: {descending: Block_Time}
        ) {
          Block { Time }
          Transfer {
            Currency { MintAddress }
            Sender { Address }
            Receiver { Address }
            Amount
          }
        }
      }
    }
    ```
  </Tab>
</Tabs>

***

## 다음 단계

<CardGroup cols={2}>
  <Card title="DEX 거래" icon="arrow-right-arrow-left" href="/ko/graphql/examples/dex-trades">
    DEX 거래 데이터 — 토큰 거래, 지갑 활동, 상위 트레이더를 조회합니다.
  </Card>

  <Card title="잔액 및 홀더" icon="wallet" href="/ko/graphql/examples/balance-holders">
    지갑 잔액, 잔액 이력, 상위 토큰 홀더를 조회합니다.
  </Card>

  <Card title="풀 및 유동성" icon="droplet" href="/ko/graphql/examples/pools-liquidity">
    DEX 풀과 유동성 데이터를 탐색합니다.
  </Card>

  <Card title="OHLC 및 통계" icon="chart-candlestick" href="/ko/graphql/examples/ohlc-stats">
    캔들 데이터, 거래 통계, 시가총액, 토큰 메타데이터를 가져옵니다.
  </Card>
</CardGroup>