서브포켓 자산 이전 목록 조회 가능 범위

본 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[direction]
    F --> H[states]
    F --> I[start_time / end_time]
    F --> J[currency]

    I --> K{조회 기간 7일 이내?}

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

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

조회 범위

조회 결과에는 해당 API Key가 속한 서브포켓과 관련된 이전 내역만 포함됩니다.

• direction = in : 해당 서브포켓으로 들어온 이전 내역만 조회합니다.
• direction = out : 해당 서브포켓에서 나간 이전 내역만 조회합니다.
• direction = all : 해당 서브포켓과 관련된 모든 이전 내역만을 조회합니다.

조회 기준 및 제약 사항

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