Join our community of builders on

Telegram!Telegram
HomeForumWebsiteImpact
GitHub Icon

Sends a transaction through the specified relayer.

Development Documentation

You're viewing documentation for unreleased features from the main branch. For production use, see the latest stable version (v1.3.x).
AnthropicOpen in Claude
POST
/api/v1/relayers/{relayer_id}/transactions

Authorization

AuthorizationBearer <token>

In: header

Path Parameters

relayer_idstring

The unique identifier of the relayer

Request Body

data?string
gas_limit?integer | null
Formatint64
Range0 <= value
gas_price?integer
Range0 <= value
max_fee_per_gas?integer
Range0 <= value
max_priority_fee_per_gas?integer
Range0 <= value
speed?Speed
Value in"fastest" | "fast" | "average" | "safeLow"
to?string
valid_until?string
valueinteger
Formatu128
Range0 <= value
instructions?array<SolanaInstructionSpec> | null

Instructions to build transaction from (mutually exclusive with transaction)

transaction?EncodedSerializedTransaction | null
valid_until?string | null

Optional RFC3339 timestamp when transaction should expire

fee_bump?boolean | null

Explicitly request fee-bump wrapper Only valid when transaction_xdr contains a signed transaction

max_fee?integer | null

Maximum fee in stroops (defaults to 0.1 XLM = 1,000,000 stroops)

Formatint64
memo?MemoSpec | null
typestring
Value in"none"
typestring
Value in"text"
valuestring
typestring
Value in"id"
valueinteger
Formatint64
Range0 <= value
typestring
Value in"hash"
valuearray<integer>
typestring
Value in"return"
valuearray<integer>
networkstring
operations?array<OperationSpec> | null
signed_auth_entry?string | null

Signed Soroban authorization entry (base64 encoded SorobanAuthorizationEntry XDR) Used for Soroban gas abstraction: contains the user's signed auth entry from /build response. When provided, transaction_xdr must also be provided (the FeeForwarder transaction from /build). The relayer will inject this signed auth entry into the transaction before submitting.

source_account?string | null
transaction_xdr?string | null

Pre-built transaction XDR (base64 encoded, signed or unsigned) Mutually exclusive with operations field. For Soroban gas abstraction: submit the transaction XDR from sponsored/build response with the user's signed auth entry updated inside.

valid_until?string | null

Response Body

curl -X POST "https://loading/api/v1/relayers/string/transactions" \  -H "Content-Type: application/json" \  -d '{    "value": 0  }'
{
  "data": {
    "confirmed_at": "string",
    "created_at": "string",
    "data": "string",
    "from": "string",
    "gas_limit": 0,
    "gas_price": "string",
    "hash": "string",
    "id": "string",
    "max_fee_per_gas": "string",
    "max_priority_fee_per_gas": "string",
    "nonce": 0,
    "relayer_id": "string",
    "sent_at": "string",
    "signature": {},
    "speed": {},
    "status": "canceled",
    "status_reason": "string",
    "to": "string",
    "value": "string"
  },
  "error": "string",
  "metadata": {
    "logs": [
      {
        "level": "log",
        "message": "string"
      }
    ],
    "traces": [
      null
    ]
  },
  "pagination": {
    "current_page": 0,
    "per_page": 0,
    "total_items": 0
  },
  "success": true
}
{
  "data": null,
  "message": "Bad Request",
  "success": false
}
{
  "data": null,
  "message": "Unauthorized",
  "success": false
}
{
  "data": null,
  "message": "Relayer with ID relayer_id not found",
  "success": false
}
{
  "data": null,
  "message": "Too Many Requests",
  "success": false
}
{
  "data": null,
  "message": "Internal Server Error",
  "success": false
}