Qora API Reference NAV
shell http

Introduction

This is the official API documentation of Qora.

Current version

Qora

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

Stop

curl "http://127.0.0.1:9085/qora/stop"
GET qora/stop HTTP/1.1
Host: 127.0.0.1:9085

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

REQUEST

GET qora/stop

Status

curl "http://127.0.0.1:9085/qora/status"
GET /qora/status HTTP/1.1
Host: 127.0.0.1:9085

Returns the status of the application

REQUEST

GET qora/status

Status Value
0 No connections
1 Synchronizing
2 Oke

Forging Status

curl "http://127.0.0.1:9085/qora/status/forging"
GET qora/status/forging HTTP/1.1
Host: 127.0.0.1:9085

Returns the forging status

REQUEST

GET qora/status/forging

Status Value
0 Forging Disabled
1 Forging Enabled
2 Forging

Is Up To Date

curl "http://127.0.0.1:9085/qora/isuptodate"
GET qora/isuptodate HTTP/1.1
Host: 127.0.0.1:9085

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

REQUEST

GET qora/isuptodate

Version

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

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:9085/seed"
GET seed HTTP/1.1
Host: 127.0.0.1:9085

Returns a base58 encoded random seed of 32 bytes

REQUEST

GET seed

Get Seed By Length

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

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:9085/peers"
GET peers HTTP/1.1
Host: 127.0.0.1:9085

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:9085/transactions"
GET transactions HTTP/1.1
Host: 127.0.0.1:9085

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:9085/transactions/limit/{limit}"
GET transactions/limit/{limit} HTTP/1.1
Host: 127.0.0.1:9085

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:9085/transactions/address/{address}"
GET transactions/address/{address} HTTP/1.1
Host: 127.0.0.1:9085

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:9085/transactions/address/{address}/limit/{limit}"
GET transactions/address/{address}/limit/{limit} HTTP/1.1
Host: 127.0.0.1:9085

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:9085/transactions/signature/{signature}"
GET transactions/signature/{signature} HTTP/1.1
Host: 127.0.0.1:9085

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:9085/transactions/network"
GET transactions/network HTTP/1.1
Host: 127.0.0.1:9085

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

REQUEST

GET transactions/network

Scan Transactions

curl "http://127.0.0.1:9085/transactions/scan"
  -d '{"blocklimit":1000,"transactionlimit":100,"type":2}'
  -X POST
POST transactions/scan HTTP/1.1
Host: 127.0.0.1:9085
{
  "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:9085/blocks"
GET blocks HTTP/1.1
Host: 127.0.0.1:9085

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:9085/blocks/address/{address}"
GET blocks/address/{address} HTTP/1.1
Host: 127.0.0.1:9085

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:9085/blocks/{signature}"
GET blocks/{signature} HTTP/1.1
Host: 127.0.0.1:9085

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:9085/blocks/first"
GET blocks/first HTTP/1.1
Host: 127.0.0.1:9085

Returns the genesis block.

REQUEST

GET blocks/first

Get Last Block

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

Returns the last valid block.

REQUEST

GET blocks/last

Get Child Block

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

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:9085/blocks/generatingbalance"
GET blocks/generatingbalance HTTP/1.1
Host: 127.0.0.1:9085

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:9085/blocks/generatingbalance/{signature}"
GET blocks/generatingbalance/{signature} HTTP/1.1
Host: 127.0.0.1:9085

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:9085/blocks/time"
GET blocks/time HTTP/1.1
Host: 127.0.0.1:9085

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:9085/blocks/height"
GET blocks/height HTTP/1.1
Host: 127.0.0.1:9085

Returns the block height of the last block.

REQUEST

GET blocks/height

Get Block Height By Signature

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

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:9085/blocks/byheight/{height}"
GET blocks/byheight/{height} HTTP/1.1
Host: 127.0.0.1:9085

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:9085/addresses"
GET addresses HTTP/1.1
Host: 127.0.0.1:9085

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:9085/addresses/validate/{address}"
GET addresses/validate/{address} HTTP/1.1
host: 127.0.0.1:9085

Validates the given address.Returns true/false.

REQUEST

GET addresses/validate/{address}

Get Address Seed

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

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:9085/addresses/new"
GET addresses/new HTTP/1.1
Host: 127.0.0.1:9085

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:9085/addresses"
  -X POST
  -d seed
POST addresses HTTP/1.1
Host: 127.0.0.1:9085
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:9085/addresses/{address}
  -X DELETE
DELETE addresses/{address} HTTP/1.1
Host: 127.0.0.1:9085

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:9085/addresses/balance/{address}"
GET addresses/balance/{address} HTTP/1.1
Host: 127.0.0.1:9085

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:9085/addresses/generatingbalance/{address}"
GET addresses/generatingbalance/{address} HTTP/1.1
Host: 127.0.0.1:9085

Return the generating balance of the given address.

REQUEST

GET addresses/generatingbalance/{address}

Get Asset Balance By Address

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

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:9085/addresses/balance/{address}/{confirmation}"
GET addresses/balance/{address}/{confirmation} HTTP/1.1
Host: 127.0.0.1:9085

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:9085/addresses/publickey/{address}"
GET addresses/publickey/{address} HTTP/1.1
Host: 127.0.0.1:9085

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:9085/addresses/sign/{address}"
  -X POST
  -d test
POST addresses/sign/{address} HTTP/1.1
Host: 127.0.0.1:9085
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:9085/addresses/verify/{address}"
  -X POST
  -d '{"message": "test","publickey": "6cWtyccawscvHhE5woPaLbDUc6qFaH7b7YuDJFrBvgJ3","signature":"2XuAEoUG2GmWJ8s5ZMZMK7csQ1nfHcqL5JYm3JBqetUAZKeT9mu7mSKYYMjLQoLBr5DqLCfaKXLQJnbzCLYCfC21"}'
POST addresses/verify/{address} HTTP/1.1
Host: 127.0.0.1:9085
{
  "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:9085/wallet"
GET wallet HTTP/1.1
Host: 127.0.0.1:9085

Response

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

Returns general information about the wallet.

REQUEST

GET wallet

Get Wallet Seed

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

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:9085/wallet/synchronize"
GET wallet/synchronize HTTP/1.1
Host: 127.0.0.1:9085

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:9085/wallet/lock"
GET wallet/lock HTTP/1.1
Host: 127.0.0.1:9085

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:9085/wallet/unlock"
  -X POST
  -d password
POST wallet/unlock HTTP/1.1
Host: 127.0.0.1:9085
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:9085/wallet"
  -X POST
  -d '{"seed": "FQgbSAm6swGbtqA3NE8PttijPhT4N3Ufh4bHFAkyVnQz","password": "cookies","recover": false,"amount": 10}'
POST wallet HTTP/1.1
Host: 127.0.0.1:9085
{
  "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/9085/payment"
  -X POST
  -d '{"amount":"10.05","fee":"1.000001","sender":"Qdxn4qW8kiPUiBnBSy9mbqMGBrBHRhK2JM","recipient":"QhMaXFowsVqdAhvU2xkcLzuVaH5VDyEWsS"}'
POST payment HTTP/1.1
Host: 127.0.0.1:9085
{
  "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:9085/namepayment
  -X POST
  -d '{"amount": "10.05","fee": "1.000001","sender": "Qdxn4qW8kiPUiBnBSy9mbqMGBrBHRhK2JM","recipient":"qora"}'
POST namepayment HTTP/1.1
Host: 127.0.0.1:9085
{
  "amount": "10.05",
  "fee": "1.000001",
  "sender": "Qdxn4qW8kiPUiBnBSy9mbqMGBrBHRhK2JM",
  "recipient": "qora"
}

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.

Names

Get Names

curl "http://127.0.0.1:9085/names"
GET names HTTP/1.1
Host: 127.0.0.1:9085

Returns an array of all the names owned by your accounts.

REQUEST

GET names

Get Names By Address

curl "http://127.0.0.1:9085/names/address/{address}"
GET names/address/{address} HTTP/1.1
Host: 127.0.0.1:9085

Returns an array of all the names owned by a specific address in your wallet.

REQUEST

GET names/address/{address}

Errors

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

Get Name Details

curl "http://127.0.0.1:9085/names/{name}"
GET names/{name} HTTP/1.1
Host: 127.0.0.1:9085

Response

HTTP/1.1 200 OK
Content-Type: application/json
{
  "owner": "QVeHoptRAeLj5DqGq2TKHVL4w51KFGS5R5",
  "name": "qora",
  "value": "http://qora.org"
}

Returns details about the given name

REQUEST

GET names/{name}

Errors

Error Description
401 Name does not exist.

Register Name

curl "http://127.0.0.1/9085/names"
  -X POST
  -d '{"name": "qora","value": "http://qora.org","registrant": "QVeHoptRAeLj5DqGq2TKHVL4w51KFGS5R5","fee": "1.00001"}'
POST names HTTP/1.1
Host: 127.0.0.1:9085
{
  "name": "qora",
  "value": "http://qora.org",
  "registrant": "QVeHoptRAeLj5DqGq2TKHVL4w51KFGS5R5",
  "fee": "1.00001"
}

Register a new name.

Returns the transaction in JSON when successful.

REQUEST

POST names

Errors

Error Description
1 Json error.
2 Not enough balance.
102 Invalid address.
105 Invalid fee.
108 Invalid name length.
109 Invalid value length.
201 Wallet does not exist.
203 Wallet is locked.
402 Name already exists.
404 Name must be lower case.

Update Name

curl "http://127.0.0.1:9085/names/{name}"
  -X POST
  -d '{"newvalue":"http://qora.net","newowner":"QVeHoptRAeLj5DqGq2TKHVL4w51KFGS5R5","fee":"1.00001"}'
POST names/{name} HTTP/1.1
Host: 127.0.0.1:9085
{
  "newvalue": "http://qora.net",
  "newowner": "QVeHoptRAeLj5DqGq2TKHVL4w51KFGS5R5",
  "fee": "1.00001"
}

Updates an existing name.

Returns the transaction in JSON when successful.

REQUEST

POST names/{name}

Errors

Error Description
1 Json error.
2 Not enough balance.
102 Invalid address.
105 Invalid fee.
108 Invalid name length.
109 Invalid value length.
201 Wallet does not exist.
203 Wallet is locked.
401 Name does not exist.
403 Name already for sale.

NameSales

Get Namesales

curl "http://127.0.0.1:9085/namesales"
GET namesales HTTP/1.1
Host: 127.0.0.1:9085

Returns an array of all the namesales owned by your accounts.

REQUEST

GET namesales

Errors

Error Description
201 Wallet does not exist.

Get Namesales By Address

curl "http://127.0.0.1:9085/namesales/address/{address}"
GET namesales/address/{address} HTTP/1.1
Host: 127.0.0.1:9085

Returns an array of all the namesales owned by a specific address in your wallet.

REQUEST

GET namesales/address/{address}

Errors

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

Get Sale Name Details

curl "http://127.0.0.1:9085/namesales/{name}"
GET namesales/{name} HTTP/1.1
Host: 127.0.0.1:9085

Return details about the given name that is for sale.

REQUEST

GET namesales/{name}

Errors

Error Description
410 Name is not for sale.

List Names

curl "http://127.0.0.1:9085/namesales/network"
GET namesales/network HTTP/1.1
Host: 127.0.0.1:9085

Response

HTTP/1.1 200 OK
Content-Type: application/json
[
  "qora",
  "test"
]

Returns an array of all the names that are for sale.

For performance this array only contains the keys of the names that are for sale and not the details.

REQUEST

GET namesales/network

Buy A Name

curl "http://127.0.0.1:9085/namesales/buy/{name}"
  -X POST
  -d '{"buyer":"QVeHoptRAeLj5DqGq2TKHVL4w51KFGS5R5","fee":"1.00001"}'
POST namesales/buy/{name} HTTP/1.1
Host: 127.0.0.1:9085
{
  "buyer": "QVeHoptRAeLj5DqGq2TKHVL4w51KFGS5R5",
  "fee": "1.00001"
}

Used to purchase the given name.

Returns the transaction in JSON when successful.

REQUEST

POST namesales/buy/{name}

Errors

Error Description
1 Json error.
2 Not enough balance.
102 Invalid address.
105 Invalid fee.
108 Invalid name length.
111 Invalid buyer.
201 Wallet does not exist.
203 Wallet is locked.
401 Name does not exist.
410 Name is not for sale.
411 Buyer is already the owner.

Sell A Name

curl "http://127.0.0.1:9085/namesales/{name}"
  -X POST
  -d '{"amount":"100","fee":"1.00001"}'
POST namesales/{name} HTTP/1.1
Host: 127.0.0.1:9085
{
  "amount": "100",
  "fee": "1.00001"
}

Used to sell the given name.Returns the transaction in JSON when successful.

REQUEST

POST namesales/{name}

Errors

Error Description
1 Json error.
2 Not enough balance.
102 Invalid address.
104 Invalid amount.
105 Invalid fee.
108 Invalid name length.
109 Invalid name owner.
201 Wallet does not exist.
203 Wallet is locked.
401 Name does not exist.
403 Name already for sale.

Cancel Sale Name

curl "http://127.0.0.1:9085/namesales/{name}/{fee}"
  -X DELETE
DELETE namesales/{name}/{fee} HTTP/1.1
Host: 127.0.0.1:9085

Used to cancel the sale of the given name.Returns the transaction in JSON when successful.

REQUEST

DELETE namesales/{name}/{fee}

Errors

Error Description
1 Json error.
2 Not enough balance.
102 Invalid address.
105 Invalid fee.
108 Invalid name length.
110 Invalid name owner.
201 Wallet does not exist.
203 Wallet is locked.
401 Name does not exist.
410 Name is not for sale.

Polls

Get Polls

curl "http://127.0.0.1:9085/polls"
GET polls HTTP/1.1
Host: 127.0.0.1:9085

Returns an array of all the polls created by your accounts.

REQUEST

GET polls

Errors

Error Description
201 Wallet does not exist.

Get Polls By Address

curl "http://127.0.0.1:9085/polls/address/{address}"
GET polls/address/{address} HTTP/1.1
Host: 127.0.0.1:9085

Returns an array of all the polls owned by a specific address in your wallet.

REQUEST

GET polls/address/{address}

Errors

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

Get Polls By Name

curl "http://127.0.0.1:9085/polls/{name}"
GET polls/{name} HTTP/1.1
Host: 127.0.0.1:9085

REQUEST

GET polls/{name}

Return details about the poll with the given name.

Errors

Error Description
501 Poll does not exist.

List Polls

curl "http://127.0.0.1:9085/polls/network"
GET polls/network HTTP/1.1
Host: 127.0.0.1:9085

Response

HTTP/1.1 200 OK
Content-Type: application/json
[
  "qora",
  "test"
]

REQUEST

GET polls/network

Returns an array of all the polls.

For performance this array only contains the names of the polls and not the details.

Vote

curl "http://127.0.0.1:9085polls/vote/{name}"
  -X POST
  -d '{"voter":"QNbA69dbnmwqJHLQeS9v63hSLZXXGkmtC6","option":"option one","fee":"1.00001"}'
POST polls/vote/{name} HTTP/1.1
Host: 127.0.0.1:9085
{
  "voter": "QNbA69dbnmwqJHLQeS9v63hSLZXXGkmtC6",
  "option": "option one",
  "fee": "1.00001"
}

Used to vote on a poll with the given name.

Returns the transaction in JSON when successful.

REQUEST

POST polls/vote/{name}

Errors

Error Description
1 Json error.
2 Not enough balance.
3 Not yet released.
102 Invalid address.
105 Invalid fee.
108 Invalid name length.
114 Invalid option length.
201 Wallet does not exist.
202 Address does not exist in wallet.
203 Wallet is locked.
404 Name must be lowercase.
501 Poll does not exist.
504 Polloption does not exist.
505 Already voted for that option.

Create Poll

curl "http://127.0.0.1:9085/polls"
  -X POST
  -d '{"creator":"QNbA69dbnmwqJHLQeS9v63hSLZXXGkmtC6","name":"testpoll","description":"this is a testpoll","options": ["option one","option two"],"fee":"1.00001"}'
POST polls HTTP/1.1
Host: 127.0.0.1:9085
{
  "creator": "QNbA69dbnmwqJHLQeS9v63hSLZXXGkmtC6",
  "name": "testpoll",
  "description": "this is a testpoll",
  "options": [
    "option one",
    "option two"
  ],
  "fee": "1.00001"
}

Used to create a new poll.

Returns the transaction in JSON when successful.

REQUEST

POST polls

Errors

Error Description
1 Json error.
2 Not enough balance.
3 Not yet released.
102 Invalid address.
105 Invalid fee.
108 Invalid name length.
109 Invalid description length.
113 Invalid options length.
114 Invalid option length.
201 Wallet does not exist.
202 Address does not exist in wallet.
203 Wallet is locked.
404 Name must be lowercase.
502 Poll already exists.
503 Duplicate option.

Arbitrary Transactions

Create Arbitrary Transaction

curl "http://127.0.0.1:9085/arbitrarytransactions"
  -X POST
  -d '{"creator":"QNbA69dbnmwqJHLQeS9v63hSLZXXGkmtC6","data":"4GFHMAo9fmbUq7usopgntwUfAiLtpL98K6QCosAJsqQmY95tfd5KoUaKu34v6Qwp7RtYEhobCx7LVi7aYbbtpzfA","service":555,"fee":"1.00001"}'
POST arbitrarytransactions HTTP/1.1
Host: 127.0.0.1:9085
{
  "creator": "QNbA69dbnmwqJHLQeS9v63hSLZXXGkmtC6",
  "data": "4GFHMAo9fmbUq7usopgntwUfAiLtpL98K6QCosAJsqQmY95tfd5KoUaKu34v6Qwp7RtYEhobCx7LVi7aYbbtpzfA",
  "service": 555,
  "fee": "1.00001"
}

Used to send an arbitrary transaction.

The data of the arbitrary transaction must be base58 encoded and must be between 1-4000 bytes.

Returns the transaction in JSON when successful.

REQUEST

POST arbitrarytransactions

Errors

Error Description
1 Json error.
2 Not enough balance.
3 Not yet released.
102 Invalid address.
105 Invalid fee.
115 Invalid data.
116 Invalid data length.
201 Wallet does not exist.
202 Address does not exist in wallet.
203 Wallet is locked.

Automated Transactions

Get AT

curl "http://127.0.0.1:9085/at"
GET at HTTP/1.1
Host: 127.0.0.1:9085

Returns an array of deployed AT scripts.

REQUEST

GET at

For performance this array only contains the addresses of the deployed AT scripts and not the details.

Get AT By ID

curl "http://127.0.0.1:9085/at/id/{id}"
GET at/id/{id} HTTP/1.1
Host: 127.0.0.1:9085

Response

HTTP/1.1 200 OK
Content-Type: application/json
{
  "tags": "acct,atomic cross chain tx,respond,responder",
  "accountBalance": "0.00000000",
  "description": "Responders BURST address: BURST-2Z98-XJU6-A2UA-FDKZP",
  "minActivation": "20.00000000",
  "name": "BURSTQORA @ 0.10",
  "state": {
    "stopped": "false",
    "machineData": "8e6a81f23b849c75d33f6398244d84881066c9cc09f9c3e1fe8c72710f64b62300000000b88301003a334bb82f7d8b71010c8c94148688024e5f2027fb0b930ca00000000000000001000000f48201000100000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
    "prevBalance": "0.00000000",
    "machineCode": "3501030900000006040000000900000029302009000000040000000f1ab4000000330403090000003525010a000000260a000000320903350703090000003526010a0000001b0a000000cd322801331601000000003317010100000033180102000000331901030000003505020a0000001b0a000000a1320b033205041e050000001833000509000000320a033203041ab400000033160105000000331701060000003318010700000033190108000000320304320b033203041ab70000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
    "finished": "false",
    "currentBalance": "0.00000000",
    "dead": "false",
    "frozen": "true",
    "running": "false"
  },
  "creationBlock": 99056,
  "type": "acct",
  "creator": "QVDVVphUiaQsEKVTXsNwsWbQvV6zTzeP2t",
  "version": 1
}

Returns the details of the given AT id.

REQUEST

GET at/id/{id}

Get AT By Creator

curl "http://127.0.0.1:9085/at/creator/{creator}"
GET at/creator/{creator} HTTP/1.1
Host: 127.0.0.1:9085

Response

HTTP/1.1 200 OK
Content-Type: application/json
[
  "AGvtqUUWEpBM8CeDFcPP7a9s42nE4RKwK7",
  "ALqEsn9ZysQqxmBvmvYCNTksrdNJLhjmrj"
]

Returns the IDs of the ATs created by the given creator.

REQUEST

GET at/creator/{creator}

Get AT By Type

curl "http://127.0.0.1:9085/at/type/{type}"
GET at/type/{type} HTTP/1.1
Host: 127.0.0.1:9085

Response

HTTP/1.1 200 OK
Content-Type: application/json
[
  "AGvtqUUWEpBM8CeDFcPP7a9s42nE4RKwK7",
  "AJMrqNG7LiwTquYtpXCuZbgzaD9hANSntn",
  "AJiK5MN1r1vtgCnjaDD7FWDfrQo3Gmsx1f",
  "ALHZt7FYS2RcFjJjmXGkqAF9dcVQuFTGdb",
  "ALqEsn9ZysQqxmBvmvYCNTksrdNJLhjmrj",
  "ASUn6hgiMYad1GPwiHodGgQvv6EkAadGiD"
]

Returns an array of the AT IDs for the given type.

REQUEST

GET at/type/{type}

Get Limited AT

curl "http://127.0.0.1:9085/at/limit/{limit}"
GET at/limit/{limit} HTTP/1.1
Host: 127.0.0.1:9085

Response

HTTP/1.1 200 OK
Content-Type: application/json
[
  "AGvtqUUWEpBM8CeDFcPP7a9s42nE4RKwK7",
  "ALqEsn9ZysQqxmBvmvYCNTksrdNJLhjmrj",
  "AVMvpJxRpdHxxEHcmnibDt6nYC3cBe8oH5",
  "AJiK5MN1r1vtgCnjaDD7FWDfrQo3Gmsx1f",
  "ALHZt7FYS2RcFjJjmXGkqAF9dcVQuFTGdb",
  "AJMrqNG7LiwTquYtpXCuZbgzaD9hANSntn",
  "ASUn6hgiMYad1GPwiHodGgQvv6EkAadGiD"
]

Returns an array of the AT IDs limited

REQUEST

GET at/limit/{limit}

Get AT Transactions

curl "http://127.0.0.1:9085/at/transactions/id/{id}"
GET at/transactions/id/{id} HTTP/1.1
Host: 127.0.0.1:9085

Response

HTTP/1.1 200 OK
Content-Type: application/json
[
  {
    "message": "",
    "amount": "1.20000000",
    "sender": "AGvtqUUWEpBM8CeDFcPP7a9s42nE4RKwK7",
    "blockHeight": 99057,
    "seq": 0,
    "recipient": "11111111111111111111111111"
  },
  {
    "message": "f596db64ca23c2c312658ee15a5d74eea858696e9279ecc1592982acdf6cfc68",
    "amount": "0.00000000",
    "sender": "AGvtqUUWEpBM8CeDFcPP7a9s42nE4RKwK7",
    "blockHeight": 99061,
    "seq": 0,
    "recipient": "QVDVVphUiaQsEKVTXsNwsWbQvV6zTzeP2t"
  },
  {
    "message": "",
    "amount": "50000.20000000",
    "sender": "AGvtqUUWEpBM8CeDFcPP7a9s42nE4RKwK7",
    "blockHeight": 99061,
    "seq": 1,
    "recipient": "QRHDHASWAXarqTvB2X4SNtJCWbxGf68M2o"
  },
  {
    "message": "",
    "amount": "18.60000000",
    "sender": "AGvtqUUWEpBM8CeDFcPP7a9s42nE4RKwK7",
    "blockHeight": 99061,
    "seq": 2,
    "recipient": "11111111111111111111111111"
  }
]

Returns the transactions of the given AT ID.

REQUEST

GET at/transactions/id/{id}

Get AT Transactions By Recipient

curl "http://127.0.0.1:9085/at/transactions/recipients/{address}"
GET at/transactions/recipients/{address} HTTP/1.1
Host: 127.0.0.1:9085

Response

HTTP/1.1 200 OK
Content-Type: application/json
[
  {
    "message": "",
    "amount": "50000.20000000",
    "sender": "AGvtqUUWEpBM8CeDFcPP7a9s42nE4RKwK7",
    "blockHeight": 99061,
    "seq": 1,
    "recipient": "QRHDHASWAXarqTvB2X4SNtJCWbxGf68M2o"
  },
  {
    "message": "",
    "amount": "50000.20000000",
    "sender": "ALqEsn9ZysQqxmBvmvYCNTksrdNJLhjmrj",
    "blockHeight": 99090,
    "seq": 1,
    "recipient": "QRHDHASWAXarqTvB2X4SNtJCWbxGf68M2o"
  }
]

Returns the AT transactions for the given recipient’s address.

REQUEST

GET at/transactions/recipients/{address}

Create AT

curl "http://127.0.0.1:9085/at"
  -X POST
  -d '{"creator":"","name":"","description":"","type":"","tags":"","fee":"","quantity":"","code":"","data":"","dpages":"","cspages":"","uspages":"","minActivationAmount":""}'
POST at HTTP/1.1
Host: 127.0.0.1:9085
{
  "creator":"",
  "name":"",
  "description":"",
  "type":"",
  "tags":"",
  "fee":"",
  "quantity":"",
  "code":"",
  "data":"",
  "dpages":"",
  "cspages":"",
  "uspages":"",
  "minActivationAmount":""

}

Deploys an AT with the given details.Returns the transaction when successful.

POST at

Errors

Error Description
1 Json error.
2 Not enough balance.
3 Not yet released.
102 Invalid address.
105 Invalid fee.
104 Invalid amount.
108 Invalid name length.
201 Wallet does not exist.
202 Address does not exist in wallet.
203 Wallet is locked.
801 Invalid desc length.
809 Invalid creation bytes.

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
}

Name

Sample response of the naming feature.

Response

{
  "name": "qora",
  "value": "qora",
  "owner": "QUDPJRGS8EreTvZWMDs5imyp3rAqU9hCPK"
}

NameSale

Sample response of the NameSale feature.

Response

{
  "amount": "500.0",
  "name": "qora",
  "seller": "QUDPJRGS8EreTvZWMDs5imyp3rAqU9hCPK"
}

Poll

Sample response of the Poll feature.

Response

{
  "creator": "QNbA69dbnmwqJHLQeS9v63hSLZXXGkmtC6",
  "description": "this is a testpoll",
  "name": "testpoll",
  "options": [
    {
      "name": "option one",
      "votes": "93393168.31001000",
      "voters": [
        "QNbA69dbnmwqJHLQeS9v63hSLZXXGkmtC6",
        "QgpH3K3ArkQTg15xjKqGq3BRgE3aNH9Q2P"
      ]
    },
    {
      "name": "option two",
      "votes": "8772354.53899000",
      "voters": [
        "QRyECqW54ywKVt4kZTEXyRY17aaFUaxzc4"
      ]
    }
  ]
}

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": "qora",
  "owner": "Qdxn4qW8kiPUiBnBSy9mbqMGBrBHRhK2JM",
  "value": "qora",
  "type": 3,
  "confirmations": 0,
  "reference": "5gE3vbzwDUbkR9YUem8RHVV3HcswrCX2ej9bA5MbJyaMrhQGXkFKqnvEtgq3s1vK3LizFEzCLz2HxJtdgULjMJRr",
  "signature": "5a1tyxSzX57sV6cqneyhTtWqV11pZPFsPqhTEPVqkNNFrrs1uCnG4DD3bUHar5PfJsF39YShxNCJYs1tZsFFtJoX"
}

Transaction Type 4

Update name transaction

Response

{
  "fee": "1.00000000",
  "newValue": "a",
  "timestamp": 1399656876336,
  "newOwner": "QNpfdoKjU3r3PDjYStQqKtjQ2CaxQWmzjZ",
  "name": "qora",
  "owner": "QVeHoptRAeLj5DqGq2TKHVL4w51KFGS5R5",
  "type": 4,
  "confirmations": 0,
  "reference": "42npsTYYydk798VwtJg4a5JR2g39FC2ASEHPhdYr4x2jq6eLw1au2mjc2gxmvghsPojEmhaEreksj174rw4Uthbg",
  "signature": "5s2fqKKnAa8cVkYVng3aF2SqxkKE1ArWKyUwBsTRz5tqRP6RfQXzcA6SNbaXNgGH4T62oh9QaXoB4xbASemHRSGV"
}

Transaction Type 5

Sell name transaction

Response

{
  "fee": "1.00000000",
  "amount": "500.0",
  "timestamp": 1399314220865,
  "name": "qora",
  "owner": "Qdxn4qW8kiPUiBnBSy9mbqMGBrBHRhK2JM",
  "type": 5,
  "confirmations": 0,
  "reference": "5a1tyxSzX57sV6cqneyhTtWqV11pZPFsPqhTEPVqkNNFrrs1uCnG4DD3bUHar5PfJsF39YShxNCJYs1tZsFFtJoX",
  "signature": "4L6XLyPCrAFChdzqmTCrGDp43yPiZk2Bn5Ch3YUUrGsXA8NuGo8dp7xQjsMNtRVSAtGdbXxsngTWmfM4ETVdTr6o"
}

Transaction Type 6

Cancel namesale transaction

Response

{
  "fee": "1.00000000",
  "timestamp": 1399657084324,
  "name": "qora",
  "owner": "QUDPJRGS8EreTvZWMDs5imyp3rAqU9hCPK",
  "type": 6,
  "confirmations": 0,
  "reference": "2yLvx23qZjBwFkyWFj6ScowYRBi15rzCwEvx1wDYpKonS9P7s13eZLCrC1tvau3uAfZKPFFdBvK9Utnb53hEjWJy",
  "signature": "4uNmBZ5aKkApMWvvAKKEpM3CBKCXPq1b3G615UmXfH3cMfVrFFZUURGCbnkc6n9ZfdFkuk6hxpJtZAnMz1KZstB6"
}

Transaction Type 7

Buy name transaction

Response

{
  "fee": "1.00000000",
  "amount": "500.0",
  "timestamp": 1399314260133,
  "name": "a",
  "buyer": "QVeHoptRAeLj5DqGq2TKHVL4w51KFGS5R5",
  "type": 7,
  "confirmations": 0,
  "reference": "PSG56nzDowqhYxzg2mmRXKcgxg8cBtyjEoTF37gXyCy4s3jXE6ygoRv81Sg7wTdHJ7xtwHD3uauWAEYKYGaxM7D",
  "signature": "42npsTYYydk798VwtJg4a5JR2g39FC2ASEHPhdYr4x2jq6eLw1au2mjc2gxmvghsPojEmhaEreksj174rw4Uthbg"
}

Transaction Type 8

Create Poll transaction

Response

{
  "fee": "1.00001000",
  "timestamp": 1403552417900,
  "confirmations": 0,
  "description": "this is a testpoll",
  "name": "testpoll",
  "type": 8,
  "reference": "3cXi7YQGihx1q75P1YMcgeGnqHY2PGbzpScasMy4UTZ1brTCFuQVKWvDW8Ywj7c3BDh7aLKBoHft79mGZkkzs7bq",
  "signature": "ofuYyAALXzR7x6Yhfh8HXkjDuqt2x5Ao9NP9QCtyRpmrd6A8CAXkb1GLQrntDA9zq",
  "creator": "QNbA69dbnmwqJHLQeS9v63hSLZXXGkmtC6",
  "options": [
    "option one",
    "option two"
  ]
}

Transaction Type 9

Vote on poll transaction

Response

{
  "fee": "1.00001000",
  "timestamp": 1403553008161,
  "poll": "testpoll",
  "confirmations": 0,
  "type": 9,
  "reference": "ofuYyAALXzR7x6Yhfh8HXkjDuz1t7XdZeM446ejPunjF5iEqt2x5Ao9NP9QCtyRpmrd6A8CAXkb1GLQrntDA9zq",
  "signature": "2kErpXY5EToBRk3coHVbnk5P4j5WixukDqedWhTJnCXsVFKy7samMta6QF7sgrcNbdk",
  "option": 0,
  "creator": "QNbA69dbnmwqJHLQeS9v63hSLZXXGkmtC6"
}

Transaction Type 10

Arbitrary transaction

Response

{
  "fee": "1.00001000",
  "timestamp": 1403553008161,
  "confirmations": 0,
  "type": 10,
  "reference": "ofuYyAALXzR7x6Yhfh8HXkjDuz1t7XdZeM446ejPunjF5iEqt2x5Ao9NP9QCtyRpmrd6A8CAXkb1GLQrntDA9zq",
  "signature": "2kErpXY5EToBRk3coHVbnk5P4j5WixukDqedWhTJnCXsVFKy7samMta6QF7sgrcNbdk",
  "creator": "QNbA69dbnmwqJHLQeS9v63hSLZXXGkmtC6",
  "service": 5555,
  "data": "3cXi7YQGihx1q75P1YMcgeGnqHY2PGbzpScasMy4UTZ1brTCFuQVKWvDW8Ywj7c3BDh7aLKBoHft79mGZkkzs7bq"
}

Transaction Type 11

Issue Asset transaction

Response

{
  "reference": "2YdxjuqN5N2de8iDcJgGZhBCGEVNxsgzhwEs23h41ywFDSXSkvvbNJCKYH8QRcg62AqozrJ7V9RZ1CDnTjzseKRB",
  "creator": "QWHDgD98axhWHctMnmoyQrY2QVmMQxXhnT",
  "quantity": 100,
  "signature": "3JeJ8yGnG8RCQH51S2qYJT5nfbokjHnBmM7KZsj61HPRy8K3ZWkGHh99QQ6HbRHxnknnjjAsffHRaeca1ap3tcFv",
  "divisible": false,
  "fee": "1.00000000",
  "name": "xxx",
  "description": "xxxxxxxxxxxxxxxxx",
  "type": 11,
  "confirmations": 69581,
  "timestamp": 1411223305891
}

Transaction Type 12

Transfer Asset transaction

Response

{
  "reference": "42KYmbw6HyEMKxV4onwtg24x3vUqVXMbSBEvAWYLn1mD9BEuWH92vFkF9fBBA8CMw9iQ6A2SYMLTp2FDKdKTxUfb",
  "amount": "1.00000000",
  "signature": "2pQhMmpLUsavrjpegtHo47AVgHhyHY1vK7GCwNX8fiqmspq593mtTSrhGAgcwkv2FkmWzg2u5wGki1p5wEJGBcbA",
  "sender": "Qc454HfRSVbrdLmhD1d9nmmMe45NbQmRnG",
  "fee": "1.00000000",
  "recipient": "QPB4YcxKV9DRs3dnypZ4zgJkPWcPhHsuGv",
  "type": 12,
  "confirmations": 67577,
  "asset": 2,
  "timestamp": 1411860064838
}

Transaction Type 13

Create Order Transaction

Response

{
  "reference": "LNiFt5dPCB2uaRetKJbxX38fG68LKdeVH2huyXKTVtdECRRjAYoV3NWANn5URVWyr6Drt1cpmfXGiNpbuoxufwX",
  "creator": "Qc454HfRSVbrdLmhD1d9nmmMe45NbQmRnG",
  "signature": "4EsGzQ87rXqXw2nic8LiihGCrM5iNErK53u9TRo2AJv4FWWyCK7bUKrCmswnrBbkB7Dsk7wfzi9hM2TGGqm6LVpd",
  "fee": "1.00000000",
  "type": 13,
  "confirmations": 69147,
  "timestamp": 1411364679566,
  "order": {
    "amount": "1.00000000",
    "price": "1.00000000",
    "want": 1,
    "have": 0
  }
}

Transaction Type 14

Cancel Order transaction

Response

{
  "reference": "4EsGzQ87rXqXw2nic8LiihGCrM5iNErK53u9TRo2AJv4FWWyCK7bUKrCmswnrBbkB7Dsk7wfzi9hM2TGGqm6LVpd",
  "creator": "Qc454HfRSVbrdLmhD1d9nmmMe45NbQmRnG",
  "signature": "2zoi8KKxuNpFg6zLgDs4H9fMRBFGgJg4tRjXEXqo3BUdijEJBPyCgWmgwRDMKVga84qKRLTnn2spXJMWnhNnJZZh",
  "fee": "1.00000000",
  "type": 14,
  "confirmations": 68989,
  "timestamp": 1411415120749,
  "order": "4EsGzQ87rXqXw2nic8LiihGCrM5iNErK53u9TRo2AJv4FWWyCK7bUKrCmswnrBbkB7Dsk7wfzi9hM2TGGqm6LVpd"
}

Transaction Type 15

Multi Payment Transaction

Response

{
  "reference": "cn4HPGW5zXdtcntBEvaqddQ9vVc33dYDBaPdejJW9NH6PXtyd3JNfughDDUNeftDaBreJd7y9t3ykLJY5UgyocG",
  "signature": "32VZ1kTmkx9RJyQZ5GSLqDBpjvx6Q6pcDwFPDqngc7btn2frGmoKkxKj84EtP4gTYmiNChpMysL5Uc7vQa6FpgsZ",
  "sender": "Qc454HfRSVbrdLmhD1d9nmmMe45NbQmRnG",
  "fee": "1.00000000",
  "payments": [
    {
      "amount": "4.85000000",
      "recipient": "Qc454HfRSVbrdLmhD1d9nmmMe45NbQmRnG",
      "asset": 0
    },
    {
      "amount": "0.10000000",
      "recipient": "QRWQ67MqGPDCHXF4kpBkfDfBT4EMbPNvEh",
      "asset": 0
    },
    {
      "amount": "0.05000000",
      "recipient": "QPB4YcxKV9DRs3dnypZ4zgJkPWcPhHsuGv",
      "asset": 0
    }
  ],
  "type": 15,
  "confirmations": 65753,
  "timestamp": 1412406922664
}

Transaction Type 16

Deploy Automated Transaction

Response

{
  "creator": "QVDVVphUiaQsEKVTXsNwsWbQvV6zTzeP2t",
  "amount": "50000.00000000",
  "signature": "vjbqxnSYvhXdBVewwBxeWdvdJmNpCbKR3121qJXSoLWjt6CPoxF95Br5ZU6pNHTB4McnojTxEzWTqj9P9Sac6Ph",
  "fee": "20.00000000",
  "description": "Responders BURST address: BURST-2Z98-XJU6-A2UA-FDKZP",
  "type": 16,
  "confirmations": 4183,
  "tags": "acct,atomic cross chain tx,respond,responder",
  "reference": "5U76JjucVSX6jMDZeNKVtFodbkuW8hLRc8Y734zcRPGH3cXwu7C6ChG264F2KDD8FagLtEszc9ATcdAeKLiB5VeJ",
  "name": "BURSTQORA @ 0.10",
  "creationBytes": "0100000001000100000000000094357700000000bf3501030900000006040000000900000029302009000000040000000f1ab4000000330403090000003525010a000000260a000000320903350703090000003526010a0000001b0a000000cd322801331601000000003317010100000033180102000000331901030000003505020a0000001b0a000000a1320b033205041e050000001833000509000000320a033203041ab400000033160105000000331701060000003318010700000033190108000000320304320b033203041ab7000000688e6a81f23b849c75d33f6398244d84881066c9cc09f9c3e1fe8c72710f64b62300000000c80000003a334bb82f7d8b71010c8c94148688024e5f2027fb0b930ca0000000000000000000000000000000000000000000000000000000000000000000000000000000",
  "atType": "acct",
  "timestamp": 1431878798556
}

Transaction Type 17

Message Transaction

Response

{
  "reference": "4DmLHDermRc73svaGyFQh52x5PL1JPi8cGcozoFigBzKcvNWNeTGwDdmAGvMW2XJVKf2jQP2xaqKoHGY95fn5BVU",
  "creator": "QRZ5Ggk6o5wwEgzL4Wo3xmueXuDEgwLeyQ",
  "amount": 1,
  "data": "ZuffoGowuh1gH8KNtqk8b52vedgrzQSU8dNmrdgpRsSq",
  "encrypted": "true",
  "signature": "239akGRkCxWtGFXkccqSe2MFBQDXcs5s3AgsCuCK7EqYNUKwMXhL6UrvpgASQePJAHBFyHQZGo2akiWbHuuCgNpn",
  "fee": "1.00000000",
  "recipient": "QVYmeUnZXNge838SqYKYWvAFBHst5N8u7A",
  "type": 17,
  "confirmations": 239,
  "isText": "true",
  "timestamp": 1433071935474
}

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