Bitcoin: REST API Documentation
Introduction
————-
The Bitcoin Core (BTC) project provides a RESTful API for interacting with the blockchain. This article provides a detailed overview of the REST API, including its usage and some examples of its functions.
Getting Started
—————–
To start using the BTC REST API, you need to obtain an API key from the official Bitcoin Core website. You can do this by registering on the [official website] (
Once you have your API key, you can use it to create a client library in your desired programming language (e.g. Python, JavaScript, Ruby). The client library provides an interface for accessing the BTC REST API.
REST API Endpoints
——————
The BTC REST API provides several endpoints for interacting with the blockchain:
- Blocks: Retrieve the last block by ID, or retrieve all blocks.
- Transactions: Transaction details by ID, or all transactions.
- Wallets: Get wallet information, including balance and address.
- Nodes: Get node information, including network status and available nodes.
Getting the last block
You can use the following endpoint to get the last block:
Get /blockchain/v1/block/last_block
Replace /blockchain/v1' with the desired version (e.g.
v1′ for Bitcoin Core 0.7.x).
Transaction Details
To get transaction details by ID or to get all transactions, use the following endpoints:
GET /transaction/v1/transaction/{txid}
Replace {txid}
with the desired transaction ID.
For example, to get transaction details by ID:
GET /transaction/v1/transaction/1234567890abcdef
Wallet Information
To get wallet information, including balance and address, use the following endpoint:
GET /wallets/v1/wallet/{walletid}
Replace {walletyid}
with the desired wallet ID.
For example, to get wallet information by ID:
GET /wallets/v1/wallet/1234567890abcdef
Node Information
To get information about a node, including network status and available nodes, use the following endpoint:
Get /nodes/v1/nodes
This endpoint returns a list of all hosts available on the local network.
Example Client Code (Python)
—————————–
Here is an example client code for using the BTC REST API with Python:
import requests
Configure the API key and versionapi_key = "YOUR_API_KEY_HERE"
version = "0.7.x"
Configure the endpoint URLendpoint_url = f"
Create a client library objectclient = requests.Client()
try:
Get the last blockresponse = client.get(endpoint_url)
Check if the response was successfulif response.status_code = = 200:
Parse the JSON responseblock_data = response.json()
print("Latest block:", block_data)
else:
print(f"Error: {response.status_code}")
except requests.exceptions.HTTPERror as http_err:
print(f"An HTTP error occurred: {http_err}")
Conclusion
———-
The Bitcoin Core REST API provides a powerful means of interacting with the blockchain. By understanding how to use the API, you can perform a wide range of tasks, from retrieving information about blocks to managing wallet balances. This article provides a detailed overview of the REST API and provides examples of its use in Python.