The quickest way to start building on Stellar with Quicknode is by sending a JSON-RPC request to your endpoint. In this quickstart, you'll create an endpoint, copy its provider URL, and make your first request. Code samples are available in cURL as well as other popular programming languages.

Get Your Stellar 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

Create a new endpoint

Click Create an Endpoint in the top-right corner, select Stellar 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

Send Your First Request

Your endpoint is ready. Now, let's make your first call to the Stellar network. We'll use the getLatestLedger method, which retrieves information about the latest ledger on the network. Select your preferred language 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 JSON-RPC request

In your terminal, copy and paste the following cURL command to retrieve the latest ledger information:

curl --location 'YOUR_QUICKNODE_ENDPOINT_URL/' \
--header 'Content-Type: application/json' \
--data '{
    "jsonrpc": "2.0",
    "id": 8675309,
    "method": "getLatestLedger"
}'

3

Sample Response

{
  "jsonrpc": "2.0",
  "id": 8675309,
  "result": {
    "sequence": 12345678,
    "hash": "abc123...",
    "prevHash": "def456...",
    "transactionCount": 42,
    "operationCount": 128
  }
}

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 stellar-api-quickstart
cd stellar-api-quickstart
npm init -y

2

Create your script

Create a new file called index.js and add the following code to retrieve the latest ledger information:

const https = require('https');

const data = JSON.stringify({
  "jsonrpc": "2.0",
  "id": 8675309,
  "method": "getLatestLedger"
});

const options = {
  hostname: '{your-endpoint-name}.quiknode.pro',
  path: '/{your-token}/',
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Content-Length': data.length
  }
};

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

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

req.write(data);
req.end();

3

Run your script

Execute your script in the terminal to retrieve the latest ledger information:

node index.js

Python

1

Set up your project

First, verify Python is installed with python --version or python3 --version. Then create a new directory for your project:

mkdir stellar-api-quickstart
cd stellar-api-quickstart

2

Create and activate a virtual environment

Create a virtual environment to manage dependencies:

python3 -m venv venv
source venv/bin/activate

3

Install dependencies

Install the requests library for making HTTP requests:

pip install requests

4

Create your script

Create a new file called main.py and add the following code to retrieve the latest ledger information:

import requests
import json

url = "YOUR_QUICKNODE_ENDPOINT_URL/"

payload = json.dumps({
  "jsonrpc": "2.0",
  "id": 8675309,
  "method": "getLatestLedger"
})

headers = {
  'Content-Type': 'application/json'
}

response = requests.request("POST", url, headers=headers, data=payload)

print(response.text)

5

Run your script

Execute your script in the terminal to retrieve the latest ledger information:

python main.py

Ruby

1

Set up your project

First, create a new directory for your project:

mkdir stellar-api-quickstart
cd stellar-api-quickstart

2

Check Ruby installation

Verify Ruby is installed on your system. If not, install it from https://ruby-lang.org:

ruby --version

3

Create your script

Create a new file called main.rb and add the following code to retrieve the latest ledger information:

require "uri"
require "json"
require "net/http"

url = URI("YOUR_QUICKNODE_ENDPOINT_URL/")

https = Net::HTTP.new(url.host, url.port)
https.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Content-Type"] = "application/json"
request.body = JSON.dump({
  "jsonrpc": "2.0",
  "id": 8675309,
  "method": "getLatestLedger"
})

response = https.request(request)
puts response.read_body

4

Run your script

Execute your script in the terminal to retrieve the latest ledger information:

ruby main.rb

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

API Overview

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

Provider Endpoints

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

Endpoint Security

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

Marketplace Add-ons

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

We ❤️ Feedback!

If you have any feedback or questions about this documentation, let us know. We'd love to hear from you!