Supply API
Figure | Endpoint |
---|---|
Circulating Supply | https://explorer.nubits.com/api/v1/coin/<symbol>/supply/circulating |
Total Supply | https://explorer.nubits.com/api/v1/coin/<symbol>/supply/total |
Parked Supply | https://explorer.nubits.com/api/v1/coin/<symbol>/supply/parked |
Network Funds | https://explorer.nubits.com/api/v1/coin/<symbol>/network_funds |
Example: https://explorer.nubits.com/api/v1/coin/USNBT/supply/circulating
Note: <symbol>
is case-insensitive.
JSON-RPC API in NuBits Wallet
Connect using asset-specific ports (14001+
). Use argument --unit=<initial>
to specify asset when directly executing daemon nud
which defaults to NuShares (NSR), i.e. --unit=S
.
Example: nud --unit=B getnewaddress
creates a USNBT address. nud getnewaddress
creates an NSR address.
Asset | Symbol | Initial | Production Port | Note |
---|---|---|---|---|
NuShares | NSR | S | 14001 |
|
United States NuBits | USNBT | B | 14002 |
|
Chinese NuBits | CNNBT | Y | 14003 |
|
European NuBits | EUNBT | E | 14004 |
|
World NuBits | XNBT | X | 14005 |
release in 2018 |
South Korean NuBits | KRNBT | W | 14006 |
release in March |
Japanese NuBits | JPNBT | J | 14007 |
release in March |
Testnet ports: 15001+
Protocol Ports
Production: 7890
Testnet: 7895
Commands
addmultisigaddress
addmultisigaddress <nrequired> <'["key","key"]'> [account]
Adds a nRequired-to-sign multi-signature address to the wallet.
backupwallet
backupwallet <destination>
Safely copies wallet.dat to destination, which can be a directory or a path with filename.
burn
burn <amount> <unit> [comment]
<amount> is a real and is rounded to the nearest 0.0001 <unit> is the unit to burn (‘B’ for NuBits, ‘S’ for NuShares). requires portfolio passphrase to be set with walletpassphrase
first.
checkwallet
checkwallet
Check portfolio for integrity.
createmultisig
createmultisig nrequired ["key",...]
createrawtransaction
createrawtransaction [{"txid":txid,"vout":n},...] {address:amount,...}
Create a transaction spending given inputs.
decoderawtransaction
decoderawtransaction <hex string>
Return a JSON object representing the serialized, hex-encoded transaction.
distribute
distribute <cutoff timestamp> <amount> [<proceed>]
<cutoff timestamp> is the date and time at which the share balances should be considered formatted in unix epoch time.
dumpprivkey
dumpprivkey <address>
Reveals the private key corresponding to <address>.
encryptwallet
encryptwallet <passphrase>
Encrypts the portfolio with <passphrase>
exportpeercoinkeys
exportpeercoinkeys
Add the Peercoin keys associated with the NuShares addresses to the Peercoin wallet. Peercoin must be running and accept RPC commands.
getaccount
getaccount <address>
Returns the account associated with the given address.
getaccountaddress
getaccountaddress <account>
Returns the current Nu address for receiving payments to this account.
getaddressesbyaccount
getaddressesbyaccount <account>
Returns the list of addresses for the given account.
getbalance
getbalance [account] [minconf=1]
If [account] is not specified, returns the server’s total available balance.
getblock
getblock <hash> [txinfo]
txinfo optional to print more detailed tx info
getblockcount
getblockcount
Returns the number of blocks in the longest block chain.
getblockhash
getblockhash <index>
Returns hash of block in best-block-chain at <index>.
getblocktemplate
getblocktemplate [params]
Returns data needed to construct a block to work on:
getcheckpoint
getcheckpoint
Show info of synchronized checkpoint.
getconnectioncount
getconnectioncount
Returns the number of connections to other nodes.
getcustodianvotes
getcustodianvotes [<block height>] [<block quantity>]
Returns an object containing the custodian vote results.
getdatafeed
getdatafeed Return the current data feed.
getdifficulty
getdifficulty
Returns difficulty as a multiple of the minimum difficulty.
getelectedcustodians
getelectedcustodians
Returns an object containing the elected custodians.
getgenerate
getgenerate
Returns true
or false
.
gethashespersec
gethashespersec
Returns a recent hashes per second performance measurement while generating.
getinfo
getinfo
Returns an object containing various state info.
getliquiditydetails
getliquiditydetails <currency>
Return the breakdown detail of liquidityinfo Currency is the single letter of the currency (currently only ‘B’ for “NuBits”).
getliquidityinfo
getliquidityinfo <currency>
Currency is the single letter of the currency (currently only ‘B’ for “NuBits”).
getmininginfo
getmininginfo
Returns an object containing mining-related information.
getmotions
getmotions [<block height>] [<block quantity>]
Returns an object containing the motion vote results.
getnetworkghps
getnetworkghps
Returns a recent giga-hash per second (GH/s) network mining estimate.
getnewaddress
getnewaddress [account]
Returns a new Nu address for receiving payments. If [account] is specified (recommended), it is added to the address book so payments received with the address will be credited to [account].
getparkrates
getparkrates [<height>] [<currency>]
Returns an object containing the park rates in the block at height <height> (default: the last block).
getparkvotes
getparkvotes [<block height>] [<block quantity>]
Returns an object containing a summary of the park rate votes.
getpeercoinaddresses
getpeercoinaddresses <account>
Returns the list of addresses and the associated Peercoin address for the given account.
getpeerinfo
getpeerinfo
Returns data about each connected network node.
getpremium
getpremium <amount> <duration>
<amount> is a real and is rounded to the nearest 0.0001 <duration> is the number of blocks during which the amount would be parked.
getrawmempool
getrawmempool
Returns all transaction ids in memory pool.
getrawtransaction
getrawtransaction <txid> [verbose=0]
If verbose=0
, returns serialized, hex-encoded data for transaction txid. If verbose
is non-zero, returns a JSON Object containing information about the transaction. Returns an error if <txid> is unknown.
getreceivedbyaccount
getreceivedbyaccount <account> [minconf=1]
Returns the total amount received by addresses with <account> in transactions with at least [minconf] confirmations.
getreceivedbyaddress
getreceivedbyaddress <address> [minconf=1]
Returns the total amount received by <address> in transactions with at least [minconf] confirmations.
gettransaction
gettransaction <txid>
Get detailed information about <txid>.
gettxout
gettxout "txid" n ( includemempool )
getvote
getvote
Returns the vote that will be inserted in the next proof of stake block.
getwork
getwork [data]
If [data] is not specified, returns formatted hash data to work on:
help
help [command]
List commands, or get help for a command.
importprivkey
importprivkey <privkey> [label]
Adds a private key (as returned by dumpprivkey) to your wallet.
keypoolrefill
keypoolrefill
Fills the keypool, requires portfolio passphrase to be set.
liquidityinfo
liquidityinfo <currency> <buyamount> <sellamount> <grantaddress> <identifier>
Broadcast liquidity information. The identifier is used to aggregate liquidity and must be submitted in the format :
tier:pair:exchange:botsessionid
Example of a valid identifier : 2:BTCNBT:ccedk:nubotsession3
listaccounts
listaccounts [minconf=1]
Returns Object that has account names as keys, account balances as values.
listparked
listparked [account]
Returns the list of parked coins.
listreceivedbyaccount
listreceivedbyaccount [minconf=1] [includeempty=false]
[minconf] is the minimum number of confirmations before payments are included.
listreceivedbyaddress
listreceivedbyaddress [minconf=1] [includeempty=false]
[minconf] is the minimum number of confirmations before payments are included.
listsinceblock
listsinceblock [blockhash] [target-confirmations]
Get all transactions in blocks since block [blockhash], or all transactions if omitted
listtransactions
listtransactions [account] [count=10] [from=0]
Returns up to [count] most recent transactions skipping the first [from] transactions for account [account].
listunspent
listunspent [minconf=1] [maxconf=9999999] ["address",...]
Returns array of unspent transaction outputs
makekeypair
makekeypair [prefix]
Make a public/private key pair.
move
move <fromaccount> <toaccount> <amount> [minconf=1] [comment]
Move from one account in your portfolio to another.
park
park <amount> <duration> [account=""] [unparkaddress] [minconf=1]
<amount> is a real and is rounded to the nearest 0.000001
repairwallet
repairwallet
Repair portfolio if checkwallet
reports any problem.
reservebalance
reservebalance [<reserve> [amount]]
<reserve> is true or false to turn balance reserve on or off.
sendalert
sendalert <message> <privatekey> <minver> <maxver> <priority> <id> [cancelupto]
<message> is the alert text message
sendfrom
sendfrom <fromaccount> <toaddress> <amount> [minconf=1] [comment] [comment-to]
<amount> is a real and is rounded to the nearest 0.000001
sendmany
sendmany <fromaccount> {address:amount,...} [minconf=1] [comment]
<amount(s)> are double-precision floating point numbers
sendrawtransaction
sendrawtransaction <hex string> [checkinputs=0]
Submits raw transaction (serialized, hex-encoded) to local node and network.
sendtoaddress
sendtoaddress <address> <amount> [comment] [comment-to]
<amount> is a real and is rounded to the nearest 0.000001
setaccount
setaccount <address> <account>
Sets the account associated with the given address.
setdatafeed
setdatafeed <url> [<signature url> <address>] [<parts>]
Change the vote data feed. Set <url> to an empty string to disable. If <signature url> and <address> are specified and not empty strings a signature will also be retrieved at <signature url> and verified. Parts is the list of the top level vote parts that will be taken from the feed, separated by a coma. The other parts will not affect the vote. Default is “custodians,parkrates,motions”.
setgenerate
setgenerate <generate> [genproclimit]
<generate> is true
or false
to turn generation on or off.
setmotionvote
setmotionvote <motion hash>
<motionhash> is the hash of the motion to vote for.
setvote
setvote <vote>
<vote> is the complete vote in JSON. Example:
signmessage
signmessage <address> <message>
Sign a message with the private key of an address
signrawtransaction
Sign inputs for raw transaction (serialized, hex-encoded).
stop
stop
Stop Nu server.
submitblock
submitblock <hex data> [optional-params-obj]
[optional-params-obj] parameter is currently ignored.
unpark
unpark
Unpark all transaction that have reached duration
validateaddress
validateaddress <address>
Return information about <address>.
verifymessage
verifymessage <address> <signature> <message>
Verify a signed message
walletlock
walletlock
Removes the portfolio encryption key from memory, locking the portfolio.
walletpassphrase
walletpassphrase <passphrase> <timeout> [mintonly]
Stores the portfolio decryption key in memory for <timeout> seconds.
walletpassphrasechange
walletpassphrasechange <oldpassphrase> <newpassphrase>
Changes the portfolio passphrase from <oldpassphrase> to <newpassphrase>.