# Post RPC Http

Forwards a JSON-RPC request to the selected Bittensor node and returns its response.

_Source: https://beta.taostats.io/docs/api-reference/rpc-live/post-rpc-http_

_Last reviewed: 2026-09-18_

```http
POST https://api.taostats.io/api/v1/rpc/http
```

Requires an API key in the `Authorization` header.

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

**cURL**

```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"
```

**JavaScript**

```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**

```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](https://beta.taostats.io/docs/start-here/getting-started-with-taostats-api).