트랜잭션 조회

전체 거래내역 조회

get

지정된 기간 동안의 모든 거래내역을 조회합니다.

포함 거래 유형:

• 게임 관련: BET, WIN, CANCEL, ADJUST, REWARD 등

• 입출금: BALANCE_TRANSFER

• 기타: 모든 사용자 거래

주요 기능:

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

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

• 페이지네이션 지원

• 정렬 옵션 (생성일 기준)

성능 최적화:

• 최대 조회 기간: 365일

• 최대 페이지 크기: 1000개

• 인덱스 최적화된 쿼리

사용 시나리오:

• 전체 거래 분석

• 사용자별 거래 패턴 분석

• 재무 데이터 추출

• 감사 및 리포팅

권한 요구사항:

• 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

HTTPcURLJavaScriptPython

GET /api/transfer/transactions?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"
        },
        "created_at": "2025-01-15T10:30:00.000Z",
        "previous_tx_id": 12344
      }
    }
  ],
  "total": 150,
  "totalPages": 15
}