화면 준비
신고 준비 화면을 불러오고 있어요.
잠시만 기다려 주세요.
신고 준비 화면을 불러오고 있어요.
잠시만 기다려 주세요.
체결 ID와 수량·수수료에 어떤 값이 기록됐는지 확인하고 싶을 때 읽기 전용 API로 조회해요. 받은 자료는 화면에서 읽거나 CSV로 보관할 수 있어요.
공식 명세와 합성 응답으로 검증한 시험 조회예요. 실제 계정의 체결 자료와 대조하는 검증은 아직 마치지 않았어요. API 원자료는 세금 계산 원장에 추가하지 않아요.
공식 문서·기능 확인일:
| 하려는 일 | 사용할 자료 | Kontaxt에서 하는 일 |
|---|---|---|
| 체결·수수료의 원값 확인 | UTA 현물 원자료 API | 조회 결과를 읽고 보관용 CSV를 내려받아요. |
| 기존 파일 방식으로 계산 준비 | 비트겟에서 받은 현물 주문 상세(Spot Order details) 원본 CSV | 지원 형식의 파일을 업로드해 계산에 사용해요. |
이 화면에서 저장한 원자료 CSV는 비트겟의 주문 상세 CSV와 형식이 달라요. 기존 CSV와 자동으로 합치거나 대조하지 않으며, 계산용 업로드 파일로 사용할 수 없어요.
지원 파일과 준비 항목 확인화면의 기간은 서버에 요청한 조건이에요. 반환된 기록의 시각이나 빠진 항목을 임의로 보정하지 않아요. 현물 분류만으로 과거 거래의 차입 여부도 판단하지 않아요.
비트겟 API 관리에서 UTA 관리와 거래의 조회 권한만 허용한 읽기 전용 키를 준비해요. 읽기·쓰기 권한이나 다른 권한이 있으면 조회할 수 없어요. API 키·시크릿 키와 키를 만들 때 정한 패스프레이즈가 필요해요.
Kontaxt 구독 계정으로 로그인한 뒤 비트겟 원자료 조회 화면을 열어요. 완료된 한국 시간 날짜에서 시작일과 종료일을 선택하고, 세 인증값을 입력해요.
‘체결 원자료 조회’를 눌러요. 받은 건수와 페이지 수, 요청 기간·조회 시각을 함께 읽고, 각 체결을 열어 수량과 수수료 원값을 확인해요.
‘조회 원자료 CSV 저장’을 눌러 현재 결과를 내려받아요. Excel에서는 모든 열을 텍스트로 가져와 긴 체결 번호와 소수 자릿수를 보존해 주세요.
인증값 입력란은 제출하면 비워져요. 다시 조회하려면 새로 입력해 주세요. 대기 시각이 표시되면 그 시각 뒤에 직접 다시 조회하며, 자동으로 반복 조회하지 않아요.
1,000건보다 적게 받았거나 빈 페이지가 반환돼도 계정 전체 기록이 빠짐없이 준비됐다는 뜻은 아니에요. 0건은 이번 요청에서 받은 기록이 없다는 의미예요.
일부 조회라면 요청한 기간과 종료 이유를 확인하고 기간을 좁혀 다시 조회해 주세요. 기간을 나눠 조회해도 누락이 없다고 자동 판정하거나 여러 결과를 합치지는 않아요.
응답에 항목 자체가 없는 경우와 null, 빈 문자열, 0은 뜻이 달라요. 빠진 수수료를 0으로 채우거나, 비어 있다는 이유로 수수료가 없었다고 판단하지 않아요.
수수료 통화가 여러 개면 각각 보여 줘요. 음수도 부호를 바꾸지 않으며 할인·환급으로 해석하지 않아요. 수량에서 수수료를 임의로 빼거나 더하지 않아요.
아래는 표시 의미를 설명하는 예시이며 실제 계정 자료가 아니에요.
| 표시 | 읽는 방법 |
|---|---|
| 미제공 | 응답에 해당 항목이 없어요. |
| null | 항목에 null이 명시돼 있어요. |
| 빈 문자열 | 항목은 있지만 텍스트가 비어 있어요. |
| 0 | 숫자 문자열 0이 반환됐어요. |
| 빈 배열 | 수수료 목록이 비어 있어요. 수수료가 없었다는 판단은 별도예요. |
CSV에는 요청 기간과 출처, 조회 시각·페이지 수·종료 이유를 함께 남겨요. missingFields는 미제공 항목, nullFields는 명시된 null을 가리켜요. 수수료 목록은 여러 통화와 빈 값의 구분을 유지하도록 JSON 형태로 들어가요.
숫자나 수식처럼 해석될 수 있는 셀에는 보호용 작은따옴표를 붙여요. 추가한 위치는 행의 protectedFields에 표시하고, 메타 정보는 세 번째 열의 protected로 표시해요. 원값을 복원할 때는 표시된 셀에서만 앞의 작은따옴표 하나를 제거해 주세요.
이 파일은 선택한 원값과 보호 표시를 담은 보관용 CSV예요. 비트겟 응답 원본과 바이트 단위로 같은 파일은 아니에요.
이번 조회는 계산 원장이나 잔액을 바꾸지 않아요. 원자료의 수량·수수료·차입 여부를 계산용 거래로 확정하는 연결은 아직 구현하지 않았어요. 기존 파일 계산을 준비하려면 지원되는 주문 상세 CSV를 사용해 주세요.
같은 Kontaxt 계정에서는 이전 성공 결과를 유지해요. 새 조회가 성공하면 0건인 경우에도 새 결과로 바뀌어요. 화면을 떠나거나 계정을 바꾸면 결과는 사라져요.
이 조회만으로 모든 체결이 포함됐는지는 확인할 수 없어요. 요청 기간과 받은 기록의 시각을 확인하고, 비트겟에서 별도로 준비한 같은 기간의 기록과 비교해 주세요. 건수가 적거나 0건이어도 누락이 없다는 뜻은 아니에요.
최근 89개 완료된 날짜·최대 30일·1,000건은 현재 Kontaxt의 조회 범위예요. 비트겟의 모든 API 기능에 같은 제한이 적용된다는 뜻은 아니에요.
구독 계정으로 로그인한 뒤 기간을 골라 비트겟 원자료를 조회해요. 계산용 파일이 필요하면 지원 파일 안내를 먼저 확인해 주세요.
API 조회는 구독 기능이에요. 무료로 거래를 정리하려면 지원 파일을 업로드해 주세요. 기존 베타·구매 권리는 안내받은 범위와 기간에 따라 유지돼요.
비트겟 원자료 조회