---
title: "Proxy RPC call to the underlying node"
method: POST
path: "/v1/cryptos/{cryptoCode}/rpc"
tags: ["Blockchain"]
---

# Proxy RPC call to the underlying node

`POST /v1/cryptos/{cryptoCode}/rpc`

## Request

- Base URL: `/` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `/v1/cryptos/{cryptoCode}/rpc`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/btcpayserver/apis/nbxplorer-api/docs/v1/cryptos/:cryptoCode/rpc/post.ts> (a function with typed inputs; its response is checked against the schema)

Allows you to make RPC calls to the underlying cryptocurrency node (e.g., Bitcoin Core) via NBXplorer. This endpoint acts as a proxy, forwarding your RPC requests to the node and returning the node's responses.

By default, only a handful of RPC methods are authorized. You can use [configuration](https://github.com/btcpayserver/NBXplorer/blob/master/docs/Operator.md#configuration) `--btcexposerpc` or `NBXPLORER_BTCEXPOSERPC=1` to allow all methods.

Go to [The JSON-RPC specification page](https://www.jsonrpc.org/specification) and the [Bitcoin Core RPC page](https://developer.bitcoin.org/reference/rpc) for more information.

## Path parameters

- `cryptoCode` string, required

## Request body

- union
  - RpcRequest
    - `jsonrpc` string: JSON-RPC protocol version.
    - `id` union: An identifier established by the client.
      - string, nullable
      - integer
    - `method` string, required: The name of the RPC method to invoke.
    - `params` unknown[]: An array of parameters to pass to the RPC method.
      - unknown
  - RpcRequest[]
    - `jsonrpc` string: JSON-RPC protocol version.
    - `id` union: An identifier established by the client.
      - string, nullable
      - integer
    - `method` string, required: The name of the RPC method to invoke.
    - `params` unknown[]: An array of parameters to pass to the RPC method.
      - unknown

## Response `200`

RPC result or node RPC error. Node errors are returned with HTTP 200.

- union
  - union
    - object
      - `result` unknown, required
    - object
      - `error` object, required: Error information returned by the node.
        - `code` integer, required: Error code.
        - `message` string, required: Error message.
  - RpcResponse[]
    - union
      - object
        - `result` unknown, required
      - object
        - `error` object, required: Error information returned by the node.
          - `code` integer, required: Error code.
          - `message` string, required: Error message.

## Other responses

- `400`: The node RPC interface is currently unavailable.
- `401`: JSON RPC is not exposed and the requested method is not whitelisted.
- `422`: The request body does not contain a JSON-RPC request.

## Changes

- **2026-09-29** `52231f42c765`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/btcpayserver/apis/nbxplorer-api/changes/v1/cryptos/:cryptoCode/rpc/post.md)

---

[API](https://skmtc.dev/btcpayserver/apis/nbxplorer-api.md) - [All operations](https://skmtc.dev/btcpayserver/apis/nbxplorer-api/llms.txt) - [OpenAPI document](https://skmtc.dev/btcpayserver/apis/nbxplorer-api/revisions/52231f42c765?raw)