RPC Browser

Arguments


Help Content

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.

Arguments:
1. inputs                      (json array, required) The inputs
     [
       {                       (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
       },
       ...
     ]
2. outputs                     (json array, required) The 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
       },
       ...
     ]
3. locktime                    (numeric, optional, default=0) Raw locktime. Non-0 value also locktime-activates inputs
4. replaceable                 (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:
"hex"    (string) hex string of the transaction

Examples:
> 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/

inputs

{
    "name": "inputs",
    "detailsLines": [
        "     [",
        "       {                       (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",
        "       },",
        "       ...",
        "     ]"
    ],
    "properties": [
        "json array",
        "required"
    ],
    "description": "The inputs"
}

outputs

{
    "name": "outputs",
    "detailsLines": [
        "                               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",
        "       },",
        "       ...",
        "     ]"
    ],
    "properties": [
        "json array",
        "required"
    ],
    "description": "The outputs (key-value pairs), where none of the keys are duplicated."
}

locktime

{
    "name": "locktime",
    "detailsLines": [],
    "properties": [
        "numeric",
        "optional",
        "default=0"
    ],
    "description": "Raw locktime. Non-0 value also locktime-activates inputs"
}

replaceable

{
    "name": "replaceable",
    "detailsLines": [
        "                               Allows this transaction to be replaced by a transaction with higher fees. If provided, it is an error if explicit sequence numbers are incompatible."
    ],
    "properties": [
        "boolean",
        "optional",
        "default=false"
    ],
    "description": "Marks this transaction as BIP125-replaceable."
}

Recent (5)

Blockchain (25)

Control (6)

Generating (3)

Mining (6)

Network (13)

Rawtransactions (17)

Signer (1)

Util (8)

Wallet (61)

Zmq (1)