API Reference

Batch Send

Submit multiple signed transactions in a single request for high-throughput delivery.

POST/v1/send/batch

Request

Headers

Headers	Value	Required
Authorization	Bearer YOUR_API_KEY	Required
Content-Type	application/json	Required

Body Parameters

Field	Type	Description
transactions	string[]	Array of base64-encoded signed transactions (max 100)

Example Request

cURL

curl -X POST https://bolttx.io/v1/send/batch \
  -H "Authorization: Bearer btx_live_abc123" \
  -H "Content-Type: application/json" \
  -d '{
    "transactions": [
      "AQAAAAAAAAAAAAAAAAAAAAA...",
      "AgAAAAAAAAAAAABBBBBBBB...",
      "AwAAAAAAAAAAAACCCCCCCC..."
    ]
  }'

Batch Limits

Each batch request accepts a maximum of 100 transactions. This cap is tuned to deliver every transaction at peak speed; larger batches see noticeably higher tail latency and are not recommended. Each transaction must independently include a valid tip instruction. Transactions that fail validation are reported individually in the response without affecting the rest of the batch.

Response

Success (200)

{
  "success": true,
  "results": [
    {
      "index": 0,
      "signature": "5xKnR8qXe...",
      "status": "sent"
    },
    {
      "index": 1,
      "signature": "3mPqY7wBz...",
      "status": "sent"
    },
    {
      "index": 2,
      "signature": null,
      "status": "failed",
      "error": "deserialize error: invalid transaction format"
    }
  ]
}

Result Fields

Field	Type	Description
index	number	Position of the transaction in the input array
signature	string \| null	Transaction signature, or null if rejected
status	string	"sent" or "failed"
error	string?	Error message if the transaction was rejected

Error Codes

Code	Message	Description
400	Invalid request	Missing transactions array or batch size exceeds 100
401	Unauthorized	Missing or invalid API key
429	Rate limit exceeded	Batch size N consumes N tokens from your plan's per-second TPS budget; the cap is per-user (shared across all your API keys)

Send Transaction Transaction Status