{% comment %}
This file is licensed under the MIT License (MIT) available on
http://opensource.org/licenses/MIT.
{% endcomment %}
{% assign filename="_includes/ref/bitcoin-core/rpcs/rpcs/getdifficulty.md" %}

##### GetDifficulty
{% include helpers/subhead-links.md %}

{% assign summary_getDifficultly="returns the proof-of-work difficulty as a multiple of the minimum difficulty." %}

{% autocrossref %}

The `getdifficulty` RPC {{summary_getDifficulty}}

*Parameters: none*

*Result---the current difficulty*

| Name             | Type              | Presence                    | Description
|------------------|-------------------|-----------------------------|----------------
| `result`         | number (real)     | Required<br>(exactly 1)     | The difficulty of creating a block with the same target threshold (nBits) as the highest-height block in the local best block chain.  The number is a a multiple of the minimum difficulty
{:.ntpd}

*Example from Bitcoin Core 0.10.0*

{% highlight bash %}
bitcoin-cli -testnet getdifficulty
{% endhighlight %}

Result:

{% highlight text %}
1.00000000
{% endhighlight %}

*See also*

* [GetNetworkHashPS][rpc getnetworkhashps]: {{summary_getNetworkHashPS}}
* [GetMiningInfo][rpc getmininginfo]: {{summary_getMiningInfo}}

{% endautocrossref %}
