---
title: "Broadcast transaction"
method: POST
path: "/bus/txpool/broadcast"
tags: ["bus"]
---

# Broadcast transaction

`POST /bus/txpool/broadcast`

Broadcasts the specified transaction.

## Request body

- Transaction
  - `siacoinInputs` SiacoinInput[] — List of Siacoin inputs used in the transaction.
    - `parentID` string — The ID of the output being spent
    - `unlockConditions` object — The unlock conditions required to spend the output
      - `timelock` integer — The block height at which the outputs can be spent
      - `publicKeys` UnlockKey[]
        - `algorithm` string, bytes — A fixed 16-byte array that specifies the algorithm used to generate the key
        - `key` string, bytes — A 32-byte key represented as a hex-encoded string. Must be exactly 64 characters long, containing only hexadecimal digits
      - `signaturesRequired` integer — The number of signatures required to spend the output
  - `siacoinOutputs` SiacoinOutput[] — List of Siacoin outputs created by the transaction.
    - `value` string — The amount of Siacoins in the output
    - `address` string — The hash of a set of UnlockConditions
  - `fileContracts` FileContract[] — List of file contracts created by the transaction.
    - `filesize` integer — The size of the contract in bytes.
    - `fileMerkleRoot` string — The Merkle root of the contract's data.
    - `windowStart` integer — The block height when the contract's proof window starts.
    - `windowEnd` integer — The block height when the contract's proof window ends.
    - `payout` string — The total payout for the contract.
    - `validProofOutputs` SiacoinOutput[] — List of outputs created if the contract is successfully fulfilled.
      - `value` string — The amount of Siacoins in the output
      - `address` string — The hash of a set of UnlockConditions
    - `missedProofOutputs` SiacoinOutput[] — List of outputs created if the contract is not fulfilled.
      - `value` string — The amount of Siacoins in the output
      - `address` string — The hash of a set of UnlockConditions
    - `unlockHash` string — The hash of a set of UnlockConditions
    - `revisionNumber` integer — The revision number of the contract
  - `fileContractRevisions` FileContractRevision[] — List of revisions to existing file contracts included in the transaction.
    - `parentID` string — The ID of the parent file contract being revised.
    - `unlockConditions` object — The conditions required to unlock the contract for revision.
      - `timelock` integer — The block height at which the outputs can be spent
      - `publicKeys` UnlockKey[]
        - `algorithm` string, bytes — A fixed 16-byte array that specifies the algorithm used to generate the key
        - `key` string, bytes — A 32-byte key represented as a hex-encoded string. Must be exactly 64 characters long, containing only hexadecimal digits
      - `signaturesRequired` integer — The number of signatures required to spend the output
    - `filesize` integer — The size of the file in bytes after the revision.
    - `fileMerkleRoot` string — The updated Merkle root of the file's data.
    - `windowStart` integer — The block height when the revised proof window starts.
    - `windowEnd` integer — The block height when the revised proof window ends.
    - `validProofOutputs` SiacoinOutput[] — Updated outputs if the revised contract is successfully fulfilled.
      - `value` string — The amount of Siacoins in the output
      - `address` string — The hash of a set of UnlockConditions
    - `missedProofOutputs` SiacoinOutput[] — Updated outputs if the revised contract is not fulfilled.
      - `value` string — The amount of Siacoins in the output
      - `address` string — The hash of a set of UnlockConditions
    - `unlockHash` string — The updated hash of the conditions required to unlock the contract funds.
    - `revisionNumber` integer — The revision number of the contract
  - `storageProofs` StorageProof[] — List of storage proofs asserting the storage of data for file contracts.
    - `parentID` string — The ID of the file contract being proven.
    - `leaf` string, byte — The selected leaf from the Merkle tree of the file's data.
    - `proof` Hash256[] — The Merkle proof demonstrating the inclusion of the leaf.
  - `siafundInputs` SiafundInput[] — List of Siafund inputs spent in the transaction.
    - `parentID` string — The ID of the parent Siafund output being spent.
    - `unlockConditions` object — The conditions required to unlock the parent Siafund output.
      - `timelock` integer — The block height at which the outputs can be spent
      - `publicKeys` UnlockKey[]
        - `algorithm` string, bytes — A fixed 16-byte array that specifies the algorithm used to generate the key
        - `key` string, bytes — A 32-byte key represented as a hex-encoded string. Must be exactly 64 characters long, containing only hexadecimal digits
      - `signaturesRequired` integer — The number of signatures required to spend the output
    - `claimAddress` string — The address receiving the Siacoin claim generated by the Siafund output.
  - `siafundOutputs` SiafundOutput[] — List of Siafund outputs created by the transaction.
    - `value` integer — The amount of Siafund in the output.
    - `address` string — The address receiving the Siafund.
  - `minerFees` Currency[] — List of miner fees included in the transaction.
  - `arbitraryData` string[] — Arbitrary binary data included in the transaction.
  - `signatures` TransactionSignature[] — List of cryptographic signatures verifying the transaction.
    - `parentID` string — The ID of the transaction being signed
    - `publicKeyIndex` integer — The index of the public key used to sign the transaction
    - `timelock` integer — The block height at which the outputs in the transaction can be spent
    - `coveredFields` object — Indicates which fields of the transaction are covered by the signature
      - `wholeTransaction` boolean — Whether the whole transaction is covered by the signature
      - `siacoinInputs` integer[]
      - `siacoinOutputs` integer[]
      - `fileContracts` integer[]
      - `fileContractRevisions` integer[]
      - `storageProofs` integer[]
      - `siafundInputs` integer[]
      - `siafundOutputs` integer[]
      - `minerFees` integer[]
      - `arbitraryData` integer[]
      - `signatures` integer[]
    - `signature` string, byte — The signature of the transaction

## Response `200`

Successfully broadcast transaction

## Other responses

- `500` — Internal server error

---

[API](https://skmtc.net/siafoundation/apis/renterd-api.md) · [All operations](https://skmtc.net/siafoundation/apis/renterd-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/siafoundation/renterd-api/versions/184a3d5207da/schema)