Suworld Developer Hub

JSON HTTP API

Getting Started

Introduction

The SUWORLD Developer APIs are provided as a service and without warranty, so please use what you need and no more. We support POST requests and there is a rate limit of 5 calls per sec/IP.

API Summary

To use the API service please create a Api-Key Token from within the Register API area which you can then use with all your api requests.
Kindly refer API Key Rate Limit & Errors for expected returns. Please contact us if you would like to upgrade your API Plan.

API Key Rate Limit & Errors:

API Call

During the enforcement of the API key requirement, developers will expect the return errors listed, where an API key is not in use or exceeding the rate limit.

The 5 calls per sec/IP rate limit is exceeded
An API request with a blank API Key or the default "ApiKey"
An API request with Invalid API Key
API requests with Invalid API Key exceeding limit

Node

nodeStatus

Returns node status


curl --request POST \
--url https://devapi.suworld.net \
--header 'content-type: application/json' \
--data '{"api":"YourApiKey","method":"nodeStatus"}'

var request = require("request");
var options = {
method: 'POST',
url: 'https://devapi.suworld.net',
headers: {'content-type': 'application/json'},
body: {"api":"YourApiKey","method":"nodeStatus"},
json: true
};
request(options, function (error, response, body) {
if (error) throw new Error(error);

console.log(body);
});

require 'uri'
require 'net/http'
require 'openssl'

url = URI("https://devapi.suworld.net")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_NONE

request = Net::HTTP::Post.new(url)
request["content-type"] = 'application/json'
request.body = "{"api":"YourApiKey","method":"nodeStatus"}"

response = http.request(request)
puts response.read_body

var data = JSON.stringify({
  "api":"YourApiKey","method":"nodeStatus"});

var xhr = new XMLHttpRequest();

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("POST", "https://devapi.suworld.net");
xhr.setRequestHeader("content-type", "application/json");

xhr.send(data);

import requests

url = "https://devapi.suworld.net"

payload = "{"api":"YourApiKey","method":"nodeStatus"}"
headers = {'content-type': 'application/json'}

response = requests.request("POST", url, data=payload, headers=headers)

print(response.text)

Results

200 OK Metadata

																			{"result":"S0001","data":{"ready":true,"timestamp":1587027784,"blocks":11336}}

Request Parameters

Field	Description	Type
none	none	none

Response

Field	Description	Type
result	Success(S0001) or Error(ER001 etc..)	String
ready	Must be true, otherwise Node is not ready to execute transactions	Boolean
timestamp	Timestamp of the Node	NumberString
blocks	Blockchain blocks	NumberString

getProtocolVersion

Returns node protocol version


curl --request POST \
--url https://devapi.suworld.net \
--header 'content-type: application/json' \
--data '{"api":"YourApiKey","method":"getProtocolVersion"}'

var request = require("request");
var options = {
method: 'POST',
url: 'https://devapi.suworld.net',
headers: {'content-type': 'application/json'},
body: {"api":"YourApiKey","method":"getProtocolVersion"},
json: true
};
request(options, function (error, response, body) {
if (error) throw new Error(error);

console.log(body);
});

require 'uri'
require 'net/http'
require 'openssl'

url = URI("https://devapi.suworld.net")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_NONE

request = Net::HTTP::Post.new(url)
request["content-type"] = 'application/json'
request.body = "{"api":"YourApiKey","method":"getProtocolVersion"}"

response = http.request(request)
puts response.read_body

var data = JSON.stringify({
  "api":"YourApiKey","method":"getProtocolVersion"});

var xhr = new XMLHttpRequest();

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("POST", "https://devapi.suworld.net");
xhr.setRequestHeader("content-type", "application/json");

xhr.send(data);

import requests

url = "https://devapi.suworld.net"

payload = "{"api":"YourApiKey","method":"getProtocolVersion"}"
headers = {'content-type': 'application/json'}

response = requests.request("POST", url, data=payload, headers=headers)

print(response.text)

Results

200 OK Metadata

																			{"result":"S0001","data":{"netprotocol":{"ver":1,"ver_a":1}}}

Request Parameters

Field	Description	Type
none	none	none

Response

Field	Description	Type
result	Success(S0001) or Error(ER001 etc..)	String
ver	Net protocol version	Integer
ver_a	Net protocol available	Integer

Block

getBlock

Get block information


curl --request POST \
--url https://devapi.suworld.net \
--header 'content-type: application/json' \
--data '{"api":"YourApiKey","method":"getBlock","params":{"block":8888}}'

var request = require("request");
var options = {
method: 'POST',
url: 'https://devapi.suworld.net',
headers: {'content-type': 'application/json'},
body: {"api":"YourApiKey","method":"getBlock","params":{"block":8888}},
json: true
};
request(options, function (error, response, body) {
if (error) throw new Error(error);

console.log(body);
});

require 'uri'
require 'net/http'
require 'openssl'

url = URI("https://devapi.suworld.net")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_NONE

request = Net::HTTP::Post.new(url)
request["content-type"] = 'application/json'
request.body = "{"api":"YourApiKey","method":"getBlock","params":{"block":8888}}"

response = http.request(request)
puts response.read_body

var data = JSON.stringify({
  "api":"YourApiKey","method":"getBlock","params":{"block":8888}});

var xhr = new XMLHttpRequest();

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("POST", "https://devapi.suworld.net");
xhr.setRequestHeader("content-type", "application/json");

xhr.send(data);

import requests

url = "https://devapi.suworld.net"

payload = "{"api":"YourApiKey","method":"getBlock","params":{"block":8888}}"
headers = {'content-type': 'application/json'}

response = requests.request("POST", url, data=payload, headers=headers)

print(response.text)

Results

200 OK Metadata

																			{"result":"S0001","data":{"block":8888,"ver":1,"ver_a":1,"timestamp":1592211422,"createwallet":0,"nopsp":"0","niopsp":"0","reward":"59455336615217638620","blocksize":3261,"hash":"0x017F60AAF6EDDC74C6EB96BDA4F09329AFD50F7755A72F57298D21A8DD69DE79""trx_fee":"0","operations":13}}

Request Parameters

Field	Description	Type
block	Block number (0..blocks count-1)	NumberString

Response

Field	Description	Type
result	Success(S0001) or Error(ER001 etc..)	String
block	Block number	NumberString
ver	Net protocol version	Integer
ver_a	Net protocol available	Integer
timestamp	Timestamp of the Node	NumberString
createwallet	Created wallet number of block	Integer
nopsp	Action value of block	Integer
niopsp	InAction value of block	Integer
reward	Mined reward of block	NumberString
blocksize	Size of block	Integer
hash	Hash of block	String
trx_fee	Transaction Fee of block	NumberString
operations	Transaction count of block	Integer

getBlcokCount

Get chain high in this node


curl --request POST \
--url https://devapi.suworld.net \
--header 'content-type: application/json' \
--data '{"api":"YourApiKey","method":"getBlcokCount"}'

var request = require("request");
var options = {
method: 'POST',
url: 'https://devapi.suworld.net',
headers: {'content-type': 'application/json'},
body: {"api":"YourApiKey","method":"getBlcokCount"},
json: true
};
request(options, function (error, response, body) {
if (error) throw new Error(error);

console.log(body);
});

require 'uri'
require 'net/http'
require 'openssl'

url = URI("https://devapi.suworld.net")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_NONE

request = Net::HTTP::Post.new(url)
request["content-type"] = 'application/json'
request.body = "{"api":"YourApiKey","method":"getBlcokCount"}"

response = http.request(request)
puts response.read_body

var data = JSON.stringify({
  "api":"YourApiKey","method":"getBlcokCount"});

var xhr = new XMLHttpRequest();

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("POST", "https://devapi.suworld.net");
xhr.setRequestHeader("content-type", "application/json");

xhr.send(data);

import requests

url = "https://devapi.suworld.net"

payload = "{"api":"YourApiKey","method":"getBlcokCount"}"
headers = {'content-type': 'application/json'}

response = requests.request("POST", url, data=payload, headers=headers)

print(response.text)

Results

200 OK Metadata

																			{"result":"S0001","data":4153118}

Request Parameters

Field	Description	Type
none	none	none

Response

Field	Description	Type
result	Success(S0001) or Error(ER001 etc..)	String
data	Returns an Integer with blockcount of node	NumberString

getBlcokTransactions

Get operations of specified block


curl --request POST \
--url https://devapi.suworld.net \
--header 'content-type: application/json' \
--data '{"api":"YourApiKey","method":"getBlcokTransactions","params":{"block":8888,"max":300}}'

var request = require("request");
var options = {
method: 'POST',
url: 'https://devapi.suworld.net',
headers: {'content-type': 'application/json'},
body: {"api":"YourApiKey","method":"getBlcokTransactions","params":{"block":8888,"max":300}},
json: true
};
request(options, function (error, response, body) {
if (error) throw new Error(error);

console.log(body);
});

require 'uri'
require 'net/http'
require 'openssl'

url = URI("https://devapi.suworld.net")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_NONE

request = Net::HTTP::Post.new(url)
request["content-type"] = 'application/json'
request.body = "{"api":"YourApiKey","method":"getBlcokTransactions","params":{"block":8888,"max":300}}"

response = http.request(request)
puts response.read_body

var data = JSON.stringify({
  "api":"YourApiKey","method":"getBlcokTransactions","params":{"block":8888,"max":300}});

var xhr = new XMLHttpRequest();

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("POST", "https://devapi.suworld.net");
xhr.setRequestHeader("content-type", "application/json");

xhr.send(data);

import requests

url = "https://devapi.suworld.net"

payload = "{"api":"YourApiKey","method":"getBlcokTransactions","params":{"block":8888,"max":300}}"
headers = {'content-type': 'application/json'}

response = requests.request("POST", url, data=payload, headers=headers)

print(response.text)

Results

200 OK Metadata

																			{"result":"S0001","data": [{"block":8888,"opblock":0,"optype":1,"nopsp":20,"niopsp":0,"oprice":25,"iopprice":0,"signer_account":43905,"n_operation":5,"amount":100,"senders":[{"account":43905,"payload":"asd","payload_type":0}],"receivers":[{"account":43906}],}]}

Request Parameters

Field	Description	Type
block	Block number (0..blocks count-1)	NumberString
max	Maximum number of transactions	Integer

Response

Field	Description	Type
result	Success(S0001) or Error(ER001 etc..)	String
block	Block number (0..blocks count-1)	NumberString
opblock	Transaction (0..transactions-1) of this block	Integer
optype	Transaction type	Integer
nopsp	Action value	Integer
niopsp	InAction value	Integer
oprice	Action Price	NumberString
iopprice	InAction Price	NumberString
signer_account	Will return the account that signed (and payed fee) for this transaction	Integer
n_operation	Transactions made by this account	Integer
amount	Amount of coins transferred from senders_account to receivers_account	NumberString

Wallet

newWallet

Adds a new key to the Wallet


curl --request POST \
--url https://devapi.suworld.net \
--header 'content-type: application/json' \
--data '{"api":"YourApiKey","method":"newWallet","params":{"passphrase":"password"}}'

var request = require("request");
var options = {
method: 'POST',
url: 'https://devapi.suworld.net',
headers: {'content-type': 'application/json'},
body: {"api":"YourApiKey","method":"newWallet","params":{"passphrase":"password"}},
json: true
};
request(options, function (error, response, body) {
if (error) throw new Error(error);

console.log(body);
});

require 'uri'
require 'net/http'
require 'openssl'

url = URI("https://devapi.suworld.net")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_NONE

request = Net::HTTP::Post.new(url)
request["content-type"] = 'application/json'
request.body = "{"api":"YourApiKey","method":"newWallet","params":{"passphrase":"password"}}"

response = http.request(request)
puts response.read_body

var data = JSON.stringify({
  "api":"YourApiKey","method":"newWallet","params":{"passphrase":"password"}});

var xhr = new XMLHttpRequest();

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("POST", "https://devapi.suworld.net");
xhr.setRequestHeader("content-type", "application/json");

xhr.send(data);

import requests

url = "https://devapi.suworld.net"

payload = "{"api":"YourApiKey","method":"newWallet","params":{"passphrase":"password"}}"
headers = {'content-type': 'application/json'}

response = requests.request("POST", url, data=payload, headers=headers)

print(response.text)

Results

200 OK Metadata

																			{"result":"S0001","data":{"wallet":"SWG2LHXBHUr17SYoUpCYCvB9eXzschJbHzM4XPVNnMNvxpj7","version":1,"pkey":"WalletPrivateKey"}}

Request Parameters

Field	Description	Type
passphrase	Walelt password	String

Response

Field	Description	Type
result	Success(S0001) or Error(ER001 etc..)	String
wallet	Walelt Address	String
version	Wallet version	Integer
pkey	Walelt PrivateKey	String

getWalletInfo

Get infomation of specified wallet


curl --request POST \
--url https://devapi.suworld.net \
--header 'content-type: application/json' \
--data '{"api":"YourApiKey","method":"getWalletInfo","params":{"wallet":"SWZNDY8AeRH6G75HDmgyLRo9ghXsTSQxAvmSFH93pGMyp45a"}}'

var request = require("request");
var options = {
method: 'POST',
url: 'https://devapi.suworld.net',
headers: {'content-type': 'application/json'},
body: {"api":"YourApiKey","method":"getWalletInfo","params":{"wallet":"SWZNDY8AeRH6G75HDmgyLRo9ghXsTSQxAvmSFH93pGMyp45a"}},
json: true
};
request(options, function (error, response, body) {
if (error) throw new Error(error);

console.log(body);
});

require 'uri'
require 'net/http'
require 'openssl'

url = URI("https://devapi.suworld.net")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_NONE

request = Net::HTTP::Post.new(url)
request["content-type"] = 'application/json'
request.body = "{"api":"YourApiKey","method":"getWalletInfo","params":{"wallet":"SWZNDY8AeRH6G75HDmgyLRo9ghXsTSQxAvmSFH93pGMyp45a"}}"

response = http.request(request)
puts response.read_body

var data = JSON.stringify({
  "api":"YourApiKey","method":"getWalletInfo","params":{"wallet":"SWZNDY8AeRH6G75HDmgyLRo9ghXsTSQxAvmSFH93pGMyp45a"}});

var xhr = new XMLHttpRequest();

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("POST", "https://devapi.suworld.net");
xhr.setRequestHeader("content-type", "application/json");

xhr.send(data);

import requests

url = "https://devapi.suworld.net"

payload = "{"api":"YourApiKey","method":"getWalletInfo","params":{"wallet":"SWZNDY8AeRH6G75HDmgyLRo9ghXsTSQxAvmSFH93pGMyp45a"}}"
headers = {'content-type': 'application/json'}

response = requests.request("POST", url, data=payload, headers=headers)

print(response.text)

Results

200 OK Metadata

																			{"result":"S0001","data":{"account":102,"updated_active":2926,"updated_passive":2926,"n_operation":1,"balance":"100000000000000000","wallet":"SWZNDY8AeRH6G75HDmgyLRo9ghXsTSQxAvmSFH93pGMyp45a","state":"normal wallet",state_code":1}}

Request Parameters

Field	Description	Type
wallet	Walelt Address	String

Response

Field	Description	Type
result	Success(S0001) or Error(ER001 etc..)	String
account	Wallet Number	Integer
updated_active	Wallet active Block	NumberString
updated_passive	Wallet passive Block	NumberString
n_operation	Transactions made by this account	Integer
balance	Wallet SUC quantity	NumberString
wallet	Walelt Address	String
state	Walelt Status	String
state_code	Walelt Status Code	String

Transaction

sendTo

Executes a transaction


curl --request POST \
--url https://devapi.suworld.net \
--header 'content-type: application/json' \
--data '{"api":"YourApiKey","method":"sendTo","params":{"sender":"SWHgyqvvaiShRfvKbTw5jD5Kz7M1G6dQbnvoUxVKFvDnZtwi","receiver":"SWEk7bHfhZFg5GoZgftb18J8SKkDQbBpPA7g36dbPSambfAY","amount":1000,"passphrase":"password"}}'

var request = require("request");
var options = {
method: 'POST',
url: 'https://devapi.suworld.net',
headers: {'content-type': 'application/json'},
body: {"api":"YourApiKey","method":"sendTo","params":{"sender":"SWHgyqvvaiShRfvKbTw5jD5Kz7M1G6dQbnvoUxVKFvDnZtwi","receiver":"SWEk7bHfhZFg5GoZgftb18J8SKkDQbBpPA7g36dbPSambfAY","amount":1000,"passphrase":"password"}},
json: true
};
request(options, function (error, response, body) {
if (error) throw new Error(error);

console.log(body);
});

require 'uri'
require 'net/http'
require 'openssl'

url = URI("https://devapi.suworld.net")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_NONE

request = Net::HTTP::Post.new(url)
request["content-type"] = 'application/json'
request.body = "{"api":"YourApiKey","method":"sendTo","params":{"sender":"SWHgyqvvaiShRfvKbTw5jD5Kz7M1G6dQbnvoUxVKFvDnZtwi","receiver":"SWEk7bHfhZFg5GoZgftb18J8SKkDQbBpPA7g36dbPSambfAY","amount":1000,"passphrase":"password"}}"

response = http.request(request)
puts response.read_body

var data = JSON.stringify({
  "api":"YourApiKey","method":"sendTo","params":{"sender":"SWHgyqvvaiShRfvKbTw5jD5Kz7M1G6dQbnvoUxVKFvDnZtwi","receiver":"SWEk7bHfhZFg5GoZgftb18J8SKkDQbBpPA7g36dbPSambfAY","amount":1000,"passphrase":"password"}});

var xhr = new XMLHttpRequest();

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("POST", "https://devapi.suworld.net");
xhr.setRequestHeader("content-type", "application/json");

xhr.send(data);

import requests

url = "https://devapi.suworld.net"

payload = "{"api":"YourApiKey","method":"sendTo","params":{"sender":"SWHgyqvvaiShRfvKbTw5jD5Kz7M1G6dQbnvoUxVKFvDnZtwi","receiver":"SWEk7bHfhZFg5GoZgftb18J8SKkDQbBpPA7g36dbPSambfAY","amount":1000,"passphrase":"password"}}"
headers = {'content-type': 'application/json'}

response = requests.request("POST", url, data=payload, headers=headers)

print(response.text)

Results

200 OK Metadata

																			{"result":"S0001","data": {"time":1476363846,"sender":"SWovpcsg6ijJhwMDf1UKyNT7AhTEEpSFeaxZbhk2BYfknU2Q","receiver":"SWiMyhPLdF377H4YPHW8Z5RKVNE5nK2RKcgn3NXqyw7dovUT","amount":1000, "fee":0.0001,"balance":150605.9999,"ophash":"000000006C8D0100010000003536463332393641383335344236323945464536"}}

Request Parameters

Field	Description	Type
sender	Sender walelt Address	String
receiver	Receiver walelt Address	String
amount	Amount of coins transferred from sender to receiver	NumberString
passphrase	Sender walelt password	String

Response

Field	Description	Type
result	Success(S0001) or Error(ER001 etc..)	String
sender	Sender walelt Address	String
receiver	Receiver walelt Address	String
amount	Amount of coins transferred from sender to receiver	NumberString
fee	Transaction Fee	NumberString
balance	Remaining balance	NumberString
ophash	Transaction hash	String

getPendingTransaction

Get pendings transaction to be included in the chain


curl --request POST \
--url https://devapi.suworld.net \
--header 'content-type: application/json' \
--data '{"api":"YourApiKey","method":"getPendingTransaction","params":{"max":100}}'

var request = require("request");
var options = {
method: 'POST',
url: 'https://devapi.suworld.net',
headers: {'content-type': 'application/json'},
body: {"api":"YourApiKey","method":"getPendingTransaction","params":{"max":100}},
json: true
};
request(options, function (error, response, body) {
if (error) throw new Error(error);

console.log(body);
});

require 'uri'
require 'net/http'
require 'openssl'

url = URI("https://devapi.suworld.net")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_NONE

request = Net::HTTP::Post.new(url)
request["content-type"] = 'application/json'
request.body = "{"api":"YourApiKey","method":"getPendingTransaction","params":{"max":100}}"

response = http.request(request)
puts response.read_body

var data = JSON.stringify({
  "api":"YourApiKey","method":"getPendingTransaction","params":{"max":100}});

var xhr = new XMLHttpRequest();

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("POST", "https://devapi.suworld.net");
xhr.setRequestHeader("content-type", "application/json");

xhr.send(data);

import requests

url = "https://devapi.suworld.net"

payload = "{"api":"YourApiKey","method":"getPendingTransaction","params":{"max":100}}"
headers = {'content-type': 'application/json'}

response = requests.request("POST", url, data=payload, headers=headers)

print(response.text)

Results

200 OK Metadata

																			{"result":"S0001","data": [{"optype":1,"nopsp":20,"niopsp":0,"oprice":25,"iopprice":0,"signer_account":43905,"n_operation":5,"amount":0,"senders":[{"account":43905,"payload":"asd","payload_type":0}],"receivers":[{"account":43906}]}]}

Request Parameters

Field	Description	Type
max	Get transaction count	Integer

Response

Field	Description	Type
result	Success(S0001) or Error(ER001 etc..)	String
optype	Transaction type	Integer
nopsp	Action value	Integer
niopsp	InAction value	Integer
oprice	Action Price	NumberString
iopprice	InAction Price	NumberString
signer_account	Will return the account that signed (and payed fee) for this transaction	Integer
n_operation	Transactions made by this account	Integer
amount	Amount of coins transferred from senders_account to receivers_account	NumberString

findWalletTransaction

Get transactions made to an wallet


curl --request POST \
--url https://devapi.suworld.net \
--header 'content-type: application/json' \
--data '{"api":"YourApiKey","method":"findWalletTransaction","params":{"wallet":"SWG2LHXBHUr17SYoUpCYCvB9eXzschJbHzM4XPVNnMNvxpj7","start":8888,"max":100}}'

var request = require("request");
var options = {
method: 'POST',
url: 'https://devapi.suworld.net',
headers: {'content-type': 'application/json'},
body: {"api":"YourApiKey","method":"findWalletTransaction","params":{"wallet":"SWG2LHXBHUr17SYoUpCYCvB9eXzschJbHzM4XPVNnMNvxpj7","start":8888,"max":100}},
json: true
};
request(options, function (error, response, body) {
if (error) throw new Error(error);

console.log(body);
});

require 'uri'
require 'net/http'
require 'openssl'

url = URI("https://devapi.suworld.net")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_NONE

request = Net::HTTP::Post.new(url)
request["content-type"] = 'application/json'
request.body = "{"api":"YourApiKey","method":"findWalletTransaction","params":{"wallet":"SWG2LHXBHUr17SYoUpCYCvB9eXzschJbHzM4XPVNnMNvxpj7","start":8888,"max":100}}"

response = http.request(request)
puts response.read_body

var data = JSON.stringify({
  "api":"YourApiKey","method":"findWalletTransaction","params":{"wallet":"SWG2LHXBHUr17SYoUpCYCvB9eXzschJbHzM4XPVNnMNvxpj7","start":8888,"max":100}});

var xhr = new XMLHttpRequest();

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("POST", "https://devapi.suworld.net");
xhr.setRequestHeader("content-type", "application/json");

xhr.send(data);

import requests

url = "https://devapi.suworld.net"

payload = "{"api":"YourApiKey","method":"findWalletTransaction","params":{"wallet":"SWG2LHXBHUr17SYoUpCYCvB9eXzschJbHzM4XPVNnMNvxpj7","start":8888,"max":100}}"
headers = {'content-type': 'application/json'}

response = requests.request("POST", url, data=payload, headers=headers)

print(response.text)

Results

200 OK Metadata

																			{"result":"S0001","data": [{"block":8888,"opblock":0,"optype":1,"nopsp":20,"niopsp":0,"oprice":25,"iopprice":0,"signer_account":43905,"n_operation":5,"amount":100,"senders":[{"account":43905,"payload":"asd","payload_type":0}],"receivers":[{"account":43906}],}]}

Request Parameters

Field	Description	Type
wallet	Walelt Address	String
start	Start at position(Max Blockcount is 0)	NumberString
max	Get transaction count	Integer

Response

Field	Description	Type
result	Success(S0001) or Error(ER001 etc..)	String
block	Block number (0..blocks count-1)	NumberString
opblock	Transaction (0..transactions-1) of this block	Integer
optype	Transaction type	Integer
nopsp	Action value	Integer
niopsp	InAction value	Integer
oprice	Action Price	NumberString
iopprice	InAction Price	NumberString
signer_account	Will return the account that signed (and payed fee) for this transaction	Integer
n_operation	Transactions made by this account	Integer
amount	Amount of coins transferred from senders_account to receivers_account	NumberString

getFee

Transaction fee calculated by chain


curl --request POST \
--url https://devapi.suworld.net \
--header 'content-type: application/json' \
--data '{"api":"YourApiKey","method":"getFee"}'

var request = require("request");
var options = {
method: 'POST',
url: 'https://devapi.suworld.net',
headers: {'content-type': 'application/json'},
body: {"api":"YourApiKey","method":"getFee"},
json: true
};
request(options, function (error, response, body) {
if (error) throw new Error(error);

console.log(body);
});

require 'uri'
require 'net/http'
require 'openssl'

url = URI("https://devapi.suworld.net")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_NONE

request = Net::HTTP::Post.new(url)
request["content-type"] = 'application/json'
request.body = "{"api":"YourApiKey","method":"getFee"}"

response = http.request(request)
puts response.read_body

var data = JSON.stringify({
  "api":"YourApiKey","method":"getFee"});

var xhr = new XMLHttpRequest();

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("POST", "https://devapi.suworld.net");
xhr.setRequestHeader("content-type", "application/json");

xhr.send(data);

import requests

url = "https://devapi.suworld.net"

payload = "{"api":"YourApiKey","method":"getFee"}"
headers = {'content-type': 'application/json'}

response = requests.request("POST", url, data=payload, headers=headers)

print(response.text)

Results

200 OK Metadata

																			{"result":"S0001","data": {"oprice":25,"iopprice":0}}

Request Parameters

Field	Description	Type
none	none	none

Response

Field	Description	Type
result	Success(S0001) or Error(ER001 etc..)	String
oprice	Action Price	NumberString
iopprice	InAction Price	NumberString

Contract

createContract

Executes create contract over an wallet


curl --request POST \
--url https://devapi.suworld.net \
--header 'content-type: application/json' \
--data '{"api":"YourApiKey","method":"createContract","params":{"wallet":"SWGT2A8gY37RkBedzrX1rwi61H8ZBECSx52r1CmRdeGDjdyS","passphrase":"password","business":"true","name":"TESTCOIN","symbol":"TCN","totalAmount":"100000","decimal":"18","summary":"TEST COIN IS TEST"}}'

var request = require("request");
var options = {
method: 'POST',
url: 'https://devapi.suworld.net',
headers: {'content-type': 'application/json'},
body: {"api":"YourApiKey","method":"createContract","params":{"wallet":"SWGT2A8gY37RkBedzrX1rwi61H8ZBECSx52r1CmRdeGDjdyS","passphrase":"password","business":"true","name":"TESTCOIN","symbol":"TCN","totalAmount":"100000","decimal":"18","summary":"TEST COIN IS TEST"}},
json: true
};
request(options, function (error, response, body) {
if (error) throw new Error(error);

console.log(body);
});

require 'uri'
require 'net/http'
require 'openssl'

url = URI("https://devapi.suworld.net")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_NONE

request = Net::HTTP::Post.new(url)
request["content-type"] = 'application/json'
request.body = "{"api":"YourApiKey","method":"createContract","params":{"wallet":"SWGT2A8gY37RkBedzrX1rwi61H8ZBECSx52r1CmRdeGDjdyS","passphrase":"password","business":"true","name":"TESTCOIN","symbol":"TCN","totalAmount":"100000","decimal":"18","summary":"TEST COIN IS TEST"}}"

response = http.request(request)
puts response.read_body

var data = JSON.stringify({
  "api":"YourApiKey","method":"createContract","params":{"wallet":"SWGT2A8gY37RkBedzrX1rwi61H8ZBECSx52r1CmRdeGDjdyS","passphrase":"password","business":"true","name":"TESTCOIN","symbol":"TCN","totalAmount":"100000","decimal":"18","summary":"TEST COIN IS TEST"}});

var xhr = new XMLHttpRequest();

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("POST", "https://devapi.suworld.net");
xhr.setRequestHeader("content-type", "application/json");

xhr.send(data);

import requests

url = "https://devapi.suworld.net"

payload = "{"api":"YourApiKey","method":"createContract","params":{"wallet":"SWGT2A8gY37RkBedzrX1rwi61H8ZBECSx52r1CmRdeGDjdyS","passphrase":"password","business":"true","name":"TESTCOIN","symbol":"TCN","totalAmount":"100000","decimal":"18","summary":"TEST COIN IS TEST"}}"
headers = {'content-type': 'application/json'}

response = requests.request("POST", url, data=payload, headers=headers)

print(response.text)

Results

200 OK Metadata

																			{"result":"S0001","data":{"cwallet":"SW4R9entgziXv6hLeJBSGLJLLj9o6DwtBxVATui3vNBBuumz","block":0,"time":1596431621,"opblock":0,"maturation":null,"optype":6,"nopsp":369748,"oprice":"","signer_account":2,"n_operation":7,"optxt":"Create Business Contract Name:'TESTCOIN',Symbol:'TCN'","ophash":"00000000020000000700000004F3BE23CB0C58C16F37074663339EC4F3627E44"}}

Request Parameters

Field	Description	Type
wallet	Issuer walelt Address	String
passphrase	Walelt password	String
business	Business or Normal Contract	Boolean
name	Contract Name	String
symbol	Contract Symbol	String
totalAmount	Issue Amount	String
decimal	Token decimal	String
summary	Contract Description	String

Response

Field	Description	Type
result	Success(S0001) or Error(ER001 etc..)	String
cwallet	Contract walelt Address	String
block	Block number (0..blocks count-1)	NumberString
opblock	Transaction (0..transactions-1) of this block	Integer
optype	Transaction type	Integer
nopsp	Action value	Integer
oprice	Action Price	NumberString
signer_account	Will return the account that signed (and payed fee) for this transaction	Integer
n_operation	Transactions made by this account	Integer
ophash	Transaction hash	String
optxt	Contract Description	String
name	Contract Name	String
symbol	Contract Symbol	String

sendContract

Executes a contract transaction


curl --request POST \
--url https://devapi.suworld.net \
--header 'content-type: application/json' \
--data '{"api":"YourApiKey","method":"sendContract","params":{"sender":"SWGT2A8gY37RkBedzrX1rwi61H8ZBECSx52r1CmRdeGDjdyS","receiver":"SWogTJtxnqQD3emG57S759CzAKnxDTGwgeSGoUbfqRsKaYQL","amount":"100","contract":"SW4R9entgziXv6hLeJBSGLJLLj9o6DwtBxVATui3vNBBuumz","passphrase":"password","payload":"hi"}}'

var request = require("request");
var options = {
method: 'POST',
url: 'https://devapi.suworld.net',
headers: {'content-type': 'application/json'},
body: {"api":"YourApiKey","method":"sendContract","params":{"sender":"SWGT2A8gY37RkBedzrX1rwi61H8ZBECSx52r1CmRdeGDjdyS","receiver":"SWogTJtxnqQD3emG57S759CzAKnxDTGwgeSGoUbfqRsKaYQL","amount":"100","contract":"SW4R9entgziXv6hLeJBSGLJLLj9o6DwtBxVATui3vNBBuumz","passphrase":"password","payload":"hi"}},
json: true
};
request(options, function (error, response, body) {
if (error) throw new Error(error);

console.log(body);
});

require 'uri'
require 'net/http'
require 'openssl'

url = URI("https://devapi.suworld.net")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_NONE

request = Net::HTTP::Post.new(url)
request["content-type"] = 'application/json'
request.body = "{"api":"YourApiKey","method":"sendContract","params":{"sender":"SWGT2A8gY37RkBedzrX1rwi61H8ZBECSx52r1CmRdeGDjdyS","receiver":"SWogTJtxnqQD3emG57S759CzAKnxDTGwgeSGoUbfqRsKaYQL","amount":"100","contract":"SW4R9entgziXv6hLeJBSGLJLLj9o6DwtBxVATui3vNBBuumz","passphrase":"password","payload":"hi"}}"

response = http.request(request)
puts response.read_body

var data = JSON.stringify({
  "api":"YourApiKey","method":"sendContract","params":{"sender":"SWGT2A8gY37RkBedzrX1rwi61H8ZBECSx52r1CmRdeGDjdyS","receiver":"SWogTJtxnqQD3emG57S759CzAKnxDTGwgeSGoUbfqRsKaYQL","amount":"100","contract":"SW4R9entgziXv6hLeJBSGLJLLj9o6DwtBxVATui3vNBBuumz","passphrase":"password","payload":"hi"}});

var xhr = new XMLHttpRequest();

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("POST", "https://devapi.suworld.net");
xhr.setRequestHeader("content-type", "application/json");

xhr.send(data);

import requests

url = "https://devapi.suworld.net"

payload = "{"api":"YourApiKey","method":"sendContract","params":{"sender":"SWGT2A8gY37RkBedzrX1rwi61H8ZBECSx52r1CmRdeGDjdyS","receiver":"SWogTJtxnqQD3emG57S759CzAKnxDTGwgeSGoUbfqRsKaYQL","amount":"100","contract":"SW4R9entgziXv6hLeJBSGLJLLj9o6DwtBxVATui3vNBBuumz","passphrase":"password","payload":"hi"}}"
headers = {'content-type': 'application/json'}

response = requests.request("POST", url, data=payload, headers=headers)

print(response.text)

Results

200 OK Metadata

																			{"result":"S0001","data":{"block":0,"time":1596438644,"opblock":0,"maturation":null,"optype":7,"subtype":0,"nopsp":168,"niopsp":0,"oprice":"3076923076230769","ioprice":"3076923076230769","signer_account":2,"n_operation":8,"contract_account":18,"amount":"100000000000000000000","senders":[{"account":2,"payload":"6869","payload_type":0}],"receivers":[{"account":4}],"optxt":"Contract Transfer 100000000000000000000 ","ophash":"0000000002000000080000001FB863D37A8AFD1DDBF857FBE833DD5DD20D1161"}}

Request Parameters

Field	Description	Type
sender	Sender walelt Address	String
receiver	Receiver walelt Address	String
amount	Amount of coins transferred from sender to receiver	NumberString
contract	Contract walelt Address	String
passphrase	Sender walelt password	String

Response

Field	Description	Type
result	Success(S0001) or Error(ER001 etc..)	String
sender	Sender walelt Address	String
receiver	Receiver walelt Address	String
amount	Amount of coins transferred from sender to receiver	NumberString
fee	Transaction Fee	NumberString
balance	Remaining balance	NumberString
ophash	Transaction hash	String

adminContract

Executes a contract admin transaction


curl --request POST \
--url https://devapi.suworld.net \
--header 'content-type: application/json' \
--data '{"api":"YourApiKey","method":"adminContract","params":{"sender":"SWGT2A8gY37RkBedzrX1rwi61H8ZBECSx52r1CmRdeGDjdyS","passphrase":"eoqkrskwktjdrhd","contract":"SW4R9entgziXv6hLeJBSGLJLLj9o6DwtBxVATui3vNBBuumz","method":"transferEnabled","select":"false"}}'

var request = require("request");
var options = {
method: 'POST',
url: 'https://devapi.suworld.net',
headers: {'content-type': 'application/json'},
body: {"api":"YourApiKey","method":"adminContract","params":{"sender":"SWGT2A8gY37RkBedzrX1rwi61H8ZBECSx52r1CmRdeGDjdyS","passphrase":"eoqkrskwktjdrhd","contract":"SW4R9entgziXv6hLeJBSGLJLLj9o6DwtBxVATui3vNBBuumz","method":"transferEnabled","select":"false"}},
json: true
};
request(options, function (error, response, body) {
if (error) throw new Error(error);

console.log(body);
});

require 'uri'
require 'net/http'
require 'openssl'

url = URI("https://devapi.suworld.net")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_NONE

request = Net::HTTP::Post.new(url)
request["content-type"] = 'application/json'
request.body = "{"api":"YourApiKey","method":"adminContract","params":{"sender":"SWGT2A8gY37RkBedzrX1rwi61H8ZBECSx52r1CmRdeGDjdyS","passphrase":"eoqkrskwktjdrhd","contract":"SW4R9entgziXv6hLeJBSGLJLLj9o6DwtBxVATui3vNBBuumz","method":"transferEnabled","select":"false"}}"

response = http.request(request)
puts response.read_body

var data = JSON.stringify({
  "api":"YourApiKey","method":"adminContract","params":{"sender":"SWGT2A8gY37RkBedzrX1rwi61H8ZBECSx52r1CmRdeGDjdyS","passphrase":"eoqkrskwktjdrhd","contract":"SW4R9entgziXv6hLeJBSGLJLLj9o6DwtBxVATui3vNBBuumz","method":"transferEnabled","select":"false"}});

var xhr = new XMLHttpRequest();

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("POST", "https://devapi.suworld.net");
xhr.setRequestHeader("content-type", "application/json");

xhr.send(data);

import requests

url = "https://devapi.suworld.net"

payload = "{"api":"YourApiKey","method":"adminContract","params":{"sender":"SWGT2A8gY37RkBedzrX1rwi61H8ZBECSx52r1CmRdeGDjdyS","passphrase":"eoqkrskwktjdrhd","contract":"SW4R9entgziXv6hLeJBSGLJLLj9o6DwtBxVATui3vNBBuumz","method":"transferEnabled","select":"false"}}"
headers = {'content-type': 'application/json'}

response = requests.request("POST", url, data=payload, headers=headers)

print(response.text)

Results

200 OK Metadata

																			{"result":"S0001","data":{"block":0,"time":1596438809,"opblock":0,"maturation":null,"optype":8,"subtype":0,"nopsp":300,"niopsp":0,"oprice":"3076923076230769","ioprice":"3076923076230769","signer_account":2,"n_operation":9,"contract_account":18,"amount":"0","senders":[{"account":2,"payload":"51808102000000000000000000000000000000000000000000000000000000000000000000000000000000000000","payload_type":1}],"receivers":[{"account":0}],"optxt":"Contract Function  ","ophash":"00000000020000000900000003EEBAEDAAD0705FD863CD112B536577F88CF32D"}}

Request Parameters

Field	Description	Type
sender	Sender walelt Address	String
passphrase	Sender walelt password	String
receiver	Applied walelt Address	String
contract	Contract walelt Address	String
method	function method(transferEnabled,transferWalletEnabled,lockWalletVolume,burnWalletVolume,mintWalletVolume,ownershipWallet)	String
amount	function Amount(lockWalletVolume,burnWalletVolume,mintWalletVolume)	NumberString
select	True or False(transferEnabled,transferWalletEnabled)	Boolean

Response

Field	Description	Type
result	Success(S0001) or Error(ER001 etc..)	String
sender	Sender walelt Address	String
receiver	Receiver walelt Address	String
amount	Amount of coins transferred from sender to receiver	NumberString
fee	Transaction Fee	NumberString
balance	Remaining balance	NumberString
ophash	Transaction hash	String

infoContract

Returns creation contract infomation


curl --request POST \
--url https://devapi.suworld.net \
--header 'content-type: application/json' \
--data '{"api":"YourApiKey","method":"infoContract","params":{"wallet":"SW4R9entgziXv6hLeJBSGLJLLj9o6DwtBxVATui3vNBBuumz"}}'

var request = require("request");
var options = {
method: 'POST',
url: 'https://devapi.suworld.net',
headers: {'content-type': 'application/json'},
body: {"api":"YourApiKey","method":"infoContract","params":{"wallet":"SW4R9entgziXv6hLeJBSGLJLLj9o6DwtBxVATui3vNBBuumz"}},
json: true
};
request(options, function (error, response, body) {
if (error) throw new Error(error);

console.log(body);
});

require 'uri'
require 'net/http'
require 'openssl'

url = URI("https://devapi.suworld.net")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_NONE

request = Net::HTTP::Post.new(url)
request["content-type"] = 'application/json'
request.body = "{"api":"YourApiKey","method":"infoContract","params":{"wallet":"SW4R9entgziXv6hLeJBSGLJLLj9o6DwtBxVATui3vNBBuumz"}}"

response = http.request(request)
puts response.read_body

var data = JSON.stringify({
  "api":"YourApiKey","method":"infoContract","params":{"wallet":"SW4R9entgziXv6hLeJBSGLJLLj9o6DwtBxVATui3vNBBuumz"}});

var xhr = new XMLHttpRequest();

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("POST", "https://devapi.suworld.net");
xhr.setRequestHeader("content-type", "application/json");

xhr.send(data);

import requests

url = "https://devapi.suworld.net"

payload = "{"api":"YourApiKey","method":"infoContract","params":{"wallet":"SW4R9entgziXv6hLeJBSGLJLLj9o6DwtBxVATui3vNBBuumz"}}"
headers = {'content-type': 'application/json'}

response = requests.request("POST", url, data=payload, headers=headers)

print(response.text)

Results

200 OK Metadata

																			{"result":"S0001","data":{"totalHolder":1,"business":true,"symbol":"'TCN'","name":"'TESTCOIN'","summary":"'TEST COIN IS TEST'","issuer":"SWGT2A8gY37RkBedzrX1rwi61H8ZBECSx52r1CmRdeGDjdyS","owner":"SWGT2A8gY37RkBedzrX1rwi61H8ZBECSx52r1CmRdeGDjdyS","decimal":18,"totalAmount":"100000.0"}}

Request Parameters

Field	Description	Type
wallet	Contract walelt Address	String

Response

Field	Description	Type
result	Success(S0001) or Error(ER001 etc..)	String
totalHolder	Contract Holder Count	Integer
business	Business or Normal Contract	Boolean
symbol	Contract Symbol	String
name	Contract Name	String
summary	Contract Description	String
issuer	Issuer walelt Address	String
owner	Owner walelt Address	String
totalAmount	Issue Amount	String
decimal	Token decimal	String

holderContract

Returns contract holder infomation


curl --request POST \
--url https://devapi.suworld.net \
--header 'content-type: application/json' \
--data '{"api":"YourApiKey","method":"holderContract","params":{"wallet":"SW4R9entgziXv6hLeJBSGLJLLj9o6DwtBxVATui3vNBBuumz"}}'

var request = require("request");
var options = {
method: 'POST',
url: 'https://devapi.suworld.net',
headers: {'content-type': 'application/json'},
body: {"api":"YourApiKey","method":"holderContract","params":{"wallet":"SW4R9entgziXv6hLeJBSGLJLLj9o6DwtBxVATui3vNBBuumz"}},
json: true
};
request(options, function (error, response, body) {
if (error) throw new Error(error);

console.log(body);
});

require 'uri'
require 'net/http'
require 'openssl'

url = URI("https://devapi.suworld.net")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_NONE

request = Net::HTTP::Post.new(url)
request["content-type"] = 'application/json'
request.body = "{"api":"YourApiKey","method":"holderContract","params":{"wallet":"SW4R9entgziXv6hLeJBSGLJLLj9o6DwtBxVATui3vNBBuumz"}}"

response = http.request(request)
puts response.read_body

var data = JSON.stringify({
  "api":"YourApiKey","method":"holderContract","params":{"wallet":"SW4R9entgziXv6hLeJBSGLJLLj9o6DwtBxVATui3vNBBuumz"}});

var xhr = new XMLHttpRequest();

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("POST", "https://devapi.suworld.net");
xhr.setRequestHeader("content-type", "application/json");

xhr.send(data);

import requests

url = "https://devapi.suworld.net"

payload = "{"api":"YourApiKey","method":"holderContract","params":{"wallet":"SW4R9entgziXv6hLeJBSGLJLLj9o6DwtBxVATui3vNBBuumz"}}"
headers = {'content-type': 'application/json'}

response = requests.request("POST", url, data=payload, headers=headers)

print(response.text)

Results

200 OK Metadata

																			{"result":"S0001","data":{"transfer":true,"bussiness":true,"totalHolder":1,"holder":[{"btransfer":true,"balance":"100000000000000000000000","wallet":"SWGT2A8gY37RkBedzrX1rwi61H8ZBECSx52r1CmRdeGDjdyS","volumeLock":"0","volumeTimeLock":"0"}]}}

Request Parameters

Field	Description	Type
wallet	Contract walelt Address	String

Response

Field	Description	Type
result	Success(S0001) or Error(ER001 etc..)	String
transfer	Contract transfer enabled	Boolean
business	Business or Normal Contract	Boolean
totalHolder	Contract Holder Count	Integer
holder	Contract Holder detail	Json array