BSV blockchainBSV blockchain

Submit a batch of transactions

POST/v1/txs

Submits an array of raw transactions in a single HTTP request. The SDK’s ARC.broadcastMany() calls this endpoint. Each item in the array contains a single rawTx field (hex-encoded).

Responses are an array of the same length, where each element corresponds to the same-index input transaction. Some may succeed while others fail.

Header Parameters

Authorizationstring

Bearer token: Bearer <apiKey>

XDeployment-IDstring

Deployment identifier for correlating requests. Auto-generated if not set.

X-CallbackUrlstring

HTTPS URL to which ARC will POST a Merkle proof callback once the transaction has been mined.

X-CallbackTokenstring

Bearer token that ARC will include in the Authorization header when calling the callback URL. Used to verify the callback origin.

Body application/json

rawTxstringrequired

Hex-encoded raw transaction. The ts-sdk attempts Extended Format (EF) first; falls back to standard raw hex when source transactions are missing.

Response

Array of per-transaction results. Each element may be a success (ArcTxResponse) or an error (ArcErrorResponse). The array length matches the input array length.

txidstring

Transaction ID.

txStatus"STORED" | "ANNOUNCED_TO_NETWORK" | "REQUESTED_BY_NETWORK" | "SENT_TO_NETWORK" | "ACCEPTED_BY_NETWORK" | "SEEN_ON_NETWORK" | "MINED" | "SEEN_IN_ORPHAN_MEMPOOL" | "DOUBLE_SPEND_ATTEMPTED" | "REJECTED" | "INVALID" | "MALFORMED" | "MINED_IN_STALE_BLOCK" | "UNKNOWN"

Network status of the transaction as reported by ARC. Success statuses (HTTP 200, not treated as failure):

  • STORED — received but not yet broadcast
  • ANNOUNCED_TO_NETWORK — gossiped to peers
  • REQUESTED_BY_NETWORK — requested by a peer
  • SENT_TO_NETWORK — submitted to the network
  • ACCEPTED_BY_NETWORK — accepted by at least one miner
  • SEEN_ON_NETWORK — seen propagating on the network
  • MINED — included in a block (Merkle proof available)
  • SEEN_IN_ORPHAN_MEMPOOL — in an orphan block mempool (not a stable success) Failure statuses (HTTP 200 body, treated as BroadcastFailure by ts-sdk):
  • DOUBLE_SPEND_ATTEMPTED
  • REJECTED
  • INVALID
  • MALFORMED
  • MINED_IN_STALE_BLOCK
  • (any value containing “ORPHAN” in extraInfo or txStatus) Unknown:
  • UNKNOWN
extraInfostring

Additional human-readable context about the status.

competingTxsstring[]

Present when txStatus is DOUBLE_SPEND_ATTEMPTED. Lists competing transaction IDs.

Batch-level bad request.

txidstring

Transaction ID if known at the time of error.

detailstring

Human-readable error detail. Mapped to description in BroadcastFailure.

statusinteger

HTTP status code echoed in the body (ARC convention).

titlestring

Short error title.

typestring<uri>

URI identifying the error type.

instancestring

URI identifying the specific occurrence.

extraInfostring

Unauthorized.

txidstring

Transaction ID if known at the time of error.

detailstring

Human-readable error detail. Mapped to description in BroadcastFailure.

statusinteger

HTTP status code echoed in the body (ARC convention).

titlestring

Short error title.

typestring<uri>

URI identifying the error type.

instancestring

URI identifying the specific occurrence.

extraInfostring

Internal server error.

txidstring

Transaction ID if known at the time of error.

detailstring

Human-readable error detail. Mapped to description in BroadcastFailure.

statusinteger

HTTP status code echoed in the body (ARC convention).

titlestring

Short error title.

typestring<uri>

URI identifying the error type.

instancestring

URI identifying the specific occurrence.

extraInfostring
Request
curl -X POST "https://arc.taal.com/v1/txs" \
  -H "Content-Type: application/json" \
  -H "Authorization: <Authorization>" \
  -H "XDeployment-ID: <XDeployment-ID>" \
  -H "X-CallbackUrl: <X-CallbackUrl>" \
  -H "X-CallbackToken: <X-CallbackToken>" \
  -d '[
  {
    "rawTx": "0100000001..."
  }
]'
Response
[
  {
    "txid": "string",
    "txStatus": "STORED",
    "extraInfo": "string",
    "competingTxs": [
      "string"
    ]
  }
]