> ## 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 /ko/api-reference/openapi-data-ko.yaml GET /v2/wallet/{chain}/{walletAddress}/balance-updates 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/wallet/{chain}/{walletAddress}/balance-updates: get: tags: - Wallet summary: 지갑 - 잔액 변동 description: 필터링 및 페이지네이션을 적용한 지갑 잔액 변동 내역 조회 operationId: get.balance.updates parameters: - name: chain in: path description: 지원되는 네트워크에 나열된 체인 이름 required: true schema: $ref: '#/components/schemas/ChainSymbol' example: sol - name: walletAddress in: path description: 지갑 주소 required: true schema: type: string example: MJKqp326RZCHnAAbew9MDdui3iCKWco7fsK9sVuZTX2 - 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: FBmHMoWzwJB3g9GCSNTn1ZyvgkuZs7c8GTgNDoJNpump - name: timeFrom in: query description: 시작 타임스탬프 (Unix 초 단위 타임스탬프) required: false schema: type: integer format: int64 example: 1705312800000 - name: timeTo in: query description: 종료 타임스탬프 (Unix 초 단위 타임스탬프) required: false schema: type: integer format: int64 example: 1705399200000 - name: type in: query description: '잔액 유형 필터 (SOL: 네이티브, SPL: 토큰)' required: false schema: $ref: '#/components/schemas/BalanceTokenType' example: SPL - name: changeType in: query description: 잔액 변동 방향 필터 (INCREASE 또는 DECREASE) required: false schema: $ref: '#/components/schemas/BalanceChangeType' example: INCREASE responses: '200': description: 성공 응답 content: application/json: schema: $ref: '#/components/schemas/PageResponse_BalanceUpdate' components: schemas: ChainSymbol: type: string description: Supported blockchain chains enum: - sol - eth - bsc PageDirection: type: string description: Pagination direction enum: - next - prev BalanceTokenType: type: string description: Balance token type enum: - SOL - SPL BalanceChangeType: type: string description: Balance change type enum: - INCREASE - DECREASE PageResponse_BalanceUpdate: type: object description: Generic pagination response required: - data properties: data: type: array items: type: object description: Balance update record required: - blockHash - blockHeight - blockTimestamp - transactionSignature - index - tokenAddress - tokenAccountAddress - accountOwnerAddress - preBalance - preBalanceInNative - preBalanceInUsd - postBalance - postBalanceInNative - postBalanceInUsd - balanceChange - balanceChangeInNative - balanceChangeInUsd - type - changeType properties: accountOwnerAddress: type: string description: 계정 소유자 지갑 주소 balanceChange: type: string description: 잔액 변동 수량 balanceChangeInNative: type: string description: 네이티브 토큰 기준 잔액 변동 balanceChangeInUsd: type: string description: USD 기준 잔액 변동 blockHash: type: string description: 블록 해시 blockHeight: type: integer format: int64 description: 블록 높이 blockSlot: type: - integer - 'null' format: int64 description: 블록 슬롯 번호 blockTimestamp: type: integer format: int64 description: 블록 타임스탬프 (밀리초) changeType: $ref: '#/components/schemas/BalanceChangeType' description: 잔액 변동 방향 (INCREASE 또는 DECREASE) index: type: integer format: int64 description: 트랜잭션 인스트럭션 인덱스 postBalance: type: string description: 트랜잭션 이후 잔액 postBalanceInNative: type: string description: 네이티브 토큰 기준 이후 잔액 postBalanceInUsd: type: string description: USD 기준 이후 잔액 preBalance: type: string description: 트랜잭션 이전 잔액 preBalanceInNative: type: string description: 네이티브 토큰 기준 이전 잔액 preBalanceInUsd: type: string description: USD 기준 이전 잔액 tokenAccountAddress: type: string description: 토큰 계정 주소 tokenAddress: type: string description: 토큰 컨트랙트 주소 transactionSignature: type: string description: 트랜잭션 서명 type: $ref: '#/components/schemas/BalanceTokenType' description: '토큰 유형 (SOL: 네이티브, SPL: 토큰)' 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 ````