게임 트랜잭션 조회

게임 거래내역 조회

get

지정된 기간 동안의 게임 관련 거래내역만 조회합니다.

포함 거래 유형:

• BET: 베팅

• WIN: 당첨

• CANCEL: 취소

• DEBIT_EXCEED_WIN: 초과 당첨금 차감

• ADJUST: 조정

• REWARD: 보상

제외 거래 유형:

• BALANCE_TRANSFER: 입출금 거래는 제외

• BALANCE_SYNC: 잔액 동기화는 제외

주요 기능:

• 게임 관련 거래만 필터링

• 날짜 범위 필터링 (필수)

• 사용자명 필터링 (선택)

• 페이지네이션 지원

사용 시나리오:

• 게임 수익성 분석

• 사용자 게임 패턴 분석

• 게임별 통계 생성

• RTP 분석 데이터

권한 요구사항:

• API Key 헤더 필수

• Agent ID 헤더 필수

Authorizations

ApiKeyAuthAgentIdAuth

api-keystringRequired

에이전트별 발급된 API 키를 입력하세요

Query parameters

startstringRequired

조회 시작 날짜 (ISO 8601 format, 필수)

Example: 2025-01-01T00:00:00Z

endstringRequired

조회 종료 날짜 (ISO 8601 format, 필수)

Example: 2025-01-31T23:59:59Z

usernamestringOptional

특정 사용자명으로 필터링 (선택)

Example: user123

pagenumberOptional

페이지 번호 (0부터 시작, 기본값: 0)

Default: 0Example: 0

sizenumber · min: 1 · max: 1000Optional

페이지 크기 (기본값: 100, 최대: 1000)

Default: 100Example: 100

orderstring · enumOptional

정렬 순서 (기본값: asc)

Possible values:

Responses

200

게임 거래내역 조회 성공

application/json

400

잘못된 요청 파라미터

application/json

401

인증 실패

application/json

500

서버 내부 오류

application/json

get

/api/transfer/transactions/games

HTTPcURLJavaScriptPython

GET /api/transfer/transactions/games?start=2025-01-01T00%3A00%3A00Z&end=2025-01-31T23%3A59%3A59Z HTTP/1.1
Host: {HIGHEND-API-SERVER}
api-key: YOUR_API_KEY
Accept: */*

{
  "list": [
    {
      "username": "user123",
      "amount": -1000.5,
      "type": "BET",
      "transaction": {
        "id": 12345,
        "type": "BET",
        "context": {
          "game_id": 1,
          "round_id": "round123",
          "game_title": "슬롯게임",
          "brand": "Evolution"
        },
        "created_at": "2025-01-15T10:30:00.000Z",
        "previous_tx_id": null
      }
    }
  ],
  "total": 89,
  "totalPages": 9
}