---
title: "Send Transactions"
description: "Build, sign, and broadcast NIM transfers — with and without data payloads."
canonical_url: "https://nimiq.dev/web-client/guides/send-transactions"
---
# Send Transactions

> Build, sign, and broadcast NIM transfers — with and without data payloads.

This guide walks through creating, signing, and broadcasting transactions using the web client. You'll need a connected client with consensus and a keypair with funds. If you don't have these yet, see [Getting Started](https://nimiq.dev/web-client/getting-started) and [Create and Manage Wallets](https://nimiq.dev/web-client/guides/wallets).

The examples below assume you have a connected `client`, a funded `keyPair`, and a `sender` address derived from it. See [Getting Started](https://nimiq.dev/web-client/getting-started) and [Create and Manage Wallets](https://nimiq.dev/web-client/guides/wallets) if you don't have these yet.

## Send a basic transaction

A basic transaction transfers NIM from one address to another. Values and fees are in luna (1 NIM = 100,000 luna).

```js
const recipient = Nimiq.Address.fromUserFriendlyAddress('NQ15 0000 0000 0000 0000 0000 0000 0000 0000')

const tx = Nimiq.TransactionBuilder.newBasic(
  sender,
  recipient,
  100_000_000_00n,  // 1,000 NIM in luna
  0n,         // fee in luna — 0 is valid for most transactions
  await client.getHeadHeight(), // validity start height
  await client.getNetworkId(),
)

tx.sign(keyPair)

const details = await client.sendTransaction(tx)
console.log('Transaction hash:', details.transactionHash)
console.log('State:', details.state)
```

The `validityStartHeight` determines when the transaction becomes valid. Setting it to the current head height means it's valid immediately. Transactions expire after a protocol-defined window.

`sendTransaction()` can return `state: 'new'` if no inclusion notification arrives before it stops waiting. This response has no execution result, and the transaction may still have been included. Look it up with `getTransaction()` to check.

## Send a transaction with data

You can attach up to 64 bytes of arbitrary data to a transaction:

```js
const data = new TextEncoder().encode('Hello Nimiq!')

const tx = Nimiq.TransactionBuilder.newBasicWithData(
  sender,
  recipient,
  data,
  500_00n,    // 500 NIM in luna
  0n,         // fee in luna
  await client.getHeadHeight(),
  await client.getNetworkId(),
)

tx.sign(keyPair)

const details = await client.sendTransaction(tx)
console.log('Transaction hash:', details.transactionHash)
```

## Check transaction status

After the transaction is included, look it up by hash:

```js
const tx = await client.getTransaction(details.transactionHash)
console.log('State:', tx.state)
if (tx.executionResult === true) {
  console.log('Execution succeeded')
} else if (tx.executionResult === false) {
  console.log('Execution failed')
} else {
  console.log('Execution result unavailable')
}
```

`state` and `executionResult` describe different things:

- `state` describes inclusion and finality: `included` means the transaction is in the blockchain, and `confirmed` means it is finalized.
- `executionResult` describes the outcome: `true` means execution succeeded, and `false` means it failed.
A transaction can be `included` or `confirmed` and still have `executionResult: false`. `getTransaction()` rejects if no matching transaction is found or the lookup fails; a rejection alone does not prove the transaction was not included.

Or watch for inclusion with a [transaction listener](https://nimiq.dev/web-client/guides/listen-for-events#track-transactions-for-an-address):

```js
await client.addTransactionListener(
  (tx) => console.log('Transaction:', tx.transactionHash, tx.state, tx.executionResult),
  [sender],
)
```

## Fees

A fee of `0n` is valid for most transactions. Fees become relevant when the network is congested — higher fees increase the priority of your transaction. Fees are denominated in luna.

## Next steps

- [Stake NIM](https://nimiq.dev/web-client/guides/stake-nim) — use transactions to create stakers and delegate to validators
- [Query the Blockchain](https://nimiq.dev/web-client/guides/query-the-blockchain) — check balances and transaction history
- [API Reference](https://nimiq.dev/web-client/reference) — full TransactionBuilder and Client method signatures


## Sitemap

See the full [sitemap](https://nimiq.dev/sitemap.md) for all pages.