The world's most scalable transaction broadcast manager

Reports liveness of the API server process and the upstream Datahub endpoints it depends on. Suitable as a Kubernetes liveness probe. blockHeight is this instance's processed chain-tip height — a freshness signal (datahub_urls[].healthy is reachability-only), letting clients detect a stale chain view and route around it. Each datahub_urls entry also carries the transaction policy that node advertised, so a policy rejection can be traced to the endpoint that enforced it; policy is absent for endpoints no node_status has announced.

{
  "healthy": true,
  "version": "v0.8.0",
  "status": "ok",
  "blockHeight": 958779,
  "datahub_urls": [
    {
      "url": "https://...",
      "source": "discovered",
      "healthy": true,
      "policy": {
        "miningFee": { "satoshis": 100, "bytes": 1000 },
        "maxtxsizepolicy": 100000000,
        "maxscriptsizepolicy": 500000,
        "maxtxsigopscountspolicy": 4294967295
      }
    }
  ]
}

Indicates that the process has finished start-up and is ready to accept traffic. Suitable as a Kubernetes readiness probe.

{
  "status": "ready"
}

Returns Arcade's effective transaction policy in the ARC schema so clients can discover the fee rate and size limits before building transactions. Every value reflects exactly what intake enforces. When the operator hasn't pinned a fee, miningFee tracks the lowest fee the network will accept — the minimum advertised across peer node_status announcements — and Arcade enforces that same floor at intake; it falls back to the built-in default until a peer is heard. Also served at /v1/policy.

{
  "policy": {
    "miningFee": { "satoshis": 100, "bytes": 1000 },
    "maxtxsizepolicy": 10485760,
    "maxscriptsizepolicy": 500000,
    "maxtxsigopscountspolicy": 4294967295,
    "standardFormatSupported": true
  },
  "timestamp": "2026-08-07T12:00:00Z"
}

Returns the current lifecycle state of a previously submitted transaction, including its merkle path once mined. With ?callbackToken=<token> the response adds a callbacks array: the webhook delivery state (attempts, lastAttemptAt, lastResult, nextRetryAt) of that token's submissions — lastResult "status 403" with climbing attempts means arcade is POSTing and the receiver's edge is refusing.

{
  "txid": "<hex>",
  "txStatus": "SEEN_ON_NETWORK",
  "status": "SEEN_ON_NETWORK",
  "timestamp": "2026-05-20T12:00:00Z",
  "blockHash": "<hex|null>",
  "blockHeight": 870123,
  "merklePath": "<BUMP hex|null>",
  "extraInfo": "",
  "competingTxs": [],
  "callbacks": [
    {
      "callbackUrl": "https://...",
      "lastDeliveredStatus": "SEEN_ON_NETWORK",
      "attempts": 14,
      "lastAttemptAt": "2026-05-20T12:00:00Z",
      "lastResult": "status 403",
      "nextRetryAt": "2026-05-20T12:05:00Z"
    }
  ]
}

Long-lived Server-Sent Events stream that pushes lifecycle updates for every transaction submitted under the supplied callback token. Hosted by Arcade's standalone SSE service — a separate listener from the main API (default port 8082, fronted by its own Kubernetes Service in production). CORS is permissive on this endpoint so browsers can connect directly with the EventSource API.

GET /events?callbackToken=my-token

const es = new EventSource(
  "https://arcade.example.com/events?callbackToken=my-token"
);
es.addEventListener("status", (e) => {
  const status = JSON.parse(e.data);
  console.log(status.txid, status.txStatus);
});

curl -N "https://arcade.example.com/events?callbackToken=my-token"

id: 1716205200123456789
event: status
data: {"txid":"<hex>","txStatus":"SEEN_ON_NETWORK","timestamp":"2026-05-20T12:00:00Z"}

id: 1716205260987654321
event: status
data: {"txid":"<hex>","txStatus":"MINED","timestamp":"2026-05-20T12:01:00Z"}

: keepalive

Submits one Bitcoin SV transaction for validation, propagation, and lifecycle tracking. Synchronous policy validation runs before the 202 is returned; fee and script checks are delegated to the network. Pick the body encoding that matches your client — raw bytes are the most efficient.

<binary raw transaction bytes>

0100000001abc...def00000000

{
  "rawTx": "0100000001abc...def00000000"
}

{
  "txid": "<hex>",
  "status": 202,
  "txStatus": "RECEIVED"
}

// Idempotent re-submit of a txid Arcade has already seen (txStatus echoes the existing state):
{
  "txid": "<hex>",
  "status": 202,
  "txStatus": "SEEN_ON_NETWORK"
}

Submits a batch of concatenated raw transactions in a single HTTP request. Each transaction is parsed, validated, dedup-CAS'd, and published as part of one fan-out. Bodies are capped at 256 MiB.

<binary raw tx 1><binary raw tx 2>...<binary raw tx N>

{
  "submitted": 42,
  "duplicates": 3,
  "total": 45
}

Internal endpoint used by the Merkle Service to deliver SEEN_ON_NETWORK, SEEN_ON_MULTIPLE_NODES, STUMP and BLOCK_PROCESSED events. Bearer authentication is mandatory; the deployment refuses to start without a configured callback token.

{
  "type": "SEEN_ON_NETWORK",
  "txid": "<hex>",
  "txids": ["<hex>", "..."],
  "blockHash": "<hex>",
  "subtreeIndex": 0,
  "stump": "<base64>"
}

(empty body)

Lists block processing milestones (header seen, BLOCK_PROCESSED received, compound BUMP built) in descending-height order. Paginates via a height-cursor; pass the lowest height returned from the previous page as before-height to fetch the next page.

GET /api/v1/blocks/processing-status?limit=50&before-height=870000

{
  "blocks": [
    {
      "blockHash": "<hex>",
      "blockHeight": 870123,
      "headerSeenAt": "2026-05-20T12:00:00Z",
      "processedAt": "2026-05-20T12:00:30Z",
      "bumpBuiltAt": "2026-05-20T12:00:45Z",
      "status": "compound-bump-built",
      "orphanedAt": null,
      "hasBlockProcessed": true,
      "hasCompoundBUMP": true
    }
  ],
  "nextCursor": 870000
}

Returns the block processing milestones for one block, looked up by block hash.

{
  "blockHash": "<hex>",
  "blockHeight": 870123,
  "headerSeenAt": "2026-05-20T12:00:00Z",
  "processedAt": "2026-05-20T12:00:30Z",
  "bumpBuiltAt": "2026-05-20T12:00:45Z",
  "status": "compound-bump-built",
  "orphanedAt": null,
  "hasBlockProcessed": true,
  "hasCompoundBUMP": true
}

Requests that the upstream Merkle Service re-emit STUMP and BLOCK_PROCESSED callbacks for the given block hash. Useful for healing a deployment whose callback stream missed a block.

{
  "status": "accepted",
  "blockHash": "<hex>"
}