Create and send a new transaction

POST

https://zil.nownodes.io/

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Creates a new transaction and broadcasts it to the Zilliqa network. The transaction can be a transfer of ZIL or an interaction with a smart contract.

Body

application/json

jsonrpcstringrequired

JSON-RPC version

methodstringrequired

Method name

idintegerrequired

Request ID

paramsArray<object>required

Transaction parameters object

Show child attributes

senderstringrequired

Address of the sender in Bech32 format

recipientstringrequired

Address of the recipient in Bech32 format

amountstringrequired

Amount to send in Qa (1 ZIL = 10^12 Qa)

gasPricestringrequired

Gas price in Qa

gasLimitintegerrequired

Maximum gas units allowed for the transaction

nonceintegerrequired

Transaction nonce to prevent replay attacks

datastring

(Optional) Hex-encoded data payload for smart contract interaction

Response

200OK

Transaction created and broadcasted successfully

400Bad Request

Invalid request

500Internal Server Error

Server error

Create and send a new transaction

curl -X POST 'https://zil.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "CreateTransaction",
    "id": 1,
    "params": [
      {
        "sender": "zil1qyqszqgpqyqszqgpqyqszqgpqyqszqgpqyqszq",
        "recipient": "zil1p8fss4jhh9e7k3fql89d2e2uzj4v9a0nxwucfa",
        "amount": "1000000000000",
        "gasPrice": "1000000000",
        "gasLimit": 5000,
        "nonce": 10,
        "data": "0xabcdef"
      }
    ]
  }'

import { JsonRpcProvider } from "ethers";

const provider = new JsonRpcProvider("https://zil.nownodes.io/");
const result = await provider.send("CreateTransaction", [
  {
    "sender": "zil1qyqszqgpqyqszqgpqyqszqgpqyqszqgpqyqszq",
    "recipient": "zil1p8fss4jhh9e7k3fql89d2e2uzj4v9a0nxwucfa",
    "amount": "1000000000000",
    "gasPrice": "1000000000",
    "gasLimit": 5000,
    "nonce": 10,
    "data": "0xabcdef"
  }
]);
console.log(result);

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

uri = URI('https://zil.nownodes.io/')
request = Net::HTTP::Post.new(uri)
request['Content-Type'] = 'application/json'
request.body = '{
  "jsonrpc": "2.0",
  "method": "CreateTransaction",
  "params": [
    {
      "sender": "zil1qyqszqgpqyqszqgpqyqszqgpqyqszqgpqyqszq",
      "recipient": "zil1p8fss4jhh9e7k3fql89d2e2uzj4v9a0nxwucfa",
      "amount": "1000000000000",
      "gasPrice": "1000000000",
      "gasLimit": 5000,
      "nonce": 10,
      "data": "0xabcdef"
    }
  ],
  "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://zil.nownodes.io/"))
response = w3.provider.make_request("CreateTransaction", [
  {
    "sender": "zil1qyqszqgpqyqszqgpqyqszqgpqyqszqgpqyqszq",
    "recipient": "zil1p8fss4jhh9e7k3fql89d2e2uzj4v9a0nxwucfa",
    "amount": "1000000000000",
    "gasPrice": "1000000000",
    "gasLimit": 5000,
    "nonce": 10,
    "data": "0xabcdef"
  }
])
print(response)

import { createPublicClient, http } from "viem";

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

const result = await client.request({
  method: "CreateTransaction",
  params: [
  {
    "sender": "zil1qyqszqgpqyqszqgpqyqszqgpqyqszqgpqyqszq",
    "recipient": "zil1p8fss4jhh9e7k3fql89d2e2uzj4v9a0nxwucfa",
    "amount": "1000000000000",
    "gasPrice": "1000000000",
    "gasLimit": 5000,
    "nonce": 10,
    "data": "0xabcdef"
  }
],
});

console.log(result);

const endpoint = "https://zil.nownodes.io/";
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: "CreateTransaction", params: [
  {
    "sender": "zil1qyqszqgpqyqszqgpqyqszqgpqyqszqgpqyqszq",
    "recipient": "zil1p8fss4jhh9e7k3fql89d2e2uzj4v9a0nxwucfa",
    "amount": "1000000000000",
    "gasPrice": "1000000000",
    "gasLimit": 5000,
    "nonce": 10,
    "data": "0xabcdef"
  }
], id: 1 });
console.log(result);

const response = await fetch('https://zil.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "CreateTransaction",
      "id": 1,
      "params": [
        {
          "sender": "zil1qyqszqgpqyqszqgpqyqszqgpqyqszqgpqyqszq",
          "recipient": "zil1p8fss4jhh9e7k3fql89d2e2uzj4v9a0nxwucfa",
          "amount": "1000000000000",
          "gasPrice": "1000000000",
          "gasLimit": 5000,
          "nonce": 10,
          "data": "0xabcdef"
        }
      ]
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "CreateTransaction",
  "id": 1,
  "params": [
    {
      "sender": "zil1qyqszqgpqyqszqgpqyqszqgpqyqszqgpqyqszq",
      "recipient": "zil1p8fss4jhh9e7k3fql89d2e2uzj4v9a0nxwucfa",
      "amount": "1000000000000",
      "gasPrice": "1000000000",
      "gasLimit": 5000,
      "nonce": 10,
      "data": "0xabcdef"
    }
  ]
}

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

require 'net/http'
require 'json'

uri = URI('https://zil.nownodes.io/')
request = Net::HTTP::Post.new(uri)
request['Content-Type'] = 'application/json'
request.body = '{
    "jsonrpc": "2.0",
    "method": "CreateTransaction",
    "id": 1,
    "params": [
      {
        "sender": "zil1qyqszqgpqyqszqgpqyqszqgpqyqszqgpqyqszq",
        "recipient": "zil1p8fss4jhh9e7k3fql89d2e2uzj4v9a0nxwucfa",
        "amount": "1000000000000",
        "gasPrice": "1000000000",
        "gasLimit": 5000,
        "nonce": 10,
        "data": "0xabcdef"
      }
    ]
  }'

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": "CreateTransaction",
  "id": 1,
  "params": [
    {
      "sender": "zil1qyqszqgpqyqszqgpqyqszqgpqyqszqgpqyqszq",
      "recipient": "zil1p8fss4jhh9e7k3fql89d2e2uzj4v9a0nxwucfa",
      "amount": "1000000000000",
      "gasPrice": "1000000000",
      "gasLimit": 5000,
      "nonce": 10,
      "data": "0xabcdef"
    }
  ]
}

200

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": {
    "tranID": "0x1234abcd5678ef901234abcd5678ef901234abcd5678ef901234abcd5678ef90",
    "receipt": {}
  }
}

Documentation

How to migrate to NOWNodes

Create and send a new transaction

Authorizations

Body

Response