Scroll to navigation



bitcoin-cli - send command to Bitcoin Core


bitcoin-cli [options] <command> [params] Send command to Bitcoin Core
bitcoin-cli [options] -named <command> [name=value]... Send command to Bitcoin Core (with named arguments)
bitcoin-cli [options] help List commands
bitcoin-cli [options] help <command> Get help for a command


Send command to Bitcoin Core



Print this help message and exit


Specify configuration file. Relative paths will be prefixed by datadir location. (default: bitcoin.conf)


Specify data directory


Get general information from the remote server. Note that unlike server-side RPC calls, the results of -getinfo is the result of multiple non-atomic requests. Some entries in the result may represent results from different states (e.g. wallet balance may be as of a different block from the chain state reported)


Pass named instead of positional arguments (default: false)


Timeout in seconds during HTTP requests, or 0 for no timeout. (default: 900)


Send commands to node running on <ip> (default:


Location of the auth cookie. Relative paths will be prefixed by a net-specific datadir location. (default: data dir)


Password for JSON-RPC connections


Connect to JSON-RPC on <port> (default: 8332, testnet: 18332, regtest: 18443)


Username for JSON-RPC connections


Wait for RPC server to start


Send RPC for non-default wallet on RPC server (needs to exactly match corresponding -wallet option passed to bitcoind). This changes the RPC endpoint used, e.g.<walletname>


Read extra arguments from standard input, one per line until EOF/Ctrl-D (recommended for sensitive information such as passphrases). When combined with -stdinrpcpass, the first line from standard input is used for the RPC password.


Read RPC password from standard input as a single line. When combined with -stdin, the first line from standard input is used for the RPC password.


Print version and exit

Chain selection options:


Use the test chain


Copyright (C) 2009-2019 The Bitcoin Core developers

Please contribute if you find Bitcoin Core useful. Visit <> for further information about the software. The source code is available from <>.

This is experimental software. Distributed under the MIT software license, see the accompanying file COPYING or <>

This product includes software developed by the OpenSSL Project for use in the OpenSSL Toolkit <> and cryptographic software written by Eric Young and UPnP software written by Thomas Bernard.

March 2019 bitcoin-cli v0.18.0.0