Blockchain ledger API

Blockchain ledger API

version 1

Blockchain ledger API allows you to query information about basic entities like blocks, transactions and addresses. Also possible to receive information about transaction unspend outputs(UTXO), contracts and timeline statistics.

API endpoint

For all supported cryptocurrencies, APIs are available for Mainnet, Testnet, and the Tor network. For testnet networks available coins faucet and explorers.

Mainnet URL: https://api.bitaps.com/{currency}/v1/blockchain/
Testnet URL: https://api.bitaps.com/{currency}/testnet/v1/blockchain/
Tor Mainnet URL: http://bitaps4nifcusilt.onion/{currency}/v1/blockchain/

Available currency value: btc.

Request limits

For API, restrictions of requests by IP addresses apply. Standard limit 15 requests within 5 seconds for a single IP address. If you need more requests, then you need to purchase an API token. For questions about obtaining a token API, contact support@bitaps.com. If the limit is exceeded, a page with the status 429 to many requests is given in response to the request. If an error is received, you should wait for the time limit to be restored, otherwise the IP address will be blocked for 3 minutes. The current status of the limits can be found in the response headers Ratelimit-Remaining and Ratelimit-Reset .

Blocks

Block by identificator
get /block/{block_id}
Block information, block transaction list, blockchain and block statistics.
Path parameters
block_id
string
Block identificator hash or height
required
GET parameters
transactions
string
Transaction list [True,False], by default False
optional
block_statistic
string
Block statistics [True,False], by default False
optional
blockchain_state
string
Blockchain statistics [True,False], by default False
optional
Responses
application/json
200
data
object
required
   block
object
Block data
required
   transactions
object
Block transaction list
optional
   block_statistic
object
Block statistics
optional
   blockchain_state
object
Blockchain statistics
optional
time
integer
Request time
required
Last block
get /block/last
Last block information, block transaction list, blockchain and block statistics.
Path parameters
block_id
string
Block identificator hash or height
required
GET parameters
transactions
string
Transaction list [True,False], by default False
optional
block_statistic
string
Block statistics [True,False], by default False
optional
blockchain_state
string
Blockchain statistics [True,False], by default False
optional
Responses
application/json
200
data
object
required
   block
object
Block data
required
   transactions
object
Block transaction list
optional
   block_statistic
object
Block statistics
optional
   blockchain_state
object
Blockchain statistics
optional
time
integer
Request time
required
Last n blocks
get /blocks/blocks/last/{n}
List of last n blocks.
Path parameters
n
string
Blocks count <= 2016
required
Responses
application/json
200
data
array
Blocks list
optional
time
integer
Request time
required
Last n hours blocks
get /blocks/blocks/last/{n}/hours
List of blocks for last n hours.
Path parameters
n
string
Hours >=24
required
Responses
application/json
200
data
array
Blocks list
optional
time
integer
Request time
required
Blocks by hash
get /blocks/hash/list/{block_hash_list}
List of blocks by hash list, separated with ','.
Path parameters
block_hash_list
string
List of blocks by hash list, separated with ','.
required
Responses
application/json
200
data
array
Blocks list
optional
time
integer
Request time
required
Blocks by height
get /blocks/height/list/{block_height_list}
Path parameters
block_id
string
List of blocks by height list, separated with ','.
required
Responses
application/json
200
data
array
Blocks list
optional
time
integer
Request time
required
Daily blocks
get /blocks/blocks/date/{day}
Path parameters
day
string
Date formated with YYYYMMDD
required
Responses
application/json
200
data
array
Blocks list
optional
time
integer
Request time
required

Transactions

Transaction
get /transaction/{hash}
Path parameters
hash
string
Transaction identificator
required
Responses
application/json
200
data
object
Transaction data
required
time
integer
Request time
required

Addresses

Address state
get /address/state/{address}
Path parameters
address
string
Address
required
Responses
application/json
200
data
object
Address data
required
time
integer
Request time
required
Address state by type
get /{type}/address/state/{address}
Path parameters
type
string
Address type [pubkey, p2pkh, p2sh, p2wpkh, p2wsh]
required
address
string
Address
required
Responses
application/json
200
data
object
Address data
required
time
integer
Request time
required
Address transactions
get /address/transactions/{address}
Path parameters
address
string
Address
required
GET parameters
start
string
Start request time interval timestamp or YYYYMMDD
optional
end
string
Start request time interval timestamp or YYYYMMDD
optional
limit
string
Records per page
optional
page
string
Page number
optional
order
string
Order
optional
mode
string
View mode [verbose, brief]
optional
Responses
application/json
200
data
object
List of address transactions
required
time
integer
Request time
required
Address type transactions
get /{type}/address/transactions/{address}
Path parameters
type
string
Address type [pubkey, p2pkh, p2sh, p2wpkh, p2wsh]
required
address
string
Address
required
GET parameters
start
string
Start request time interval timestamp or YYYYMMDD
optional
end
string
Start request time interval timestamp or YYYYMMDD
optional
limit
string
Records per page
optional
page
string
Page number
optional
order
string
Order
optional
mode
string
View mode [verbose, brief]
optional
Responses
application/json
200
data
object
List of address transactions
required
time
integer
Request time
required
Address unconfirmed transactions
get /address/unconfirmed/transactions/{address}
Path parameters
address
string
Address
required
GET parameters
start
string
Start request time interval timestamp or YYYYMMDD
optional
end
string
Start request time interval timestamp or YYYYMMDD
optional
limit
string
Records per page
optional
page
string
Page number
optional
order
string
Order
optional
mode
string
View mode [verbose, brief]
optional
Responses
application/json
200
data
object
List of address transactions
required
time
integer
Request time
required
Address type unconfirmed transactions
get /{type}/address/unconfirmed/transactions/{address}
Path parameters
type
string
Address type [pubkey, p2pkh, p2sh, p2wpkh, p2wsh]
required
address
string
Address
required
GET parameters
start
string
Start request time interval timestamp or YYYYMMDD
optional
end
string
Start request time interval timestamp or YYYYMMDD
optional
limit
string
Records per page
optional
page
string
Page number
optional
order
string
Order
optional
mode
string
View mode [verbose, brief]
optional
Responses
application/json
200
data
object
List of address transactions
required
time
integer
Request time
required