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

创建一个 Quicknode 账户

如果您尚未注册，请在此注册。

2

前往您的仪表盘

从左侧边栏菜单中打开“端点”仪表板，以管理您所有的区块链端点

3

创建一个新的端点

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

4

复制您的服务商 URL

请将该 HTTP URL 备好。您将在下文的请求中用到它。

了解有关仪表板的更多信息

如需了解 Quicknode 仪表盘的详细操作指南，请参阅我们的 指南

发送您的第一个请求

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

检查 cURL 的安装情况

大多数基于 *nix 的系统默认都支持 cURL。打开终端，运行以下命令检查 cURL 的版本：

curl --version

2

发送一个 JSON-RPC 请求

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

示例回答

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

Node.js

1

设置您的项目

首先，使用 `node --version` 命令验证 Node.js 是否已安装。如果尚未安装，请从 https://nodejs.org 下载。然后创建一个新目录并初始化一个 Node.js 项目：

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

设置您的项目

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

创建并激活虚拟环境

创建一个虚拟环境来管理依赖项：

python3 -m venv venv
source venv/bin/activate

3

Install dependencies

安装 requests 库以进行 HTTP 请求：

pip 安装 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

设置您的项目

First, create a new directory for your project:

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

2

检查 Ruby 安装情况

请确认您的系统上已安装 Ruby。如果尚未安装，请从 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

如果您想进一步了解如何发送 API 请求，请查看我们的指南和示例应用。

API 概述

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

提供商端点

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

终端安全

通过令牌认证、速率限制、白名单、JWT 以及最佳安全实践来保护您的终端

Marketplace 扩展程序

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

我们 ❤️ 您的反馈！

如果您对本文档有任何反馈或疑问，请告诉我们。我们非常期待您的反馈！