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.
REQUESTPOST 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. |