getdifficulty

curl --request POST \
  --url https://nd-202-842-353.p2pify.com/788f110831fe13808302bd79796d55e8 \
  --header 'Content-Type: application/json' \
  --data '
{
  "jsonrpc": "1.0",
  "method": "getdifficulty",
  "params": "<unknown>",
  "id": 1
}
'

import requests

url = "https://nd-202-842-353.p2pify.com/788f110831fe13808302bd79796d55e8"

payload = {
    "jsonrpc": "1.0",
    "method": "getdifficulty",
    "params": "<unknown>",
    "id": 1
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({jsonrpc: '1.0', method: 'getdifficulty', params: '<unknown>', id: 1})
};

fetch('https://nd-202-842-353.p2pify.com/788f110831fe13808302bd79796d55e8', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://nd-202-842-353.p2pify.com/788f110831fe13808302bd79796d55e8",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'jsonrpc' => '1.0',
    'method' => 'getdifficulty',
    'params' => '<unknown>',
    'id' => 1
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://nd-202-842-353.p2pify.com/788f110831fe13808302bd79796d55e8"

	payload := strings.NewReader("{\n  \"jsonrpc\": \"1.0\",\n  \"method\": \"getdifficulty\",\n  \"params\": \"<unknown>\",\n  \"id\": 1\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://nd-202-842-353.p2pify.com/788f110831fe13808302bd79796d55e8")
  .header("Content-Type", "application/json")
  .body("{\n  \"jsonrpc\": \"1.0\",\n  \"method\": \"getdifficulty\",\n  \"params\": \"<unknown>\",\n  \"id\": 1\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://nd-202-842-353.p2pify.com/788f110831fe13808302bd79796d55e8")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"jsonrpc\": \"1.0\",\n  \"method\": \"getdifficulty\",\n  \"params\": \"<unknown>\",\n  \"id\": 1\n}"

response = http.request(request)
puts response.read_body

{
  "result": 123,
  "error": {},
  "id": 123
}

POST

788f110831fe13808302bd79796d55e8

getdifficulty

curl --request POST \
  --url https://nd-202-842-353.p2pify.com/788f110831fe13808302bd79796d55e8 \
  --header 'Content-Type: application/json' \
  --data '
{
  "jsonrpc": "1.0",
  "method": "getdifficulty",
  "params": "<unknown>",
  "id": 1
}
'

import requests

url = "https://nd-202-842-353.p2pify.com/788f110831fe13808302bd79796d55e8"

payload = {
    "jsonrpc": "1.0",
    "method": "getdifficulty",
    "params": "<unknown>",
    "id": 1
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({jsonrpc: '1.0', method: 'getdifficulty', params: '<unknown>', id: 1})
};

fetch('https://nd-202-842-353.p2pify.com/788f110831fe13808302bd79796d55e8', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://nd-202-842-353.p2pify.com/788f110831fe13808302bd79796d55e8",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'jsonrpc' => '1.0',
    'method' => 'getdifficulty',
    'params' => '<unknown>',
    'id' => 1
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://nd-202-842-353.p2pify.com/788f110831fe13808302bd79796d55e8"

	payload := strings.NewReader("{\n  \"jsonrpc\": \"1.0\",\n  \"method\": \"getdifficulty\",\n  \"params\": \"<unknown>\",\n  \"id\": 1\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://nd-202-842-353.p2pify.com/788f110831fe13808302bd79796d55e8")
  .header("Content-Type", "application/json")
  .body("{\n  \"jsonrpc\": \"1.0\",\n  \"method\": \"getdifficulty\",\n  \"params\": \"<unknown>\",\n  \"id\": 1\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://nd-202-842-353.p2pify.com/788f110831fe13808302bd79796d55e8")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"jsonrpc\": \"1.0\",\n  \"method\": \"getdifficulty\",\n  \"params\": \"<unknown>\",\n  \"id\": 1\n}"

response = http.request(request)
puts response.read_body

{
  "result": 123,
  "error": {},
  "id": 123
}

The getdifficulty method retrieves the current network difficulty, which is a measure of how difficult it is to find a new block on the blockchain.

Get your own node endpoint todayStart for free and get your app to production levels immediately. No credit card required.You can sign up with your GitHub, X, Google, or Microsoft account.

Parameters

None

Response

result — a number representing the current network difficulty.
error — an object containing an error message if an error occurred, otherwise null.
id — an integer representing the ID of the request, used to match requests with responses.

Use case

The getdifficulty method is commonly used to monitor the network’s mining difficulty level. Miners and network participants can use this information to gauge the competitiveness of mining on the network.

Body

application/json

jsonrpc

string

default:1.0

method

string

default:getdifficulty

params

any

integer

default:1

Response

200 - application/json

The current network difficulty

result

number

The current network difficulty as a number

error

object

integer

Last modified on June 22, 2026

APIs introduction

Node APIs

Faucet API

Chainstack platform API

getdifficulty | Bitcoin

Parameters

Response

Use case

Body

Response

​Parameters

​Response

​Use case

Body

Response

Parameters

Response

Use case