Submit A New Transaction

POST

https://kas.nownodes.io/transactions

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Submit a signed transaction to the Kaspa network and return its transaction id. Both v0 and v1 (Toccata) transactions are supported. For v1, inputs use computeBudget (with sigOpCount 0) and outputs can carry a covenant binding; the transaction can set gas. Both versions accept a hex payload. For v0 transactions the v1-only fields are ignored.

Body

application/json

transactionSubmitTxModelrequired

Show child attributes

versionintegerrequired

inputsArray<SubmitTxInput>required

Show child attributes

previousOutpointSubmitTxOutpointrequired

Show child attributes

transactionIdstringrequired

indexintegerrequired

signatureScriptstringrequired

sequenceintegerrequired

sigOpCountintegerrequired

computeBudgetinteger0

Compute budget of the input (v1 transactions). For v1, sigOpCount must be 0. Ignored for v0.

outputsArray<SubmitTxOutput>required

Show child attributes

amountintegerrequired

scriptPublicKeySubmitTxScriptPublicKeyrequired

Show child attributes

versionintegerrequired

scriptPublicKeystringrequired

covenantSubmitTxCovenantBinding

Covenant binding of an output (v1 transactions).

Show child attributes

authorizingInputintegerrequired

covenantIdstringrequired

lockTimeinteger0

subnetworkIdstring

gasinteger0

Gas (v1 transactions). Forced to 0 for v0.

payloadstring

Hex-encoded transaction payload. Supported for both v0 and v1 transactions.

allowOrphanbooleanfalse

Parameters

replaceByFeebooleanfalsequery

Replace an existing transaction in the mempool

Response

200OK

Successful Response

400Bad Request

Bad Request

422Unprocessable Entity

Validation Error

503Service Unavailable

Service Unavailable: no synced Kaspa node is reachable

Submit A New Transaction

curl -X POST 'https://kas.nownodes.io/transactions' \
  -H 'Content-Type: application/json' \
  -d '{
    "transaction": {
      "version": 0,
      "inputs": [
        {
          "previousOutpoint": {
            "transactionId": "string",
            "index": 0
          },
          "signatureScript": "string",
          "sequence": 0,
          "sigOpCount": 0,
          "computeBudget": 0
        }
      ],
      "outputs": [
        {
          "amount": 0,
          "scriptPublicKey": {
            "version": 0,
            "scriptPublicKey": "string"
          },
          "covenant": {
            "authorizingInput": 0,
            "covenantId": "string"
          }
        }
      ],
      "lockTime": 0,
      "subnetworkId": "string",
      "gas": 0,
      "payload": ""
    },
    "allowOrphan": false
  }'

const response = await fetch('https://kas.nownodes.io/transactions', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "transaction": {
        "version": 0,
        "inputs": [
          {
            "previousOutpoint": {
              "transactionId": "string",
              "index": 0
            },
            "signatureScript": "string",
            "sequence": 0,
            "sigOpCount": 0,
            "computeBudget": 0
          }
        ],
        "outputs": [
          {
            "amount": 0,
            "scriptPublicKey": {
              "version": 0,
              "scriptPublicKey": "string"
            },
            "covenant": {
              "authorizingInput": 0,
              "covenantId": "string"
            }
          }
        ],
        "lockTime": 0,
        "subnetworkId": "string",
        "gas": 0,
        "payload": ""
      },
      "allowOrphan": false
    }),
});

const data = await response.json();

require 'net/http'
require 'json'

uri = URI('https://kas.nownodes.io/transactions')
request = Net::HTTP::Post.new(uri)
request['Content-Type'] = 'application/json'
request.body = '{
    "transaction": {
      "version": 0,
      "inputs": [
        {
          "previousOutpoint": {
            "transactionId": "string",
            "index": 0
          },
          "signatureScript": "string",
          "sequence": 0,
          "sigOpCount": 0,
          "computeBudget": 0
        }
      ],
      "outputs": [
        {
          "amount": 0,
          "scriptPublicKey": {
            "version": 0,
            "scriptPublicKey": "string"
          },
          "covenant": {
            "authorizingInput": 0,
            "covenantId": "string"
          }
        }
      ],
      "lockTime": 0,
      "subnetworkId": "string",
      "gas": 0,
      "payload": ""
    },
    "allowOrphan": false
  }'

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

import requests

payload = {
  "transaction": {
    "version": 0,
    "inputs": [
      {
        "previousOutpoint": {
          "transactionId": "string",
          "index": 0
        },
        "signatureScript": "string",
        "sequence": 0,
        "sigOpCount": 0,
        "computeBudget": 0
      }
    ],
    "outputs": [
      {
        "amount": 0,
        "scriptPublicKey": {
          "version": 0,
          "scriptPublicKey": "string"
        },
        "covenant": {
          "authorizingInput": 0,
          "covenantId": "string"
        }
      }
    ],
    "lockTime": 0,
    "subnetworkId": "string",
    "gas": 0,
    "payload": ""
  },
  "allowOrphan": False
}

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

const response = await fetch('https://kas.nownodes.io/transactions', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "transaction": {
        "version": 0,
        "inputs": [
          {
            "previousOutpoint": {
              "transactionId": "string",
              "index": 0
            },
            "signatureScript": "string",
            "sequence": 0,
            "sigOpCount": 0,
            "computeBudget": 0
          }
        ],
        "outputs": [
          {
            "amount": 0,
            "scriptPublicKey": {
              "version": 0,
              "scriptPublicKey": "string"
            },
            "covenant": {
              "authorizingInput": 0,
              "covenantId": "string"
            }
          }
        ],
        "lockTime": 0,
        "subnetworkId": "string",
        "gas": 0,
        "payload": ""
      },
      "allowOrphan": false
    }),
});

const data = await response.json();

const endpoint = "https://kas.nownodes.io/transactions";
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({
    "transaction": {
      "version": 0,
      "inputs": [
        {
          "previousOutpoint": {
            "transactionId": "string",
            "index": 0
          },
          "signatureScript": "string",
          "sequence": 0,
          "sigOpCount": 0,
          "computeBudget": 0
        }
      ],
      "outputs": [
        {
          "amount": 0,
          "scriptPublicKey": {
            "version": 0,
            "scriptPublicKey": "string"
          },
          "covenant": {
            "authorizingInput": 0,
            "covenantId": "string"
          }
        }
      ],
      "lockTime": 0,
      "subnetworkId": "string",
      "gas": 0,
      "payload": ""
    },
    "allowOrphan": false
  });
console.log(result);

const response = await fetch('https://kas.nownodes.io/transactions', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "transaction": {
        "version": 0,
        "inputs": [
          {
            "previousOutpoint": {
              "transactionId": "string",
              "index": 0
            },
            "signatureScript": "string",
            "sequence": 0,
            "sigOpCount": 0,
            "computeBudget": 0
          }
        ],
        "outputs": [
          {
            "amount": 0,
            "scriptPublicKey": {
              "version": 0,
              "scriptPublicKey": "string"
            },
            "covenant": {
              "authorizingInput": 0,
              "covenantId": "string"
            }
          }
        ],
        "lockTime": 0,
        "subnetworkId": "string",
        "gas": 0,
        "payload": ""
      },
      "allowOrphan": false
    }),
});

const data = await response.json();

import requests

payload = {
  "transaction": {
    "version": 0,
    "inputs": [
      {
        "previousOutpoint": {
          "transactionId": "string",
          "index": 0
        },
        "signatureScript": "string",
        "sequence": 0,
        "sigOpCount": 0,
        "computeBudget": 0
      }
    ],
    "outputs": [
      {
        "amount": 0,
        "scriptPublicKey": {
          "version": 0,
          "scriptPublicKey": "string"
        },
        "covenant": {
          "authorizingInput": 0,
          "covenantId": "string"
        }
      }
    ],
    "lockTime": 0,
    "subnetworkId": "string",
    "gas": 0,
    "payload": ""
  },
  "allowOrphan": False
}

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

require 'net/http'
require 'json'

uri = URI('https://kas.nownodes.io/transactions')
request = Net::HTTP::Post.new(uri)
request['Content-Type'] = 'application/json'
request.body = '{
    "transaction": {
      "version": 0,
      "inputs": [
        {
          "previousOutpoint": {
            "transactionId": "string",
            "index": 0
          },
          "signatureScript": "string",
          "sequence": 0,
          "sigOpCount": 0,
          "computeBudget": 0
        }
      ],
      "outputs": [
        {
          "amount": 0,
          "scriptPublicKey": {
            "version": 0,
            "scriptPublicKey": "string"
          },
          "covenant": {
            "authorizingInput": 0,
            "covenantId": "string"
          }
        }
      ],
      "lockTime": 0,
      "subnetworkId": "string",
      "gas": 0,
      "payload": ""
    },
    "allowOrphan": false
  }'

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

Request Body

{
  "transaction": {
    "version": 0,
    "inputs": [
      {
        "previousOutpoint": {
          "transactionId": "string",
          "index": 0
        },
        "signatureScript": "string",
        "sequence": 0,
        "sigOpCount": 0,
        "computeBudget": 0
      }
    ],
    "outputs": [
      {
        "amount": 0,
        "scriptPublicKey": {
          "version": 0,
          "scriptPublicKey": "string"
        },
        "covenant": {
          "authorizingInput": 0,
          "covenantId": "string"
        }
      }
    ],
    "lockTime": 0,
    "subnetworkId": "string",
    "gas": 0,
    "payload": ""
  },
  "allowOrphan": false
}

{
  "transactionId": "string",
  "error": "string"
}

{
  "transactionId": "string",
  "error": "string"
}

{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}

{
  "detail": "Kaspad unavailable"
}