QTUM RPC CALLS
qrc20allowance "contractaddress" "addressfrom" "addressto"
qtum-cli qrc20allowance
qrc20allowance "contractaddress" "addressfrom" "addressto"
Returns remaining tokens allowed to spend for an address
Arguments:
1. contractaddress (string, required) The contract address
2. addressfrom (string, required) The qtum address of the account owning tokens
3. addressto (string, required) The qtum address of the account able to transfer the tokens
Result:
"str" (string) Amount of remaining tokens allowed to spent
Examples:
> qtum-cli qrc20allowance "eb23c0b3e6042821da281a2e2364feb22dd543e3" "QX1GkJdye9WoUnrE2v6ZQhQ72EUVDtGXQX" "QM72Sfpbz1BPpXFHz9m3CdqATR44Jvaydd"
> curl --user myusername --data-binary '{"jsonrpc": "1.0", "id": "curltest", "method": "qrc20allowance", "params": ["eb23c0b3e6042821da281a2e2364feb22dd543e3" "QX1GkJdye9WoUnrE2v6ZQhQ72EUVDtGXQX" "QM72Sfpbz1BPpXFHz9m3CdqATR44Jvaydd"]}' -H 'content-type: text/plain;' http://127.0.0.1:8332/qrc20balanceof "contractaddress" "address"
qtum-cli qrc20balanceof
qrc20balanceof "contractaddress" "address"
Returns the token balance for address
Arguments:
1. contractaddress (string, required) The contract address
2. address (string, required) The qtum address to check token balance
Result:
"str" (string) The token balance of the chosen address
Examples:
> qtum-cli qrc20balanceof "eb23c0b3e6042821da281a2e2364feb22dd543e3" "QX1GkJdye9WoUnrE2v6ZQhQ72EUVDtGXQX"
> curl --user myusername --data-binary '{"jsonrpc": "1.0", "id": "curltest", "method": "qrc20balanceof", "params": ["eb23c0b3e6042821da281a2e2364feb22dd543e3" "QX1GkJdye9WoUnrE2v6ZQhQ72EUVDtGXQX"]}' -H 'content-type: text/plain;' http://127.0.0.1:8332/qrc20decimals "contractaddress"
qtum-cli qrc20decimals
qrc20decimals "contractaddress"
Returns the number of decimals of the token
Arguments:
1. contractaddress (string, required) The contract address
Result:
n (numeric) The number of decimals of the token
Examples:
> qtum-cli qrc20decimals "eb23c0b3e6042821da281a2e2364feb22dd543e3"
> curl --user myusername --data-binary '{"jsonrpc": "1.0", "id": "curltest", "method": "qrc20decimals", "params": ["eb23c0b3e6042821da281a2e2364feb22dd543e3"]}' -H 'content-type: text/plain;' http://127.0.0.1:8332/
qrc20listtransactions
qtum-cli qrc20listtransactions
qrc20listtransactions "contractaddress" "address" ( fromblock minconf )
Returns transactions history for a specific address.
Arguments:
1. contractaddress (string, required) The contract address.
2. address (string, required) The qtum address to get history for.
3. fromblock (numeric, optional, default=0) The number of the earliest block.
4. minconf (numeric, optional, default=6) Minimal number of confirmations.
Result:
[ (json array)
{ (json object)
"receiver" : "str", (string) The receiver qtum address
"sender" : "str", (string) The sender qtum address
"amount" : "str", (string) The transferred token amount
"confirmations" : n, (numeric) The number of confirmations of the most recent transaction included
"blockHash" : "hex", (string) The block hash
"blockNumber" : n, (numeric) The block number
"blocktime" : xxx, (numeric) The block time expressed in UNIX epoch time.
"transactionHash" : "hex" (string) The transaction hash
},
...
]
Examples:
> qtum-cli qrc20listtransactions "eb23c0b3e6042821da281a2e2364feb22dd543e3" "QX1GkJdye9WoUnrE2v6ZQhQ72EUVDtGXQX"
> qtum-cli qrc20listtransactions "eb23c0b3e6042821da281a2e2364feb22dd543e3" "QX1GkJdye9WoUnrE2v6ZQhQ72EUVDtGXQX" 0 6
> curl --user myusername --data-binary '{"jsonrpc": "1.0", "id": "curltest", "method": "qrc20listtransactions", "params": ["eb23c0b3e6042821da281a2e2364feb22dd543e3" "QX1GkJdye9WoUnrE2v6ZQhQ72EUVDtGXQX"]}' -H 'content-type: text/plain;' http://127.0.0.1:8332/
> curl --user myusername --data-binary '{"jsonrpc": "1.0", "id": "curltest", "method": "qrc20listtransactions", "params": ["eb23c0b3e6042821da281a2e2364feb22dd543e3" "QX1GkJdye9WoUnrE2v6ZQhQ72EUVDtGXQX" 0 6]}' -H 'content-type: text/plain;' http://127.0.0.1:8332/qrc20name "contractaddress"
qrc20name "contractaddress"
Returns the name of the token
Arguments:
1. contractaddress (string, required) The contract address
Result:
"str" (string) The name of the token
Examples:
> qtum-cli qrc20name "eb23c0b3e6042821da281a2e2364feb22dd543e3"
> curl --user myusername --data-binary '{"jsonrpc": "1.0", "id": "curltest", "method": "qrc20name", "params": ["eb23c0b3e6042821da281a2e2364feb22dd543e3"]}' -H 'content-type: text/plain;' http://127.0.0.1:8332/
qrc20symbol "contractaddress"
qrc20symbol "contractaddress"
Returns the symbol of the token
Arguments:
1. contractaddress (string, required) The contract address
Result:
"str" (string) The symbol of the token
Examples:
> qtum-cli qrc20symbol "eb23c0b3e6042821da281a2e2364feb22dd543e3"
> curl --user myusername --data-binary '{"jsonrpc": "1.0", "id": "curltest", "method": "qrc20symbol", "params": ["eb23c0b3e6042821da281a2e2364feb22dd543e3"]}' -H 'content-type: text/plain;' http://127.0.0.1:8332/
qrc20totalsupply "contractaddress"
qrc20totalsupply "contractaddress"
Returns the total supply of the token
Arguments:
1. contractaddress (string, required) The contract address
Result:
"str" (string) The total supply of the token
Examples:
> qtum-cli qrc20totalsupply "eb23c0b3e6042821da281a2e2364feb22dd543e3"
> curl --user myusername --data-binary '{"jsonrpc": "1.0", "id": "curltest", "method": "qrc20totalsupply", "params": ["eb23c0b3e6042821da281a2e2364feb22dd543e3"]}' -H 'content-type: text/plain;' http://127.0.0.1:8332/qrc20approve "contractaddress" "owneraddress" "spenderaddress"
"amount" ( gaslimit gasprice checkoutputs )
qrc20approve "contractaddress" "owneraddress" "spenderaddress" "amount" ( gaslimit gasprice checkoutputs )
Owner approves an address to spend some amount of tokens.
Arguments:
1. contractaddress (string, required) The contract address.
2. owneraddress (string, required) The token owner qtum address.
3. spenderaddress (string, required) The token spender qtum address.
4. amount (string, required) The amount of tokens. eg 0.1
5. gaslimit (numeric or string, optional) The gas limit, default: 250000, max: 40000000
6. gasprice (numeric or string, optional) The qtum price per gas unit, default: 0.0000004, min:0.0000004
7. checkoutputs (boolean, optional, default=true) Check outputs before send
Result:
{ (json object)
"psbt" : "str", (string, optional) The base64-encoded unsigned PSBT of the new transaction. Only returned when wallet private keys are disabled.
"txid" : "hex" (string, optional) The transaction id. Only returned when wallet private keys are enabled.
}
Examples:
> qtum-cli qrc20approve "eb23c0b3e6042821da281a2e2364feb22dd543e3" "QX1GkJdye9WoUnrE2v6ZQhQ72EUVDtGXQX" "QM72Sfpbz1BPpXFHz9m3CdqATR44Jvaydd" 0.1
> qtum-cli qrc20approve "eb23c0b3e6042821da281a2e2364feb22dd543e3" "QX1GkJdye9WoUnrE2v6ZQhQ72EUVDtGXQX" "QM72Sfpbz1BPpXFHz9m3CdqATR44Jvaydd" 0.1 250000 0.0000004 true
> curl --user myusername --data-binary '{"jsonrpc": "1.0", "id": "curltest", "method": "qrc20approve", "params": ["eb23c0b3e6042821da281a2e2364feb22dd543e3" "QX1GkJdye9WoUnrE2v6ZQhQ72EUVDtGXQX" "QM72Sfpbz1BPpXFHz9m3CdqATR44Jvaydd" 0.1]}' -H 'content-type: text/plain;' http://127.0.0.1:8332/
> curl --user myusername --data-binary '{"jsonrpc": "1.0", "id": "curltest", "method": "qrc20approve", "params": ["eb23c0b3e6042821da281a2e2364feb22dd543e3" "QX1GkJdye9WoUnrE2v6ZQhQ72EUVDtGXQX" "QM72Sfpbz1BPpXFHz9m3CdqATR44Jvaydd" 0.1 250000 0.0000004 true]}' -H 'content-type: text/plain;' http://127.0.0.1:8332/qrc20burn "contractaddress" "owneraddress" "amount" ( gaslimit gasprice checkoutputs )
qrc20burn "contractaddress" "owneraddress" "amount" ( gaslimit gasprice checkoutputs )
Burns token amount from owner address.
Arguments:
1. contractaddress (string, required) The contract address.
2. owneraddress (string, required) The token owner qtum address.
3. amount (string, required) The amount of tokens to burn. eg 0.1
4. gaslimit (numeric or string, optional) The gas limit, default: 250000, max: 40000000
5. gasprice (numeric or string, optional) The qtum price per gas unit, default: 0.0000004, min:0.0000004
6. checkoutputs (boolean, optional, default=true) Check outputs before send
Result:
{ (json object)
"psbt" : "str", (string, optional) The base64-encoded unsigned PSBT of the new transaction. Only returned when wallet private keys are disabled.
"txid" : "hex" (string, optional) The transaction id. Only returned when wallet private keys are enabled.
}
Examples:
> qtum-cli qrc20burn "eb23c0b3e6042821da281a2e2364feb22dd543e3" "QM72Sfpbz1BPpXFHz9m3CdqATR44Jvaydd" 0.1
> qtum-cli qrc20burn "eb23c0b3e6042821da281a2e2364feb22dd543e3" "QM72Sfpbz1BPpXFHz9m3CdqATR44Jvaydd" 0.1 250000 0.0000004 true
> curl --user myusername --data-binary '{"jsonrpc": "1.0", "id": "curltest", "method": "qrc20burn", "params": ["eb23c0b3e6042821da281a2e2364feb22dd543e3" "QM72Sfpbz1BPpXFHz9m3CdqATR44Jvaydd" 0.1]}' -H 'content-type: text/plain;' http://127.0.0.1:8332/
> curl --user myusername --data-binary '{"jsonrpc": "1.0", "id": "curltest", "method": "qrc20burn", "params": ["eb23c0b3e6042821da281a2e2364feb22dd543e3" "QM72Sfpbz1BPpXFHz9m3CdqATR44Jvaydd" 0.1 250000 0.0000004 true]}' -H 'content-type: text/plain;' http://127.0.0.1:8332/qrc20burnfrom "contractaddress" "owneraddress" "spenderaddress" "amount" ( gaslimit gasprice checkoutputs )
qrc20burnfrom "contractaddress" "owneraddress" "spenderaddress" "amount" ( gaslimit gasprice checkoutputs )
Burns token amount from a given address.
Arguments:
1. contractaddress (string, required) The contract address.
2. owneraddress (string, required) The token owner qtum address.
3. spenderaddress (string, required) The token spender qtum address.
4. amount (string, required) The amount of token to burn. eg 0.1
5. gaslimit (numeric or string, optional) The gas limit, default: 250000, max: 40000000
6. gasprice (numeric or string, optional) The qtum price per gas unit, default: 0.0000004, min:0.0000004
7. checkoutputs (boolean, optional, default=true) Check outputs before send
Result:
{ (json object)
"psbt" : "str", (string, optional) The base64-encoded unsigned PSBT of the new transaction. Only returned when wallet private keys are disabled.
"txid" : "hex" (string, optional) The transaction id. Only returned when wallet private keys are enabled.
}
Examples:
> qtum-cli qrc20burnfrom "eb23c0b3e6042821da281a2e2364feb22dd543e3" "QX1GkJdye9WoUnrE2v6ZQhQ72EUVDtGXQX" "QM72Sfpbz1BPpXFHz9m3CdqATR44Jvaydd" 0.1
> qtum-cli qrc20burnfrom "eb23c0b3e6042821da281a2e2364feb22dd543e3" "QX1GkJdye9WoUnrE2v6ZQhQ72EUVDtGXQX" "QM72Sfpbz1BPpXFHz9m3CdqATR44Jvaydd" 0.1 250000 0.0000004 true
> curl --user myusername --data-binary '{"jsonrpc": "1.0", "id": "curltest", "method": "qrc20burnfrom", "params": ["eb23c0b3e6042821da281a2e2364feb22dd543e3" "QX1GkJdye9WoUnrE2v6ZQhQ72EUVDtGXQX" "QM72Sfpbz1BPpXFHz9m3CdqATR44Jvaydd" 0.1]}' -H 'content-type: text/plain;' http://127.0.0.1:8332/
> curl --user myusername --data-binary '{"jsonrpc": "1.0", "id": "curltest", "method": "qrc20burnfrom", "params": ["eb23c0b3e6042821da281a2e2364feb22dd543e3" "QX1GkJdye9WoUnrE2v6ZQhQ72EUVDtGXQX" "QM72Sfpbz1BPpXFHz9m3CdqATR44Jvaydd" 0.1 250000 0.0000004 true]}' -H 'content-type: text/plain;' http://127.0.0.1:8332/qrc20transfer "contractaddress" "owneraddress" "addressto" "amount" ( gaslimit gasprice checkoutputs )
qrc20transfer "contractaddress" "owneraddress" "addressto" "amount" ( gaslimit gasprice checkoutputs )
Send token amount to a given address.
Arguments:
1. contractaddress (string, required) The contract address.
2. owneraddress (string, required) The token owner qtum address.
3. addressto (string, required) The qtum address to send funds to.
4. amount (string, required) The amount of tokens to send. eg 0.1
5. gaslimit (numeric or string, optional) The gas limit, default: 250000, max: 40000000
6. gasprice (numeric or string, optional) The qtum price per gas unit, default: 0.0000004, min:0.0000004
7. checkoutputs (boolean, optional, default=true) Check outputs before send
Result:
{ (json object)
"psbt" : "str", (string, optional) The base64-encoded unsigned PSBT of the new transaction. Only returned when wallet private keys are disabled.
"txid" : "hex" (string, optional) The transaction id. Only returned when wallet private keys are enabled.
}
Examples:
> qtum-cli qrc20transfer "eb23c0b3e6042821da281a2e2364feb22dd543e3" "QX1GkJdye9WoUnrE2v6ZQhQ72EUVDtGXQX" "QM72Sfpbz1BPpXFHz9m3CdqATR44Jvaydd" 0.1
> qtum-cli qrc20transfer "eb23c0b3e6042821da281a2e2364feb22dd543e3" "QX1GkJdye9WoUnrE2v6ZQhQ72EUVDtGXQX" "QM72Sfpbz1BPpXFHz9m3CdqATR44Jvaydd" 0.1 250000 0.0000004 true
> curl --user myusername --data-binary '{"jsonrpc": "1.0", "id": "curltest", "method": "qrc20transfer", "params": ["eb23c0b3e6042821da281a2e2364feb22dd543e3" "QX1GkJdye9WoUnrE2v6ZQhQ72EUVDtGXQX" "QM72Sfpbz1BPpXFHz9m3CdqATR44Jvaydd" 0.1]}' -H 'content-type: text/plain;' http://127.0.0.1:8332/
> curl --user myusername --data-binary '{"jsonrpc": "1.0", "id": "curltest", "method": "qrc20transfer", "params": ["eb23c0b3e6042821da281a2e2364feb22dd543e3" "QX1GkJdye9WoUnrE2v6ZQhQ72EUVDtGXQX" "QM72Sfpbz1BPpXFHz9m3CdqATR44Jvaydd" 0.1 250000 0.0000004 true]}' -H 'content-type: text/plain;' http://127.0.0.1:8332/qrc20transferfrom "contractaddress" "owneraddress" "spenderaddress" "receiveraddress" "amount" ( gaslimit gasprice checkoutputs )Last updated