[GET] 트랜잭션 기록 조회

에이전트가 생성한 유저들의 기간별 트랜잭션 기록을 조회합니다.

response.list는 Wallet API 연동 가이드 - 밸런스 트랜잭션 요청의 요청 Body와 동일한 format을 가집니다.

각 필드에 대한 설명은 Wallet API 연동 가이드 - 밸런스 트랜잭션 요청에서 자세히 확인가능합니다.

---

Get transactions

GET /api/transfer/transactions

Query String Parameter

쿼리 스트링으로 페이지네이션, 기간 조회를 할 수 있습니다.

Name	Type	Description
start*	String	조회 기간의 시작 시각 입니다. (gte) Format: ISO 8601 2025-01-01T00:00:00Z
end*	String	조회 기간의 종료 시각 입니다. (lt) Format: ISO 8601 2025-01-01T00:00:00Z
page	Number string	요청할 페이지 번호. Default: 0
size	Number string	한 페이지에 포함할 트랜잭션 수 Default: 100
username	String	특정 유저의 트랜잭션을 조회 할 경우 사용합니다.
order	Enum asc desc	생성일 기준으로 오름차순, 내림차순으로 조회합니다. Default: asc

start와 end의 간격은 2시간을 초과할 수 없습니다.

page 는 0번부터 시작합니다.

Response

200 Success

{
    "list": [
        {
            "username": "sales07",
            "amount": 0,
            "type": "WIN",
            "transaction": {
                "id": 50,
                "type": "WIN",
                "context": {
                    "game_id": 961,
                    "round_id": "1954482197935554560",
                    "game_title": "Gem Saviour",
                    "brand": "PgSoft",
                    "game_type": "SLOT"
                },
                "created_at": "2025-08-10T09:57:23.236Z",
                "previous_tx_id": 55
            }
        },
        {
            "username": "sales07",
            "amount": 10000,
            "type": "BALANCE_TRANSFER",
            "transaction": {
                "id": 53,
                "type": "BALANCE_TRANSFER",
                "context": null,
                "created_at": "2025-08-10T09:00:47.621Z",
                "previous_tx_id": null
            }
        },
    ],
    "total": 210,
    "totalPages": 3
}