메인포켓 자산 이전 목록 조회 가능 범위

본 API는 메인포켓의 API Key 권한을 사용하여 포켓 간 자산 이전 내역을 조회하는 API입니다.
메인포켓 ↔ 서브포켓 간 이전 내역은 물론, 서브포켓 간 이전 내역도 조회할 수 있습니다.
조회하고자하는 포켓 UUID는 포켓 정보 조회 API를 통해 확인할 수 있습니다.

flowchart LR
    A[포켓 정보 조회<br/>GET /v1/pockets] --> B[포켓 UUID 확인]
    B --> C[자산 이전 목록 조회 요청]

    C --> D{조회 파라미터 지정 여부}
    D -->|없음| E[최근 7일<br/>최신순 최대 20건]
    D -->|있음| F[지정 조건에 따라 조회]

    F --> G{조회 기간 설정}
    G -->|start_time, end_time 모두 미지정| H[이전 7일]
    G -->|start_time만 지정| I[지정 시각 이후 7일]
    G -->|end_time만 지정| J[지정 시각 이전 7일]
    G -->|start_time, end_time 모두 지정| N[지정한 기간]

    H --> K{기간 7일 이내?}
    I --> K
    J --> K
    N --> K

    E --> L[결과 반환]
    K -->|예| L[결과 반환]
    K -->|아니오| M[오류 발생<br/>최대 조회 범위 초과]

    style A fill:#eef,stroke:#446
    style M fill:#fee,stroke:#c44
    style L fill:#efe,stroke:#4a4

조회 기준 및 제약 사항

1. 기본 조회 조건

쿼리 파라미터를 별도로 지정하지 않으면, 기본 정책에 따라 최근 7일 이내의 이전 내역 중 최신순으로 최대 20건을 조회합니다.

2. 조회 기간 설정

start_time과 end_time을 사용하여 특정 기간의 이전 내역만 조회할 수 있습니다.

• start_time과 end_time을 모두 지정하지 않은 경우 요청 시점을 기준으로 이전 7일간의 내역을 조회합니다.
• start_time만 지정한 경우 지정한 시각부터 이후 7일간의 내역을 조회합니다.
• end_time만 지정한 경우 지정한 시각을 기준으로 이전 7일간의 내역을 조회합니다.

3. 조회 범위 제한

start_time과 end_time 사이의 전체 기간은 최대 7일을 초과할 수 없습니다. 7일을 초과하는 경우에는 허용 범위 초과 오류가 발생합니다.

4. 데이터 누락 방지

조회 기간 내 데이터가 많아 limit을 초과하는 경우, 한 번에 모두 반환되지 않을 수 있습니다. 전체 내역을 안전하게 수집하려면 기간을 나누어 분할 조회하는 것이 좋습니다.

5. 일시 형식

start_time과 end_time은 다음 형식 중 하나로 입력해야 합니다.

• ISO 8601 형식: 2025-06-24T04:56:53Z, 2025-06-24T13:56:53+09:00
• 밀리초 타임스탬프(UTC 기준): 1750741013000