The quickest way to start building on XRPL 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 XRPL Endpoint
Créez un compte Quicknode
Inscrivez-vous ici si ce n'est pas déjà fait.
Accédez à votre tableau de bord
Ouvrez le tableau de bord des endpoints depuis le menu latéral gauche pour gérer tous vos endpoints blockchain
Créez un nouvel endpoint
Click Create an Endpoint in the top-right corner, select XRPL as your blockchain, then select your preferred network
Copiez vos URL de fournisseur
Gardez l'URL HTTP à portée de main. Vous l'utiliserez dans vos requêtes ci-dessous.
Pour une présentation détaillée du tableau de bord Quicknode, consultez notre guide
Envoyer votre première requête
Your endpoint is ready. Now, let's make your first call to the XRPL blockchain. We'll use the frais method, which retrieves current fee information from the network. Select your preferred language and follow the steps below to send your first request.
- cURL
- Node.js
Python- Ruby
Vérifier l'installation de cURL
La plupart des systèmes basés sur *nix prennent en charge cURL nativement. Ouvrez votre terminal et vérifiez la version de cURL en exécutant la commande ci-dessous :
curl --version
Envoyer une requête JSON-RPC
In your terminal, copy and paste the following cURL command to retrieve current fee information:
curl YOUR_QUICKNODE_ENDPOINT_URL/ \
-X POST \
-H "Content-Type: application/json" \
--data '{
"method": "fee",
"params": [{}],
"id": 1,
"jsonrpc": "2.0"
}'
Exemple de réponse
{
"id": 1,
"status": "success",
"type": "response",
"result": {
"current_ledger_size": "56",
"current_queue_size": "0",
"drops": {
"base_fee": "10",
"median_fee": "5000",
"minimum_fee": "10",
"open_ledger_fee": "10"
},
"expected_ledger_size": "55",
"ledger_current_index": 75708765,
"levels": {
"median_level": "128000",
"minimum_level": "256",
"open_ledger_level": "256",
"reference_level": "256"
},
"max_queue_size": "1100"
}
}
Configurer votre projet
Tout d'abord, vérifiez que Node.js est installé avec la commande node --version. S'il n'est pas installé, téléchargez-le depuis https://nodejs.org. Ensuite, créez un nouveau répertoire et initialisez un projet Node.js :
mkdir xrpl-api-quickstart
cd xrpl-api-quickstart
npm init -y
Créer votre fichier principal
Créez un fichier index.js pour votre code :
touch index.js
Ajoutez ce code à votre fichier index.js
Copiez et collez ce code dans votre fichier index.js :
const https = require('https');
const data = JSON.stringify({
method: "fee",
params: [{}],
id: 1,
jsonrpc: "2.0"
});
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 responseData = '';
res.on('data', (chunk) => {
responseData += chunk;
});
res.on('end', () => {
console.log('XRPL Fee Information:');
console.log(JSON.stringify(JSON.parse(responseData), null, 2));
});
});
req.on('error', (error) => {
console.error('Error:', error);
});
req.write(data);
req.end();
Exécutez le script
Execute your Node.js script to retrieve fee information:
node index.js
Configurer votre projet
Create a new directory for your project:
mkdir xrpl-api-quickstart
cd xrpl-api-quickstart
Créer et activer un environnement virtuel
Créer un environnement virtuel pour gérer les dépendances :
python3 -m venv venv
source venv/bin/activate
Installer les paquets requis
Install the requests library:
pip install requests
Créez un script Python (main.py)
Créez un fichier main.py contenant le code suivant :
import requests
import json
url = "YOUR_QUICKNODE_ENDPOINT_URL/"
payload = {
"method": "fee",
"params": [{}],
"id": 1,
"jsonrpc": "2.0"
}
headers = {
'Content-Type': 'application/json'
}
try:
response = requests.post(url, json=payload, headers=headers)
response.raise_for_status()
data = response.json()
print("XRPL Fee Information:")
print(json.dumps(data, indent=2))
except requests.exceptions.RequestException as e:
print(f"Error making request: {e}")
except json.JSONDecodeError as e:
print(f"Error parsing JSON: {e}")
Exécutez le script
Execute your Python script to retrieve fee information:
python main.py
Configurer votre projet
Créez un nouveau répertoire pour votre projet Ruby :
mkdir xrpl-ruby-quickstart
cd xrpl-ruby-quickstart
Check Ruby Installation
Vérifiez que Ruby est bien installé sur votre système. Si ce n'est pas le cas, installez-le à partir du site https://ruby-lang.org :
ruby --version
Créer un script Ruby (main.rb)
Créez un fichier main.rb contenant le code suivant :
require 'uri'
require 'net/http'
require 'json'
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 = {
method: "fee",
params: [{}],
id: 1,
jsonrpc: "2.0"
}.to_json
begin
response = https.request(request)
if response.is_a?(Net::HTTPSuccess)
data = JSON.parse(response.body)
puts 'XRPL Fee Information:'
puts JSON.pretty_generate(data)
else
puts "HTTP Error: #{response.code} - #{response.message}"
end
rescue JSON::ParserError => e
puts "JSON parsing error: #{e.message}"
rescue => e
puts "Error: #{e.message}"
end
Exécutez le script
Execute your Ruby script to retrieve fee information:
ruby main.rb
Si vous souhaitez en savoir plus sur la création de requêtes API, consultez nos guides et nos exemples d'applications.
Nous ❤️ les commentaires !
Si vous avez des commentaires ou des questions concernant cette documentation, faites-le nous savoir. Nous serions ravis de vous entendre !