.. This file is licensed under the MIT License (MIT) available on
   http://opensource.org/licenses/MIT.

createrawtransaction
====================

``createrawtransaction [{"txid":"hex","vout":n,"sequence":n},...] [{"address":amount},{"data":"hex"},...] ( locktime replaceable )``

Create a transaction spending the given inputs and creating new outputs.

Outputs can be addresses or data.

Returns hex-encoded raw transaction.

Note that the transaction's inputs are not signed, and
it is not stored in the wallet or transmitted to the network.

Argument #1 - inputs
~~~~~~~~~~~~~~~~~~~~

**Type:** json array, required

A json array of json objects

::

     [
       {                       (json object)
         "txid": "hex",        (string, required) The transaction id
         "vout": n,            (numeric, required) The output number
         "sequence": n,        (numeric, optional, default=depends on the value of the 'replaceable' and 'locktime' arguments) The sequence number
       },
       ...
     ]

Argument #2 - outputs
~~~~~~~~~~~~~~~~~~~~~

**Type:** json array, required

a json array with outputs (key-value pairs), where none of the keys are duplicated.
       That is, each address can only appear once and there can only be one 'data' object.
       For compatibility reasons, a dictionary, which holds the key-value pairs directly, is also
       accepted as second parameter.

::

     [
       {                       (json object)
         "address": amount,    (numeric or string, required) A key-value pair. The key (string) is the bitcoin address, the value (float or string) is the amount in BTC
       },
       {                       (json object)
         "data": "hex",        (string, required) A key-value pair. The key must be "data", the value is hex-encoded data
       },
       ...
     ]

Argument #3 - locktime
~~~~~~~~~~~~~~~~~~~~~~

**Type:** numeric, optional, default=0

Raw locktime. Non-0 value also locktime-activates inputs

Argument #4 - replaceable
~~~~~~~~~~~~~~~~~~~~~~~~~

**Type:** boolean, optional, default=false

Marks this transaction as BIP125-replaceable.
       Allows this transaction to be replaced by a transaction with higher fees. If provided, it is an error if explicit sequence numbers are incompatible.

Result
~~~~~~

.. list-table::
   :header-rows: 1

   * - Name
     - Type
     - Description
   * - transaction
     - string
     - hex string of the transaction

Examples
~~~~~~~~


.. highlight:: shell

::

  bitcoin-cli createrawtransaction "[{\"txid\":\"myid\",\"vout\":0}]" "[{\"address\":0.01}]"

::

  bitcoin-cli createrawtransaction "[{\"txid\":\"myid\",\"vout\":0}]" "[{\"data\":\"00010203\"}]"

::

  curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "createrawtransaction", "params": ["[{\"txid\":\"myid\",\"vout\":0}]", "[{\"address\":0.01}]"] }' -H 'content-type: text/plain;' http://127.0.0.1:8332/

::

  curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "createrawtransaction", "params": ["[{\"txid\":\"myid\",\"vout\":0}]", "[{\"data\":\"00010203\"}]"] }' -H 'content-type: text/plain;' http://127.0.0.1:8332/