Issue a new currency or re-issue an existing currency with different properties

POST

https://ardr.nownodes.io/nxt

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Body

application/json

jsonrpcstringrequired

methodstringrequired

paramsobjectrequired

Show child attributes

requestTypestring

chaininteger

The chain related to the operation

namestring

The currency name, 3 to 10 characters and longer than the currency code

codestring

The uppercase currency code

descriptionstring

The currency description

typeinteger

The currency type bitmask

initialSupplyQNTstring

The initial currency supply (in QNT)

reserveSupplyQNTstring

The reserve currency supply (in QNT)

maxSupplyQNTstring

The maximum currency supply (in QNT)

issuanceHeightinteger

The blockchain height at which a reservable currency is issued

minReservePerUnitNQTstring

The minimum currency reserve (in NQT per QNT of reserveSupply) for issuance

minDifficultyinteger

The minimum difficulty for a mintable currency

maxDifficultyinteger

The maximum difficulty for a mintable currency

rulesetinteger

For future use, always set to zero

algorithminteger

An algorithm code for a mintable currency

decimalsinteger

The number of decimal places used by the currency

idintegerrequired

Response

200OK

Currency issued successfully

400Bad Request

Bad Request

401Unauthorized

Unauthorized — Missing or invalid API key

500Internal Server Error

Internal Server Error

Issue a new currency or re-issue an existing currency with different properties

curl -X POST 'https://ardr.nownodes.io/nxt' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "issueCurrency",
    "params": {
      "requestType": "issueCurrency",
      "chain": 0,
      "name": "string",
      "code": "string",
      "description": "string",
      "type": 0,
      "initialSupplyQNT": "string",
      "reserveSupplyQNT": "string",
      "maxSupplyQNT": "string",
      "issuanceHeight": 0,
      "minReservePerUnitNQT": "string",
      "minDifficulty": 0,
      "maxDifficulty": 0,
      "ruleset": 0,
      "algorithm": 0,
      "decimals": 0
    },
    "id": 1
  }'

import { JsonRpcProvider } from "ethers";

const provider = new JsonRpcProvider("https://ardr.nownodes.io/nxt");
const result = await provider.send("issueCurrency", {
  "requestType": "issueCurrency",
  "chain": 0,
  "name": "string",
  "code": "string",
  "description": "string",
  "type": 0,
  "initialSupplyQNT": "string",
  "reserveSupplyQNT": "string",
  "maxSupplyQNT": "string",
  "issuanceHeight": 0,
  "minReservePerUnitNQT": "string",
  "minDifficulty": 0,
  "maxDifficulty": 0,
  "ruleset": 0,
  "algorithm": 0,
  "decimals": 0
});
console.log(result);

require 'eth'
require 'json'
require 'net/http'

uri = URI('https://ardr.nownodes.io/nxt')
request = Net::HTTP::Post.new(uri)
request['Content-Type'] = 'application/json'
request.body = '{
  "jsonrpc": "2.0",
  "method": "issueCurrency",
  "params": {
    "requestType": "issueCurrency",
    "chain": 0,
    "name": "string",
    "code": "string",
    "description": "string",
    "type": 0,
    "initialSupplyQNT": "string",
    "reserveSupplyQNT": "string",
    "maxSupplyQNT": "string",
    "issuanceHeight": 0,
    "minReservePerUnitNQT": "string",
    "minDifficulty": 0,
    "maxDifficulty": 0,
    "ruleset": 0,
    "algorithm": 0,
    "decimals": 0
  },
  "id": 1
}'

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
  http.request(request)
end

puts JSON.parse(response.body)

from web3 import Web3

w3 = Web3(Web3.HTTPProvider("https://ardr.nownodes.io/nxt"))
response = w3.provider.make_request("issueCurrency", {
  "requestType": "issueCurrency",
  "chain": 0,
  "name": "string",
  "code": "string",
  "description": "string",
  "type": 0,
  "initialSupplyQNT": "string",
  "reserveSupplyQNT": "string",
  "maxSupplyQNT": "string",
  "issuanceHeight": 0,
  "minReservePerUnitNQT": "string",
  "minDifficulty": 0,
  "maxDifficulty": 0,
  "ruleset": 0,
  "algorithm": 0,
  "decimals": 0
})
print(response)

import { createPublicClient, http } from "viem";

const client = createPublicClient({
  transport: http("https://ardr.nownodes.io/nxt"),
});

const result = await client.request({
  method: "issueCurrency",
  params: {
  "requestType": "issueCurrency",
  "chain": 0,
  "name": "string",
  "code": "string",
  "description": "string",
  "type": 0,
  "initialSupplyQNT": "string",
  "reserveSupplyQNT": "string",
  "maxSupplyQNT": "string",
  "issuanceHeight": 0,
  "minReservePerUnitNQT": "string",
  "minDifficulty": 0,
  "maxDifficulty": 0,
  "ruleset": 0,
  "algorithm": 0,
  "decimals": 0
},
});

console.log(result);

const endpoint = "https://ardr.nownodes.io/nxt";
const apiKey = "YOUR_API_KEY";

async function nownodesRequest(payload) {
  const response = await fetch(endpoint, {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      "api-key": apiKey,
    },
    body: JSON.stringify(payload),
  });

  return response.json();
}

const result = await nownodesRequest({ jsonrpc: "2.0", method: "issueCurrency", params: {
  "requestType": "issueCurrency",
  "chain": 0,
  "name": "string",
  "code": "string",
  "description": "string",
  "type": 0,
  "initialSupplyQNT": "string",
  "reserveSupplyQNT": "string",
  "maxSupplyQNT": "string",
  "issuanceHeight": 0,
  "minReservePerUnitNQT": "string",
  "minDifficulty": 0,
  "maxDifficulty": 0,
  "ruleset": 0,
  "algorithm": 0,
  "decimals": 0
}, id: 1 });
console.log(result);

const response = await fetch('https://ardr.nownodes.io/nxt', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "issueCurrency",
      "params": {
        "requestType": "issueCurrency",
        "chain": 0,
        "name": "string",
        "code": "string",
        "description": "string",
        "type": 0,
        "initialSupplyQNT": "string",
        "reserveSupplyQNT": "string",
        "maxSupplyQNT": "string",
        "issuanceHeight": 0,
        "minReservePerUnitNQT": "string",
        "minDifficulty": 0,
        "maxDifficulty": 0,
        "ruleset": 0,
        "algorithm": 0,
        "decimals": 0
      },
      "id": 1
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "issueCurrency",
  "params": {
    "requestType": "issueCurrency",
    "chain": 0,
    "name": "string",
    "code": "string",
    "description": "string",
    "type": 0,
    "initialSupplyQNT": "string",
    "reserveSupplyQNT": "string",
    "maxSupplyQNT": "string",
    "issuanceHeight": 0,
    "minReservePerUnitNQT": "string",
    "minDifficulty": 0,
    "maxDifficulty": 0,
    "ruleset": 0,
    "algorithm": 0,
    "decimals": 0
  },
  "id": 1
}

response = requests.post('https://ardr.nownodes.io/nxt', json=payload)
data = response.json()

require 'net/http'
require 'json'

uri = URI('https://ardr.nownodes.io/nxt')
request = Net::HTTP::Post.new(uri)
request['Content-Type'] = 'application/json'
request.body = '{
    "jsonrpc": "2.0",
    "method": "issueCurrency",
    "params": {
      "requestType": "issueCurrency",
      "chain": 0,
      "name": "string",
      "code": "string",
      "description": "string",
      "type": 0,
      "initialSupplyQNT": "string",
      "reserveSupplyQNT": "string",
      "maxSupplyQNT": "string",
      "issuanceHeight": 0,
      "minReservePerUnitNQT": "string",
      "minDifficulty": 0,
      "maxDifficulty": 0,
      "ruleset": 0,
      "algorithm": 0,
      "decimals": 0
    },
    "id": 1
  }'

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(request) }
data = JSON.parse(response.body)

Request Body

{
  "jsonrpc": "2.0",
  "method": "issueCurrency",
  "params": {
    "requestType": "issueCurrency",
    "chain": 0,
    "name": "string",
    "code": "string",
    "description": "string",
    "type": 0,
    "initialSupplyQNT": "string",
    "reserveSupplyQNT": "string",
    "maxSupplyQNT": "string",
    "issuanceHeight": 0,
    "minReservePerUnitNQT": "string",
    "minDifficulty": 0,
    "maxDifficulty": 0,
    "ruleset": 0,
    "algorithm": 0,
    "decimals": 0
  },
  "id": 1
}

200

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "signatureHash": "string",
    "unsignedTransactionBytes": "string",
    "transactionJSON": {
      "senderPublicKey": "string",
      "chain": 0,
      "signature": "string",
      "feeNQT": "string",
      "type": 0,
      "fullHash": "string",
      "version": 0,
      "ecBlockId": "string",
      "signatureHash": "string",
      "attachment": {
        "initialSupply": "string",
        "code": "string",
        "minDifficulty": 0,
        "ruleset": 0,
        "description": "string",
        "minReservePerUnitNQT": "string",
        "issuanceHeight": 0,
        "type": 0,
        "reserveSupply": "string",
        "version.CurrencyIssuance": 0,
        "maxDifficulty": 0,
        "decimals": 0,
        "name": "string",
        "maxSupply": "string",
        "algorithm": 0
      },
      "senderRS": "string",
      "subtype": 0,
      "amountNQT": "string",
      "sender": "string",
      "ecBlockHeight": 0,
      "deadline": 0,
      "transaction": "string",
      "timestamp": 0,
      "height": 0
    },
    "broadcasted": true,
    "requestProcessingTime": 0,
    "transactionBytes": "string",
    "fullHash": "string",
    "transaction": "string"
  }
}

Documentation

How to migrate to NOWNodes

Issue a new currency or re-issue an existing currency with different properties

Authorizations

Body

Response