NAV
shell http

Introduction

This is the official API documentation of ZeroHour.

Current version

release

ZeroHour

Provides general information about the state of the application and the ability to close the application.

Stop

curl "http://127.0.0.1:9090/zerohour/stop"
GET zerohour/stop HTTP/1.1
Host: 127.0.0.1:9090

Will stop the application. This command might not be able to return a http OK message.

REQUEST

GET zerohour/stop

Status

curl "http://127.0.0.1:9090/zerohour/status"
GET /zerohour/status HTTP/1.1
Host: 127.0.0.1:9090

Returns the status of the application

REQUEST

GET zerohour/status

Status Value
0 No connections
1 Synchronizing
2 Oke

Forging Status

curl "http://127.0.0.1:9090/zerohour/status/forging"
GET zerohour/status/forging HTTP/1.1
Host: 127.0.0.1:9090

Returns the forging status

REQUEST

GET zerohour/status/forging

Status Value
0 Forging Disabled
1 Forging Enabled
2 Forging

Is Up To Date

curl "http://127.0.0.1:9090/zerohour/isuptodate"
GET zerohour/isuptodate HTTP/1.1
Host: 127.0.0.1:9090

Returns a boolean that shows if the application is synchronized with the network.

REQUEST

GET zerohour/isuptodate

Version

curl "http://127.0.0.1:9090/version"
GET version HTTP/1.1
Host: 127.0.0.1:9090

Returns the current version and the build date of the installed application.

REQUEST

GET version

Seed

To generate a random base58 encoded seed. These seeds can be used to create a wallet or to import an account.

Get Seed

curl "http://127.0.0.1:9090/seed"
GET seed HTTP/1.1
Host: 127.0.0.1:9090

Returns a base58 encoded random seed of 32 bytes

REQUEST

GET seed

Get Seed By Length

curl "http://127.0.0.1:9090/seed/{length}"
GET seed/{length} HTTP/1.1
Host: 127.0.0.1:9090

Use the optional parameter length to request a seed of {length} bytes.

REQUEST

GET seed/{length}

Peers

Get Peers

curl "http://127.0.0.1:9090/peers"
GET peers HTTP/1.1
Host: 127.0.0.1:9090

Returns an array of all the IP’s of the peers to which the application is currently connected.

REQUEST

GET peers

Transactions

Get Transactions

curl "http://127.0.0.1:9090/transactions"
GET transactions HTTP/1.1
Host: 127.0.0.1:9090

Response

HTTP/1.1 200 OK
Content-Type: application/json
[
  {
    "transactions": [

    ],
    "account": "Qdxn4qW8kiPUiBnBSy9mbqMGBrBHRhK2JM"
  },
  {
    "transactions": [

    ],
    "account": "QQNFGuE8iZZ3sHjCnvvdbhfQHXokU8SgCX"
  }
]

Returns an array of your accounts each with their 50 last transactions.

REQUEST

GET transactions

Errors

Error Description
201 Wallet does not exist.

Get Limited Transactions

curl "http://127.0.0.1:9090/transactions/limit/{limit}"
GET transactions/limit/{limit} HTTP/1.1
Host: 127.0.0.1:9090

Response

HTTP/1.1 200 OK
Content-Type: application/json
[
  {
    "transactions": [

    ],
    "account": "Qdxn4qW8kiPUiBnBSy9mbqMGBrBHRhK2JM"
  },
  {
    "transactions": [

    ],
    "account": "QQNFGuE8iZZ3sHjCnvvdbhfQHXokU8SgCX"
  }
]

Returns an array of your accounts each with their {limit} last transactions.

REQUEST

GET transactions/limit/{limit}

Errors

Error Description
201 Wallet does not exist.

Get Transactions By Address

curl "http://127.0.0.1:9090/transactions/address/{address}"
GET transactions/address/{address} HTTP/1.1
Host: 127.0.0.1:9090

Returns an array of the last 50 transactions of a specific address in your wallet.

REQUEST

GET transactions/address/{address}

Errors

Error Description
102 Invalid address.
201 Wallet does not exist.
202 address does not exist in wallet

Get Limited Transactions By Address

curl "http://127.0.0.1:9090/transactions/address/{address}/limit/{limit}"
GET transactions/address/{address}/limit/{limit} HTTP/1.1
Host: 127.0.0.1:9090

Returns an array of the last {limit} transactions of a specific address in your wallet.

REQUEST

GET transactions/address/{address}/limit/{limit}

Errors

Error Description
102 Invalid address.
201 Wallet does not exist.
202 address does not exist in wallet

Get Transactions By Signature

curl "http://127.0.0.1:9090/transactions/signature/{signature}"
GET transactions/signature/{signature} HTTP/1.1
Host: 127.0.0.1:9090

Returns the transaction that matches the given signature.

REQUEST

GET transactions/signature/{signature}

Errors

Error Description
101 Invalid signature.
311 Transaction does not exist.

Get Network Transactions

curl "http://127.0.0.1:9090/transactions/network"
GET transactions/network HTTP/1.1
Host: 127.0.0.1:9090

Returns an array of all the unconfirmed transactions known to the client.

REQUEST

GET transactions/network

Scan Transactions

curl "http://127.0.0.1:9090/transactions/scan"
  -d '{"blocklimit":1000,"transactionlimit":100,"type":2}'
  -X POST
POST transactions/scan HTTP/1.1
Host: 127.0.0.1:9090
{
  "blocklimit": 1000,
  "transactionlimit": 100,
  "type": 2
}

Response

HTTP/1.1 200 OK
Content-Type: application/json
{
  "amount": 303,
  "lastscanned": "HQzVY265bpf2pSuLK8P5PRWQN47Ui5PiqyFsgyz2WpRiu6xUaLyyj99yrkUt2xSMbexRoF5fqJijJwG9DGJjPVYDwrhgSa33vg2KxvehAXRdhXvegzjnW55Fn1NXy51Ei3D8A9CyW7N4ohzFdHwmGjNryM26RPnqaTmmrZA32HeX7uc",
  "transactions": [
    {
      "fee": "1.00000000",
      "timestamp": 1400254833419,
      "sender": "Qec5ueWc4rcBrty47GZfFSqvLymxvcycFm",
      "amount": "1.00000000",
      "confirmations": 1959,
      "type": 2,
      "reference": "38sGerf4a24fRCTeknzQJgGBJe6hKribjKZGpQmrqajJwDM216FoUm9VCve7tst4Dypn1qgHKVgb6qN4vK9QFv3p",
      "signature": "2kioUSPPZdGvqWYZuT61J5M9nQ3udSzS2AZGU3MhdtNdbS2naWfuD6cpR2T9ZpKjRs2GFsyEYHDntQbBmTdsCyZL",
      "recipient": "QWNNYAh4dD7gktCfN9hb454qEaitjEnfy5"
    },
    {
      "fee": "1.00000000",
      "timestamp": 1400258674297,
      "sender": "QVjcFWE6TnGePGJEtbNc1thwD2sgHBLvUV",
      "amount": "42940527.25000000",
      "confirmations": 1949,
      "type": 2,
      "reference": "kRMLekdCQY7Prq2nyL8XLuL77oAJKP8WNarq1GaU6CTLQZ8VHgZJQFAeqJrNeKpt52QgsYrawcscRncY1XEsePB",
      "signature": "4YEbzGrvKntTJbfX3v4AZSY1JUaUqw7LFRm1s4ZDZKJqxfMWtKUw2Ho1jXXE16FSqwU4GqP8dxHaCV8huA6xDSg5",
      "recipient": "Qd9jQKZSXoYgFypTQySJUSbXcZvjgdiemn"
    }
  ]
}

Returns all the transactions that match the filters. All filters are optional but please limit that amount of transactions or blocks to scan to avoid running into issues.

REQUEST

POST transactions/scan

Filter Description
start The signature of the starting block.
blocklimit The maximum amount of blocks to scan.
transactionlimit The maximum amount of transactions to return.
type Only return transactions with the given type.
service Only return Arbitrary Transactions with the given service.
address Only return transactions where the given address is involved.

Return the last block it scanned, the amount of blocks it scanned and the scanned transactions.

Errors

Error Description
1 Json error.
102 Invalid address.
101 Invalid signature.
301 Block does not exist.

Blocks

Get Blocks

curl "http://127.0.0.1:9090/blocks"
GET blocks HTTP/1.1
Host: 127.0.0.1:9090

Returns an array of the 50 last blocks generated by your accounts.

REQUEST

GET blocks

Errors

Error Description
201 Wallet does not exist.

Get Blocks By Address

curl "http://127.0.0.1:9090/blocks/address/{address}"
GET blocks/address/{address} HTTP/1.1
Host: 127.0.0.1:9090

Returns an array of the 50 last blocks generated by a specific address in your wallet.

REQUEST

GET blocks/address/{address}

Errors

Error Description
102 Invalid address.
201 Wallet does not exist.
202 Address does not exist in wallet.

Get Blocks By Signature

curl "http://127.0.0.1:9090/blocks/{signature}"
GET blocks/{signature} HTTP/1.1
Host: 127.0.0.1:9090

Returns the block that matches the given signature.

REQUEST

GET blocks/{signature}

Errors

Error Description
101 Invalid signature.
301 Block does not exist.

Get Genesis Block

curl "http://127.0.0.1:9090/blocks/first"
GET blocks/first HTTP/1.1
Host: 127.0.0.1:9090

Returns the genesis block.

REQUEST

GET blocks/first

Get Last Block

curl "http://127.0.0.1:9090/blocks/last"
GET blocks/last HTTP/1.1
Host: 127.0.0.1:9090

Returns the last valid block.

REQUEST

GET blocks/last

Get Child Block

curl "http://127.0.0.1:9090/blocks/child/{signature}"
GET blocks/child/{signature} HTTP/1.1
Host: 127.0.0.1:9090

Returns the child block of the block that matches the given signature.

REQUEST

GET blocks/child/{signature}

Errors

Error Description
101 Invalid signature.
301 Block does not exist.

Get Generating Balance Of The Next Block

curl "http://127.0.0.1:9090/blocks/generatingbalance"
GET blocks/generatingbalance HTTP/1.1
Host: 127.0.0.1:9090

Calculates the generating balance of the block that will follow the last block.

REQUEST

GET blocks/generatingbalance

Get Blocks Generating Balance

curl "http://127.0.0.1:9090/blocks/generatingbalance/{signature}"
GET blocks/generatingbalance/{signature} HTTP/1.1
Host: 127.0.0.1:9090

Calculates the generating balance of the block that will follow the block that matches the signature.

REQUEST

GET blocks/generatingbalance/{signature}

Errors

Error Description
101 Invalid signature.
301 Block does not exist.

Get Time For The Next Block

curl "http://127.0.0.1:9090/blocks/time"
GET blocks/time HTTP/1.1
Host: 127.0.0.1:9090

Calculates the time it should take for the network to generate the next block.

REQUEST

GET blocks/time

Get Last Block Height

curl "http://127.0.0.1:9090/blocks/height"
GET blocks/height HTTP/1.1
Host: 127.0.0.1:9090

Returns the block height of the last block.

REQUEST

GET blocks/height

Get Block Height By Signature

curl "http://127.0.0.1:9090/blocks/height/{signature}"
GET blocks/height/{signature} HTTP/1.1
Host: 127.0.0.1:9090

Returns the block height of the block that matches the given signature.

REQUEST

GET blocks/height/{signature}

Errors

Error Description
101 Invalid signature.
301 Block does not exist.

Get Blocks By Height

curl "http://127.0.0.1:9090/blocks/byheight/{height}"
GET blocks/byheight/{height} HTTP/1.1
Host: 127.0.0.1:9090

Returns the specified block

REQUEST

GET blocks/byheight/{height}

Errors

Error Description
101 Invalid signature.
301 Block does not exist.

Addresses

Get Addresses

curl "http://127.0.0.1:9090/addresses"
GET addresses HTTP/1.1
Host: 127.0.0.1:9099

Returns an array of all the addresses in your wallet.

REQUEST

GET addresses

Errors

Error Description
201 Wallet does not exist.

Validate Address

curl "http://127.0.0.1:9090/addresses/validate/{address}"
GET addresses/validate/{address} HTTP/1.1
host: 127.0.0.1:9090

Validates the given address.Returns true/false.

REQUEST

GET addresses/validate/{address}

Get Address Seed

curl "http://127.0.0.1:9090/addresses/seed/{address}"
GET addresses/seed/{address} HTTP/1.1
Host: 127.0.0.1:9090

Returns the 32-byte long base58-encoded account seed of the given address.

REQUEST

GET addresses/seed/{address}

Errors

Error Description
102 Invalid address.
201 Wallet does not exist.
202 Address does not exist in wallet.
203 Wallet is locked.

Create A New Address

curl "http://127.0.0.1:9090/addresses/new"
GET addresses/new HTTP/1.1
Host: 127.0.0.1:9090

Generates a new account and returns the newly generated address.

REQUEST

GET addresses/new

Errors

Error Description
201 Wallet does not exist.
203 Wallet is locked.

Import Address

curl "http://127.0.0.1:9090/addresses"
  -X POST
  -d seed
POST addresses HTTP/1.1
Host: 127.0.0.1:9090
seed

Imports the given 32-byte long base58-encoded account seed.

Returns the address when successfully imported.

REQUEST

POST addresses seed

Errors

Error Description
103 Invalid seed.
201 Wallet does not exist.
203 Wallet is locked.

Delete Address

curl "http://127.0.0.1:9090/addresses/{address}
  -X DELETE
DELETE addresses/{address} HTTP/1.1
Host: 127.0.0.1:9090

Deletes the given address.Returns true/false.

REQUEST

DELETE addresses/{address}

Errors

Error Description
102 Invalid address.
201 Wallet does not exist.
203 Wallet is locked.

Get Address Balance

curl "http://127.0.0.1:9090/addresses/balance/{address}"
GET addresses/balance/{address} HTTP/1.1
Host: 127.0.0.1:9090

Returns the confirmed balance of the given address.

REQUEST

GET addresses/balance/{address}

Errors

Error Description
102 Invalid address.

Get Address Generating Balance

curl "http://127.0.0.1:9090/addresses/generatingbalance/{address}"
GET addresses/generatingbalance/{address} HTTP/1.1
Host: 127.0.0.1:9090

Return the generating balance of the given address.

REQUEST

GET addresses/generatingbalance/{address}

Get Asset Balance By Address

curl "http://127.0.0.1:9090/addresses/assetbalance/{assetid}/{address}"
GET addresses/assetbalance/{assetid}/{address} HTTP/1.1
Host: 127.0.0.1:9090

Returns the confirmed balance of the given asset ID and the given address.

REQUEST

GET addresses/assetbalance/{assetid}/{address}

Errors

Error Description
102 Invalid address.
601 Invalid asset id.

Calculate Address Balance

curl "http://http://127.0.0.1:9090/addresses/balance/{address}/{confirmation}"
GET addresses/balance/{address}/{confirmation} HTTP/1.1
Host: 127.0.0.1:9090

Calculates the balance of the given address after the given confirmations.

0 confirmations can only be used on addresses that exist in your wallet.

REQUEST

GET addresses/balance/{address}/{confirmation}

Errors

Error Description
102 Invalid address.

Get Address Public key

curl "http://127.0.0.1:9090/addresses/publickey/{address}"
GET addresses/publickey/{address} HTTP/1.1
Host: 127.0.0.1:9090

Returns the public key of the given address

REQUEST

GET addresses/publickey/{address}

Errors

Error Description
102 Invalid address.

Sign Message

curl "http://127.0.0.1:9090/addresses/sign/{address}"
  -X POST
  -d test
POST addresses/sign/{address} HTTP/1.1
Host: 127.0.0.1:9090
test

Signs the given message using the given address.

Response

HTTP/1.1 200 OK
Content-Type: application/json
{
  "message": "test",
  "publickey": "6cWtyccawscvHhE5woPaLbDUc6qFaH7b7YuDJFrBvgJ3",
  "signature": "2XuAEoUG2GmWJ8s5ZMZMK7csQ1nfHcqL5JYm3JBqetUAZKeT9mu7mSKYYMjLQoLBr5DqLCfaKXLQJnbzCLYCfC21"
}

REQUEST

POST addresses/sign/{address}

Errors

Error Description
102 Invalid address.
201 Wallet does not exist.
202 Address does not exist in wallet.
203 Wallet is locked.

Verify Message

curl "http://127.0.0.1:9090/addresses/verify/{address}"
  -X POST
  -d '{"message": "test","publickey": "6cWtyccawscvHhE5woPaLbDUc6qFaH7b7YuDJFrBvgJ3","signature":"2XuAEoUG2GmWJ8s5ZMZMK7csQ1nfHcqL5JYm3JBqetUAZKeT9mu7mSKYYMjLQoLBr5DqLCfaKXLQJnbzCLYCfC21"}'
POST addresses/verify/{address} HTTP/1.1
Host: 127.0.0.1:9090
{
  "message": "test",
  "publickey": "6cWtyccawscvHhE5woPaLbDUc6qFaH7b7YuDJFrBvgJ3",
  "signature": "2XuAEoUG2GmWJ8s5ZMZMK7csQ1nfHcqL5JYm3JBqetUAZKeT9mu7mSKYYMjLQoLBr5DqLCfaKXLQJnbzCLYCfC21"
}

Verifies if the given message was signed by the given address. Returns true or false.

REQUEST

POST addresses/verify/{address}

Errors

Error Description
101 Invalid signature
102 Invalid address.
112 Invalid public key.

Wallet

Get Wallet

curl "http://127.0.0.1:9090/wallet"
GET wallet HTTP/1.1
Host: 127.0.0.1:9090

Response

{
  "exists": true,
  "isunlocked": false
}

Returns general information about the wallet.

REQUEST

GET wallet

Get Wallet Seed

curl "http://127.0.0.1:9090/wallet/seed"
GET wallet/seed HTTP/1.1
Host: 127.0.0.1:9090

Return the 32-byte long base58-encoded wallet seed.

REQUEST

GET wallet/seed

Errors

Error Description
201 Wallet does not exist.
203 Wallet is locked.

Wallet Synchronize

curl "http://127.0.0.1:9090/wallet/synchronize"
GET wallet/synchronize HTTP/1.1
Host: 127.0.0.1:9090

Rescans the blockchain for data.

REQUEST

GET wallet/synchronize

Errors

Error Description
201 Wallet does not exist.

Lock Wallet

curl "http://127.0.0.1:9090/wallet/lock"
GET wallet/lock HTTP/1.1
Host: 127.0.0.1:9090

Locks the wallet.

Returns true/false depending on the fact if the wallet was already locked and if the password was correct.

REQUEST

GET wallet/lock

Errors

Error Description
201 Wallet does not exist.

Unlock Wallet

curl "http://127.0.0.1:9090/wallet/unlock"
  -X POST
  -d password
POST wallet/unlock HTTP/1.1
Host: 127.0.0.1:9090
password

Unlocks the wallet using the given password.

Returns true/false depending on the fact if the password is correct.

REQUEST

POST wallet/unlock

Errors

Error Description
201 Wallet does not exist.

Create Wallet

curl "http://127.0.0.1:9090/wallet"
  -X POST
  -d '{"seed": "FQgbSAm6swGbtqA3NE8PttijPhT4N3Ufh4bHFAkyVnQz","password": "cookies","recover": false,"amount": 10}'
POST wallet HTTP/1.1
Host: 127.0.0.1:9090
{
  "seed": "FQgbSAm6swGbtqA3NE8PttijPhT4N3Ufh4bHFAkyVnQz",
  "password": "cookies",
  "recover": false,
  "amount": 10
}

Creates a wallet using the given 32-byte long base58-encoded seed, password,recover flag and amount.

REQUEST

POST wallet

Errors

Error Description
1 Json error.
103 Invalid seed.
104 Invalid amount.
204 Wallet already exists.

Payment

Post Payment

curl "http://127.0.0.1/9090/payment"
  -X POST
  -d '{"amount":"10.05","fee":"1.000001","sender":"Qdxn4qW8kiPUiBnBSy9mbqMGBrBHRhK2JM","recipient":"QhMaXFowsVqdAhvU2xkcLzuVaH5VDyEWsS"}'
POST payment HTTP/1.1
Host: 127.0.0.1:9090
{
  "amount": "10.05",
  "fee": "1.000001",
  "sender": "Qdxn4qW8kiPUiBnBSy9mbqMGBrBHRhK2JM",
  "recipient": "QhMaXFowsVqdAhvU2xkcLzuVaH5VDyEWsS"
}

Send a new payment using the given data.

Returns the transaction in JSON when successful.

REQUEST

POST payment

Errors

Error Description
1 Json error.
104 Invalid amount.
105 Invalid fee.
106 Invalid sender.
107 Invalid recipient.
201 Wallet does not exist.
203 Wallet is locked.

Post Name Payment

curl http://127.0.0.1:9090/namepayment
  -X POST
  -d '{"amount": "10.05","fee": "1.000001","sender": "Qdxn4qW8kiPUiBnBSy9mbqMGBrBHRhK2JM","recipient":"zerohour"}'
POST namepayment HTTP/1.1
Host: 127.0.0.1:9090
{
  "amount": "10.05",
  "fee": "1.000001",
  "sender": "Qdxn4qW8kiPUiBnBSy9mbqMGBrBHRhK2JM",
  "recipient": "zerohour"
}

Send a new namepayment using the given data.

Returns the transaction in JSON when successful.

REQUEST

POST namepayment

Errors

Error Description
1 Json error.
104 Invalid amount.
105 Invalid fee.
106 Invalid sender.
201 Wallet does not exist.
203 Wallet is locked.
701 Name not registered.
702 Name for sale.
703 Name with space.

Response Objects

Below you will find generic information regarding API responses.

Block

Sample response of a block.

Response

{
  "fee": "4.00000000",
  "transactions": [

  ],
  "timestamp": 1399319724713,
  "generatorSignature": "3k7jpRRCJNexhf8cdR7w1HAD7ppmo7DK2wzXBekFmKpwfVmZF5SiM9q8b5MwjCHtHmyoBTSXbq9iTodGxpf2qeri",
  "generatingBalance": 855786957,
  "generator": "QUDPJRGS8EreTvZWMDs5imyp3rAqU9hCPK",
  "reference": "HnhRcmrXp13dZwtP7T35Pzaav278pm8CDJmWRZStVpGVkzs6Bo4VnrbZ8XrouokReEKLGLZfLsbmodmRrhiJgkd3b67vDjgVMtKcR9WRRom8zHsE6FGvRgTv8pivBb3VrYDryECj96bpXgMqxPtZdmQUQHTUM1BA81XtUQukw5svw3K",
  "transactionsSignature": "2pE2sn7jGHruhHzv4gWmr1sdgTXCBv8nvAZKsHDaCJETLVPX7XYhaYPSfwr5pz6WsAC99QRhPQihBeDyWDDqLxQP",
  "signature": "F3Q5ihLGC2iFcS4RmRjbqSV85KWr13mXvSKDQCRBrBjG5h5n8hfd2sDWfLDSTiCrDhahojNmRQGKfwza57XFKs1vKFgK4xqQEAw7BjnEEAvvUWHndgE56LnaMDnfyGNfMGB3wfHNdQa8DQWoMptWbmUYKACzKyFEt2ssH6brknESgVM",
  "version": 1
}

Transaction Type 1

Genesis transaction

Response

{
  "fee": "0",
  "timestamp": 1399139274713,
  "amount": "500000000.00000000",
  "type": 1,
  "reference": "1",
  "confirmations": 0,
  "signature": "4GFHMAo9fmbUq7usopgntwUfAiLtpL98K6QCosAJsqQmY95tfd5KoUaKu34v6Qwp7RtYEhobCx7LVi7aYbbtpzfA",
  "recipient": "QQNFGuE8iZZ3sHjCnvvdbhfQHXokU8SgCX"
}

Transaction Type 2

Payment transaction

Response

{
  "fee": "1.00000000",
  "sender": "QRsraeFA9xiD3qVWiLSbxdcW2goUeGFVnF",
  "amount": "10.00000000",
  "timestamp": 1399656640390,
  "type": 2,
  "confirmations": 0,
  "reference": "keFP1SfTn4WVXgew1qUH6G8xmRrLaaSju65Ni36fhcSBMny8tMZjHc8BWdGMbjRRXmzNpBmi7JFwG1fPCMcvdkq",
  "signature": "wXrNfiDTamahSrMKNg96XAaAxojD5Nxm8gKPhM1qp2DzSMHvuaek5kzEQfHvzZe1AtxoQkbc5ELoEL5F4sXKNnt",
  "recipient": "QhMaXFowsVqdAhvU2xkcLzuVaH5VDyEWsS"
}

Transaction Type 3

Register name transaction

Response

{
  "fee": "1.00000000",
  "timestamp": 1399314215363,
  "registrant": "Qdxn4qW8kiPUiBnBSy9mbqMGBrBHRhK2JM",
  "name": "zerohour",
  "owner": "Qdxn4qW8kiPUiBnBSy9mbqMGBrBHRhK2JM",
  "value": "zerohour",
  "type": 3,
  "confirmations": 0,
  "reference": "5gE3vbzwDUbkR9YUem8RHVV3HcswrCX2ej9bA5MbJyaMrhQGXkFKqnvEtgq3s1vK3LizFEzCLz2HxJtdgULjMJRr",
  "signature": "5a1tyxSzX57sV6cqneyhTtWqV11pZPFsPqhTEPVqkNNFrrs1uCnG4DD3bUHar5PfJsF39YShxNCJYs1tZsFFtJoX"
}

Errors

When an error happens the API will return a HTTP message 400(bad request) combined with an error.

Response

HTTP/1.1 400 Bad Request
{
  "error"101: ,
  "message": "invalid signature"
}
Error Description
0 Unknown error.
1 Json error.
2 Not enough balance.
3 Not yet released.
101 Invalid signature.
102 Invalid address.
103 Invalid seed.
104 Invalid amount.
105 Invalid fee.
106 Invalid sender.
107 Invalid recipient.
108 Invalid name length.
109 Invalid value length.
110 Invalid name owner.
111 Invalid buyer.
112 Invalid public key.
113 Invalid options length.
114 Invalid option length.
115 Invalid data.
116 Invalid data length.
201 Wallet does not exist.
202 Address does not exist in wallet.
203 Wallet is locked
204 Wallet already exists.
301 Block does not exist.
311 Transaction does not exist.
401 Name does not exist.
402 Name already exists.
403 Name already for sale.
404 Name must be lower case.
410 Name is not for sale.
411 Buyer is already the owner.
501 Poll does not exist.
502 Poll already exists.
503 Duplicate option.
504 Polloption does not exist.
505 Already voted for that option.

Changelogs