The quickest way to start building on Cosmos with Quicknode is by sending a JSON-RPC or REST/gRPC 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 popular SDKs and programming languages.
Get Your Cosmos Endpoint
Criar uma Quicknode
Inscreve-te aqui, se ainda não o fizeste.
Aceda ao seu painel de controlo
Open the Endpoints dashboard from the left sidebar menu to manage all your blockchain endpoints
Criar um novo endpoint
Click Create an Endpoint in the top-right corner, select Cosmos as your blockchain, then select your preferred network
Copie os URLs do seu fornecedor
Tenha a URL HTTP à mão. Vai precisar dela nas solicitações que se seguem.
Para um guia detalhado do Quicknode do Quicknode , consulte o nosso guia
Envie o seu primeiro pedido
Your endpoint is ready. Now, let's make your first call to the Cosmos blockchain. We’ll use the block_by_hash method, which returns details of a specificed block when given a hash parameter. Select your preferred language or tool and follow the steps to send your request.
- cURL
- Node.js
Python- Ruby
Verificar a instalação do cURL
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 --versão
Query block by hash
Retrieve block information by hash from your Quicknode endpoint:
curl --location '<YOUR_QUICKNODE_ENDPOINT_URL>/block_by_hash?hash=0x645507DC48B4EF4BFF51826A0A5B73FD8CF926036AA4F6697D748FFC0B56D134'
Sample response
{
"jsonrpc": "2.0",
"id": -1,
"result": {
"block_id": { ... }
},
"block": {
"header": {
"version": {
"block": "11"
},
"chain_id": "cosmoshub-4",
"height": "20431644",
"time": "2024-05-15T01:23:57.786705041Z",
"last_block_id": { ... },
},
"data": {
"txs": [ ... ]
},
"evidence": {
"evidence": []
},
"last_commit": { ... }
}
}
}
Configure o seu projeto
Crie um diretório e inicialize um projeto Node.js:
mkdir cosmos-js-quickstart
cd cosmos-js-quickstart
npm init -y
Criar o ficheiro app.js
Use native fetch (Node.js 18+):
const requestOptions = { method: 'GET', redirect: 'follow' };
async function main() {
try {
const url = '<YOUR_QUICKNODE_ENDPOINT_URL>/block_by_hash?hash=0x645507DC48B4EF4BFF51826A0A5B73FD8CF926036AA4F6697D748FFC0B56D134';
const res = await fetch(url, requestOptions);
const text = await res.text();
console.log('Block information:', text);
} catch (err) {
console.error('Error:', err);
}
};
}
main();
Correr
Execute o seu script:
node app.js
Configure o seu projeto
Crie um novo diretório para o seu projeto em Python:
mkdir cosmos-python-quickstart
cd cosmos-python-quickstart
Criar e ativar um ambiente virtual
Criar um ambiente virtual para gerir dependências:
python3 -m venv venv
source venv/bin/activate
Pedidos de instalação
Instale a biblioteca `requests` para efetuar pedidos HTTP:
pip instalar requests
Crie um script em Python (app.py)
Create a Python file with the following code:
import requests
url = '<YOUR_QUICKNODE_ENDPOINT_URL>/block_by_hash?hash=0x645507DC48B4EF4BFF51826A0A5B73FD8CF926036AA4F6697D748FFC0B56D134'
resp = requests.get(url)
print('Block information:')
print(resp.text)
Executar o script
Execute your Python script:
python app.py
Configure o seu projeto
Crie um novo diretório para o seu projeto Ruby:
mkdir cosmos-ruby-quickstart
cd cosmos-ruby-quickstart
Check Ruby Installation
Verifique se o Ruby está instalado no seu sistema. Caso contrário, instale-o a partir de https://ruby-lang.org:
ruby --versão
Create a Ruby script (main.rb)
Create a main.rb file with the following code:
require 'uri'
require 'net/http'
url = URI('<YOUR_QUICKNODE_ENDPOINT_URL>/block_by_hash?hash=0x645507DC48B4EF4BFF51826A0A5B73FD8CF926036AA4F6697D748FFC0B56D134')
https = Net::HTTP.new(url.host, url.port)
https.use_ssl = true
req = Net::HTTP::Get.new(url)
res = https.request(req)
puts 'Block information:'
puts res.body
Executar o script
Execute your Ruby script to retrieve block information:
ruby main.rb
If you want to continue learning about making API requests, check out our guides and sample apps.