2026년 4월 22일 수요일

트랜잭션 조회 API · 블록체인 자동화 · 호출당 과금 REST API | APICK 에이픽

APICK · SERVICE BROCHURE · 블록체인

트랜잭션 조회 API

트랜잭션 해시로 블록체인 네트워크의 송신자·수신자·금액·상태를 조회하는 API

💳 호출당 - ⚡ 실시간 응답 🔐 단일 인증키 📡 REST 표준
About APICK

APICK 은 어떤 서비스인가요?

APICK(에이픽) 은 금융·사업자·부동산·신분증·OCR·이미지·문서까지 80여 종의 비즈니스 API 를 REST 표준으로 제공하는 호출당 과금 플랫폼 입니다. 단일 인증키 CL_AUTH_KEY 하나로 모든 API 를 사용할 수 있고, 월 최소 비용 없이 호출한 만큼만 과금되는 투명한 요금 정책이 특징입니다.

  • ✅ 단일 인증키 · 80+ REST API 통합 사용 — 한 번 가입하면 추가 계약 없이 바로 확장
  • ✅ 호출당 포인트 과금 · 월 최소 비용 없음 — 트래픽 규모와 무관하게 부담 없이 시작
  • ✅ 실시간 응답 · 호출 메타 자동 제공 — api.cost · api.ms · api.pl_id 자동 기록

APICK 회원가입 · 지금 시작하기 →

왜 APICK 인가 · 3가지 핵심 강점

01

정찰제 · 투명 가격

모든 API 가격이 정찰제로 공개되어 누구나 동일한 조건으로 이용합니다.

02

가입 즉시 전체 사용

회원가입 후 포인트 충전만으로 80여 종 API 를 즉시 호출할 수 있습니다.

03

5분 연동 · 무심사

별도 인증·심사·계약 없이 가입 후 5분 안에 모든 API 를 연동합니다.

주요 서비스 분야

01

금융·계좌 인증

계좌 실명 조회 · 은행코드 · 1원 인증 · 거래영업일

02

사업자·기업

사업자 정보 · 벤처기업 · 휴폐업 · 세무 상태

03

부동산·등기

건축물대장 · 인터넷등기소 · 토지대장 · 공시지가

04

개인·신분증 인증

주민번호 진위 · 신분증 OCR·진위 · 개인통관부호

05

이미지·영상·음성

얼굴 감지·블러 · 워터마크 · STT · TTS · 음성 변환

06

웹·문서·주소·검색

구글·유튜브 · URL 스크린샷 · PDF·DOCX 변환 · 도로명

한눈에 보는 연동 사양

엔드포인트
/rest/search_transaction/:블록체인종류/:TXID
REST · POST 요청
호출 단가
정책 별도
후불제 정책 별도 · 호출당
응답 시간
api.ms
응답 본문 api.ms 값으로 확인

핵심 특장점 · 빠른 도입 포인트

연동 담당자가 가장 먼저 확인하면 좋은 6가지 포인트입니다.

01

최소 입력 · 즉시 응답

필수 파라미터만 전달하면 평균 10초 이내, 최대 35초 응답으로 실시간 검증이 가능합니다.

02

표준 인증 방식

CL_AUTH_KEY (MD5 인증키) 를 헤더로 전달. 별도 OAuth 흐름 없이 즉시 호출 가능합니다.

03

호출 메타 자동 제공

응답에 api.cost · api.ms · api.pl_id 가 함께 반환되어 과금·성능·결제 로그를 즉시 추적할 수 있습니다.

04

투명한 과금

선불제 호출당 과금 · 후불제 정책 별도. 응답 본문 api.cost 로 실제 차감 포인트를 확인합니다.

05

단순 REST 인터페이스

표준 POST 요청 + FormData 형식으로 어떤 언어·프레임워크에서도 즉시 통합 가능합니다.

06

실패 응답 처리

data.success 값으로 판단: 0 실패 · 1 성공 · 3 타임아웃. 실패 응답은 정책에 따라 과금되지 않을 수 있습니다.

도입 효과

호출 메타 자동 제공 · 표준 REST 인터페이스 · 실시간 응답으로 기존 서비스 흐름에 즉시 편입됩니다.

✅ 호출 메타 자동 제공

api.cost / api.ms / api.pl_id 로 호출당 과금·성능·결제 로그를 즉시 추적합니다.

✅ 표준 REST 인터페이스

단순 POST + FormData 구조로 어떤 언어·프레임워크에서도 즉시 통합됩니다.

✅ 실시간 응답

평균 10초 이내 응답으로 사용자 흐름 중간에 자연스럽게 호출할 수 있습니다.

연동 사양 요약

MethodPOST
Endpointhttps://apick.app/rest/search_transaction/:블록체인종류/:TXID
HeaderCL_AUTH_KEY(인증키(MD5))
FormData값: -
Responsedata · api 객체
api 객체success · cost · ms · pl_id
success 값0 실패 · 1 성공 · 3 타임아웃
응답시간api.ms 값으로 확인 · 네트워크 상황에 따라 변동
과금 단위- / 호출당

요청 파라미터

별도 파라미터 없음 — 헤더만으로 호출 가능합니다.

요청 예시 · cURL

공식 가이드 기준 파라미터를 FormData 로 전달, 인증키는 헤더로 전달합니다.

curl -k -X POST "https://apick.app/rest/search_transaction/:블록체인종류/:TXID" \
  -H "CL_AUTH_KEY: $API_KEY"

응답 예시 · JSON 샘플

표준 응답 구조 샘플입니다. 실제 필드·값은 호출 대상에 따라 달라질 수 있으며, 정확한 스펙은 공식 개발가이드를 기준으로 확인하세요.

{
  "data": {
    "result": [
      {
        "transaction": {
          "block_id": 100000,
          "id": 216574,
          "hash": "fff2525b8931402dd09222c50775608f75787bd2b87e56995a7bdd30f79702c4",
          "date": "2010-12-29",
          "time": "2010-12-29 11:57:43",
          "size": 259,
          "weight": 1036,
          "version": 1,
          "lock_time": 0,
          "is_coinbase": false,
          "has_witness": false,
          "input_count": 1,
          "output_count": 2,
          "input_total": 5000000000,
          "input_total_usd": 13.500001,
          "output_total": 5000000000,
          "output_total_usd": 13.500001,
          "fee": 0,
          "fee_usd": 0,
          "fee_per_kb": 0,
          "fee_per_kb_usd": 0,
          "fee_per_kwu": 0,
          "fee_per_kwu_usd": 0,
          "cdd_total": 295.72048611111,
          "is_rbf": false,
          "confirm": 724438
        },
        "inputs": [],
        "outputs": []
      }
    ],
    "success": 1
  },
  "api": {
    "success": true,
    "cost": 10,
    "ms": 1110,
    "pl_id": 1595680
  }
}

응답 필드

경로 타입 설명
data.resultArray거래 목록
data.result[].transactionObject트랜잭션 정보
data.result[].transaction.block_idInteger블록 ID
data.result[].transaction.idInteger트랜잭션 ID
data.result[].transaction.hashString트랜잭션 해시
data.result[].transaction.dateString거래 날짜
data.result[].transaction.timeString거래 시간
data.result[].transaction.sizeInteger크기
data.result[].transaction.weightInteger무게
data.result[].transaction.versionInteger버전
data.result[].transaction.lock_timeInteger락 타임
data.result[].transaction.is_coinbaseBoolean코인베이스 여부
data.result[].transaction.has_witnessBoolean증인 데이터 포함 여부
data.result[].transaction.input_countInteger입력 개수
data.result[].transaction.output_countInteger출력 개수
data.result[].transaction.input_totalInteger입력 총액
data.result[].transaction.input_total_usdDecimal입력 총액 (USD)
data.result[].transaction.output_totalInteger출력 총액
data.result[].transaction.output_total_usdDecimal출력 총액 (USD)
data.result[].transaction.feeInteger수수료
data.result[].transaction.fee_usdDecimal수수료 (USD)
data.result[].transaction.fee_per_kbDecimalKB당 수수료
data.result[].transaction.fee_per_kb_usdDecimalKB당 수수료 (USD)
data.result[].transaction.fee_per_kwuDecimalKWU당 수수료
data.result[].transaction.fee_per_kwu_usdDecimalKWU당 수수료 (USD)
data.result[].transaction.cdd_totalDecimalCDD 총합
data.result[].transaction.is_rbfBooleanReplace-by-Fee 여부
data.result[].transaction.confirmInteger확인 횟수
data.result[].inputsArray입력 목록
data.result[].outputsArray출력 목록
data.successInteger과금 여부: 0=실패, 1=성공, 3=실패(timeout)
api.successBooleanAPI 서버 정상 응답 여부
api.costIntegerAPI 호출 요금
api.msIntegerAPI 응답 시간
api.pl_idIntegerAPI 결제 로그 ID

도입 체크리스트

Checklist

연동 작업 전 확인이 필요한 항목

✓APICK 회원가입 후 인증키(CL_AUTH_KEY) 발급
✓선불제 포인트 충전 또는 후불제 약정
✓호출 IP 화이트리스트 설정 검토
✓응답 객체 파싱 및 빈 값 처리 정책 수립
✓타임아웃(35초) 대응 로직 구현
✓api.cost 기반 과금 모니터링 구성

📄 트랜잭션 조회 API 가이드 PDF 다운로드

지금 바로 APICK 에 연동해보세요

회원가입 즉시 CL_AUTH_KEY 발급.
트랜잭션 조회 API 는 호출당 정책 별도, 월 최소 비용 없이 호출한 만큼만 과금됩니다.

APICK 회원가입 · 지금 시작하기 → 공식 개발 가이드 보기

* 본 문서는 APICK 공식 스펙을 바탕으로 정리한 연동 참고 자료입니다. 최신·정확한 스펙은 공식 개발 가이드 를 기준으로 확인하세요.

#APICK #에이픽 #비즈니스API #호출당과금API #RESTAPI #단일인증키API #월최소비용없는API #개발자API #트랜잭션조회API

Posted by at
Labels: , , , ,

댓글 없음:

댓글 쓰기

피드 구독하기: 댓글 (Atom)