Documentation / API reference / RPC Live
Post RPC Http
Reference
Last reviewed 2026-09-18
Forwards a JSON-RPC request to the selected Bittensor node and returns its response. The JSON body contains target (finney_lite or finney_archive) and a request with the JSON-RPC method, ID and parameters.
Code samples
bash
curl -X POST \
-H "Authorization: <YOUR_API_KEY>" \
-H "Content-Type: application/json" \
-d '{
"request": {
"id": {},
"jsonrpc": "string",
"method": "string"
},
"target": "finney_lite"
}' \
"https://api.taostats.io/api/v1/rpc/http"js
const response = await fetch('https://api.taostats.io/api/v1/rpc/http', {
method: 'POST',
headers: {
Authorization: '<YOUR_API_KEY>',
'Content-Type': 'application/json',
},
body: JSON.stringify({
"request": {
"id": {},
"jsonrpc": "string",
"method": "string"
},
"target": "finney_lite"
}),
});
const data = await response.json();python
import requests
response = requests.post(
"https://api.taostats.io/api/v1/rpc/http",
headers={"Authorization": "<YOUR_API_KEY>"},
json={
"request": {
"id": {},
"jsonrpc": "string",
"method": "string"
},
"target": "finney_lite"
},
)
data = response.json()Parameters
No parameters.
Request body
| Field | Type | Required | Description |
|---|---|---|---|
request | object | Yes | |
request.id | object | Yes | |
request.jsonrpc | string | Yes | |
request.method | string | Yes | |
request.params | object, nullable | ||
target | string | Yes | One of finney_lite, finney_archive. |
json
{
"request": {
"id": {},
"jsonrpc": "string",
"method": "string"
},
"target": "finney_lite"
}Responses
200 — Response
| Field | Type | Required | Description |
|---|---|---|---|
response | object | Yes | |
response.error | object, nullable | ||
response.id | object | Yes | |
response.jsonrpc | string | Yes | |
response.result | object, nullable | ||
target | string | Yes | One of finney_lite, finney_archive. |
Every request needs an Authorization header holding your API key — see Getting started with the Taostats API.