The quickest way to start building on Aleo with Quicknode is by sending a REST API request to your endpoint. In this guide, you'll create an endpoint, copy its provider URL, and make your first request. Code samples are available in cURL as well as popular SDKs and programming languages.

Get Your Aleo Endpoint

1

Create a Quicknode account

Sign up here if you haven't already.

2

Go to your dashboard

Open the Endpoints dashboard from the left sidebar menu to manage all your blockchain endpoints

3

Een nieuw eindpunt aanmaken

Click Create an Endpoint in the top-right corner, select Aleo as your blockchain, then select your preferred network

4

Copy your provider URLs

Keep the HTTP URL handy. You'll use it in your requests below.

Learn More about the Dashboard

For a detailed walkthrough of the Quicknode dashboard, check out our guide

Dien je eerste aanvraag in

Your endpoint is ready. Now, let's make your first call to the Aleo blockchain. We'll use the /block/height/latest endpoint, which returns the latest block height. Select your preferred language or SDK and follow the steps below to send your first request.

cURL

1

Check cURL installation

Most *nix based systems have cURL support out of the box. Open your terminal and check the cURL version by running the command below:

curl --version

2

Send a REST API request

In your terminal, copy and paste the following cURL command to retrieve the latest block height:

curl -X GET YOUR_QUICKNODE_ENDPOINT_URL/v2/mainnet/block/height/latest \
-H 'Accept: application/json'

3

Sample Response

17473599

Node.js

1

Set up your project

First, verify Node.js is installed with node --version. If not installed, download it from https://nodejs.org. Then create a new directory and initialize a Node.js project:

mkdir aleo-api-quickstart
cd aleo-api-quickstart
npm init -y

2

Create your main file

Create an index.js file for your code:

touch index.js

3

Add this code to your index.js file

Copy and paste this code into your index.js file to get the latest block height:

const https = require('https');

const options = {
  hostname: '{your-endpoint-name}.quiknode.pro',
  path: '/{your-token}/v2/mainnet/block/height/latest',
  method: 'GET',
  headers: {
    'Accept': 'application/json'
  }
};

const req = https.request(options, (res) => {
  let result = '';
  res.on('data', (chunk) => {
    result += chunk;
  });
  res.on('end', () => {
    console.log('Latest block height:', result);
  });
});

req.on('error', (error) => {
  console.error('Error:', error);
});

req.end();

4

Run your code

Save the file and run it in your terminal:

node index.js

Python

1

Check Python installation

Verify Python is installed on your system. Open your terminal and run:

python --version

2

Install required packages

Install the requests library if you haven't already:

pip install requests

3

Create your Python script

Create a new Python file and add the following code to get the latest block height:

import requests

url = "YOUR_QUICKNODE_ENDPOINT_URL/v2/mainnet/block/height/latest"

headers = {
  'Accept': 'application/json'
}

response = requests.request("GET", url, headers=headers)

print("Latest block height:", response.text)

4

Run your script

Save the file as aleo_block_height.py and run it:

python aleo_block_height.py

Ruby

1

Check Ruby installation

Verify Ruby is installed on your system. Open your terminal and run:

ruby --version

2

Create your Ruby script

Create a new Ruby file and add the following code to get the latest block height:

require 'net/http'
require 'json'

uri = URI('YOUR_QUICKNODE_ENDPOINT_URL/v2/mainnet/block/height/latest')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

request = Net::HTTP::Get.new(uri)
request['Accept'] = 'application/json'

response = http.request(request)
puts "Latest block height: #{response.body}"

3

Run your script

Save the file as aleo_block_height.rb and run it:

ruby aleo_block_height.rb

If you want to continue learning about making API requests, check out our guides and sample apps.

Overzicht van de API

Discover Supported Aleo APIs, Networks, Chain Configurations, and compatible Quicknode Products

Eindpunten van providers

Learn how to set up and configure your Aleo RPC endpoints for development and production use

Beveiliging van eindpunten

Secure your endpoints with Token Authentication, Rate-limiting, Whitelisting, JWT and best security practices

Error Reference

Reference document for common Aleo RPC error codes and troubleshooting tips

Marktplaats-uitbreidingen

Discover powerful add-ons and extensions to enhance your Aleo development workflow

We ❤️ feedback!

Mocht je opmerkingen of vragen hebben over deze documentatie, laat het ons dan weten. We horen graag van je!