The quickest way to start building on Ton 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 Ton Endpoint
Créer un Quicknode
Inscrivez-vous ici si ce n'est pas déjà fait.
Accédez à votre tableau de bord
Ouvrez le tableau de bord « Endpoints » dans le menu de la barre latérale gauche pour gérer tous vos points de terminaison blockchain.
Créer un nouveau endpoint
Click Create an Endpoint in the top-right corner, select Ton as your blockchain, then select your preferred network
Copiez les URL de vos fournisseurs
Gardez l'URL HTTP à portée de main. Vous en aurez besoin dans les requêtes ci-dessous.
Pour découvrir en détail le Quicknode , consultez notre guide
Envoyez votre première demande
Your endpoint is ready. Now, let's make your first call to the Ton blockchain. We'll use the getMasterchainInfo method, which retrieves masterchain information. 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 dès leur installation. Ouvrez votre terminal et vérifiez la version de cURL en exécutant la commande ci-dessous :
curl --version
Send a GET request
In your terminal, copy and paste the following cURL command to retrieve the masterchain information:
curl --location 'YOUR_QUICKNODE_ENDPOINT_URL/getMasterchainInfo' \
--header 'accept: application/json'
Exemple de réponse
{
"ok": true,
"result": {
"workchain": -1,
"shard": -9223372036854775808,
"seqno": 12345678,
"root_hash": "abc123...",
"file_hash": "def456..."
}
}
Configurez votre projet
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 ton-api-quickstart
cd ton-api-quickstart
npm init -y
Create your script
Create a new file called index.js and add the following code to retrieve the masterchain information:
const https = require('https');
const options = {
hostname: '{your-endpoint-name}.quiknode.pro',
path: '/{your-token}/getMasterchainInfo',
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(result);
});
});
req.on('error', (error) => {
console.error('Error:', error);
});
req.end();
Run your script
Execute your script in the terminal to retrieve the masterchain information:
node index.js
Configurez votre projet
First, verify Python is installed with python --version or python3 --version. Then create a new directory for your project:
mkdir ton-api-quickstart
cd ton-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
Install dependencies
Installez la bibliothèque « requests » pour effectuer des requêtes HTTP :
pip installer requests
Create your script
Create a new file called main.py and add the following code to retrieve the masterchain information:
import requests
url = "YOUR_QUICKNODE_ENDPOINT_URL/getMasterchainInfo"
headers = {
'accept': 'application/json'
}
response = requests.request("GET", url, headers=headers)
print(response.text)
Run your script
Execute your script in the terminal to retrieve the masterchain information:
python main.py
Configurez votre projet
First, create a new directory for your project:
mkdir ton-api-quickstart
cd ton-api-quickstart
Vérifier l'installation de Ruby
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
Create your script
Create a new file called main.rb and add the following code to retrieve the masterchain information:
require "uri"
require "net/http"
url = URI("YOUR_QUICKNODE_ENDPOINT_URL/getMasterchainInfo")
https = Net::HTTP.new(url.host, url.port)
https.use_ssl = true
request = Net::HTTP::Get.new(url)
request["accept"] = "application/json"
response = https.request(request)
puts response.read_body
Run your script
Execute your script in the terminal to retrieve the masterchain information:
ruby main.rb
If you want to continue learning about making API requests, check out our guides and sample apps.