API Reference

코인스택 API는 모든 데이터를 객체로 취급하여 주고 받습니다. 코인스택 API를 호출할 때 파라미터로 코인스택 객체를 제공해야 하고, 또한 그 결과로 코인스택 객체를 반환받게 되므로 어떤 종류가 있는지, 어떤 속성을 갖는지 본 문서를 통해 확인하시기 바랍니다.

코인스택 API는 다음과 같이 다양한 종류의 객체를 제공하지만, 대부분 블록체인의 데이터 모델에 대응하여 설계되어 있으므로 쉽게 파악할 수 있습니다.

BlockchainStatus

BlockchainStatus는 블록체인의 상태 정보를 나타내는 객체입니다.

Attribute Type Description
best_block_hash string 가장 최신의 블록체인 블록 해시
best_height number 블록체인의 현재 높이, 즉 가장 최신의 블록 번호

Block

Block은 블록체인을 구성하는 특정 블록의 상태 정보를 나타내는 객체입니다.

Attribute Type Description
block_hash string 블록의 해시
height number 블록의 높이
confirmation_time date 블록이 승인된 시간
parent string 블록의 부모 블록 해시
children array[string] 블록의 자식 블록 해시 목록
transaction_list array[string] 요청한 블록에 포함된 트랜잭션 해시 목록

Address

Address는 비트코인 주소를 의미하며, Address 관련 객체들은 아래와 같습니다.

1. Address Balance

Address Balance는 현재 특정 비트코인 주소에서 다른 주소로 송금 가능한 잔액을 사토시 단위로 나타내는 객체입니다.

Attribute Type Description
balance number 주소의 사용 가능한 잔고 (사토시 단위)

2. Address History

Address History는 특정 비트코인 주소와 관련된 트랜잭션들의 해시값 목록을 가지는 객체입니다.

Attribute Type Description
(없음) array[string] 주소에 발생한 트랜잭션 해시 목록

3. Address Unspent Outputs

Address Unspent Output은 특정 비트코인 주소의 잔액을 구성하는, 소비되지 않은 출력값에 관한 객체입니다.

Attribute Type Description
transaction_hash string output이 속한 트랜잭션 해시
index number output index
value string output의 값 (사토시 단위)
script string output의 script
confirmations number output이 속한 트랜잭션이 승인된 회수

Transaction

Transaction은 블록에 저장된 주소 간의 거래 정보인 트랜잭션을 나타내는 객체입니다.

Attribute Type Description
transaction_hash string 트랜잭션의 해시
block_hash list[string] 트랜잭션이 포함된 블록의 해시
block_hash.block_hash string 트랜잭션이 포함된 블록의 해시
block_hash.block_height number 트랜잭션이 포함된 블록의 높이
coinbase boolean Coinbase 트랜잭션 여부
inputs array[object] Transaction Input 목록
outputs array[object] Transaction Output 목록
timestamp string 트랜잭션이 포함된 블록이 최초 승인된 시간 - date 참조
initialtimestamp string 트랜잭션이 broadcast된 시간 - date 참조
addresses array[string] 트랜잭션과 관련된 주소 목록

1. Transaction Input

Transaction Input은 특정 트랜잭션의 입력값을 나타내는 객체입니다. 하나의 트랜잭션에는 하나 이상의 입력값이 존재할 수 있으며, Transaction 객체에는 이들의 목록이 배열로 저장됩니다. Transaction Input은 이 목록을 구성하는 개별 입력값 단위에 해당합니다.

Attribute Type Description
transaction_hash string input이 포함된 트랜잭션
output_index number 해당 트랜잭션에서의 output index
address array[string] 해당 input과 관련된 주소 목록
value number input 값 (사토시 단위)

2. Transaction Output

Transaction Output은 특정 트랜잭션의 출력값을 나타내는 객체입니다. 하나의 트랜잭션에는 하나 이상의 출력값이 존재할 수 있으며, Transaction 객체에는 이들의 목록이 배열로 저장됩니다. Transaction Output은 이 목록을 구성하는 개별 출력값 단위에 해당합니다.

Attribute Type Description
index number
address array[string] output과 관련된 주소 목록
script string output의 script
value number output 값 (사토시 단위)
used boolean (Optional) output 의 사용 여부
data string (Optional) OP_RETURN 데이터

Stamp

코인스택 고유 기능인 문서 진위 확인 서비스(Document Stamping)에서 사용하는 객체입니다.

Attribute Type Description
tx string 스탬프 정보가 기록되어 등록된 트랜잭션 해시
vout number 상기 트랜잭션의 출력값 중 스탬프 정보가 기록된 위치
confirmations number 상기 트랜잭션이 속한 블럭의 승인된 횟수
timestamp string 상기 트랜잭션이 속한 블럭이 최초 승인된 시간 - date 참조

results matching ""

    No results matching ""