v1

latestOpenAPI 3.0.12026-07-24510443.1 KB

메인포켓 자산 이전 목록 조회

메인포켓의 API Key 권한을 사용하여 포켓 간(메인포켓 ↔ 서브포켓 등) 자산 이전 내역을 조회하는 API입니다.

get/pockets/universal_transfers

Query parameters

fromstring

자산을 보낸 포켓의 UUID

tostring

자산을 받은 포켓의 UUID

states[]'submitted' | 'processing' | 'done' | 'failed'

자산 이전 요청 상태. 지정한 상태의 이전 내역만 조회합니다. 미지정 시 모든 상태의 내역을 반환합니다. 예시 : "states[]"="done"&"states[]"="failed"

  • submitted : 접수됨
  • processing : 처리 중
  • done : 완료
  • failed : 실패
uuids[]string

자산 이전 요청을 식별하는 UUID 목록. 지정한 UUID에 해당하는 자산 이전 내역만 반환합니다. 예시 : uuids[]=uuid1&uuids[]=uuid2

  • 제한사항 : 최대 20개까지 조회 가능
identifiers[]string

클라이언트가 요청 시 지정한 식별자 목록. 예시 : identifiers[]=id1&identifiers[]=id2

  • 제한사항 : 최대 20개까지 조회 가능
start_timestring

조회 기간의 시작 시각. 지정한 시각부터 end_time까지 생성된 내역을 조회합니다.

  • 미입력 및 단일 입력 시 : start_time만 입력하면 지정 시각 기준 이후 7일, 모두 입력 시 요청 시각 기준 이전 7일 조회.
  • 허용 규격 : ISO 8601(타임존 포함) 또는 밀리초 타임스탬프
end_timestring

조회 기간의 종료 시각. start_time부터 지정한 시각까지 생성된 내역을 조회합니다.

  • 기본값 : 현재 시각
  • 제한 사항 : 최대 조회 범위 7일(초과 시 에러 발생)
  • 허용 규격 : ISO 8601(타임존 포함) 또는 밀리초 타임스탬프
currencystring

조회하고자 하는 자산의 코드 예: KRW, BTC, ETH 등

limitstring

요청 개수(페이지당 항목 수). Pagenation을 위해 지정합니다.

  • 기본값 : 20
  • 제한 사항: 한 번에 최대 100개까지 조회 가능
order_bystring

결과 정렬 방식. 이체 생성 시각을 기준으로 정렬합니다.

  • 기본값 : desc(최신순)
  • 허용값 : asc(오래된 순), desc

Response

uuidstring required

자산 이전 요청 UUID

identifierstring

자산 이전 요청 시 클라이언트가 지정한 식별자. identifier가 없는 경우 null이 반환됩니다.

fromstring

자산이 빠져나간 포켓의 UUID

tostring

자산이 들어간 포켓의 UUID

statestring

자산 이전 요청 상태.

  • submitted : 접수됨
  • processing : 처리 중
  • done : 완료
  • failed : 실패
currencystring

이전된 자산 코드 예: KRW, BTC, ETH 등

amountstring

이전된 자산 수량.

created_atstring

요청 생성 시간.