Documentation / New API reference / RPC
Post RPC Http
Reference
Last reviewed 2026-10-07
Forward a JSON-RPC 2.0 request (object or batch array) to the default finney_lite node and relay its response. A WebSocket variant exists at WS /v1/rpc/ws/{target} (targets: finney_lite, finney_archive) — it is not listed as its own OpenAPI path because OpenAPI 3 cannot describe WebSocket upgrades.
Code samples
bash
curl -X POST \
-H "Authorization: <YOUR_API_KEY>" \
-H "Content-Type: application/json" \
-d '{}' \
"https://api.taostats.io/v1/rpc/http"js
const response = await fetch('https://api.taostats.io/v1/rpc/http', {
method: 'POST',
headers: {
Authorization: '<YOUR_API_KEY>',
'Content-Type': 'application/json',
},
body: JSON.stringify({}),
});
const data = await response.json();python
import requests
response = requests.post(
"https://api.taostats.io/v1/rpc/http",
headers={"Authorization": "<YOUR_API_KEY>"},
json={},
)
data = response.json()Parameters
No parameters.
Request body
A JSON-RPC 2.0 request object or batch array
No documented fields.
json
{}Responses
200 — The upstream node's JSON-RPC response
Returns application/json — a object body.
400 — Body is not valid JSON or not a JSON-RPC request object or array
| Field | Type | Required | Description |
|---|---|---|---|
message | string | Yes | Plain-english message describing the failure from the caller's perspective. |
status_code | integer (int32) | Yes | HTTP status code (mirrored in the response status line for convenience). |
413 — Request body exceeds the size limit
| Field | Type | Required | Description |
|---|---|---|---|
message | string | Yes | Plain-english message describing the failure from the caller's perspective. |
status_code | integer (int32) | Yes | HTTP status code (mirrored in the response status line for convenience). |
415 — Content type is not application/json
| Field | Type | Required | Description |
|---|---|---|---|
message | string | Yes | Plain-english message describing the failure from the caller's perspective. |
status_code | integer (int32) | Yes | HTTP status code (mirrored in the response status line for convenience). |
500 — Upstream node unreachable or returned a non-JSON body
| Field | Type | Required | Description |
|---|---|---|---|
message | string | Yes | Plain-english message describing the failure from the caller's perspective. |
status_code | integer (int32) | Yes | HTTP status code (mirrored in the response status line for convenience). |
Every request needs an Authorization header holding your API key — see Getting started with the Taostats API.