Skip to main content
POST
/
submitTx
Submit Gasless Transaction
curl --request POST \
  --url https://api-v2.swaps.xyz/api/submitTx \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "txId": "<string>",
  "chainId": 123,
  "executions": [
    {
      "txType": "tronTransactionSign",
      "data": "<string>",
      "signature": "<string>"
    }
  ]
}
'
{
  "success": true,
  "txId": "<string>",
  "error": "<string>"
}

Authorizations

​
x-api-key
string
header
required

Limited demo key for API Reference: 5c951bc81da566bbd030ba8e20724063.

Body

application/json
​
txId
string
required

The txId from the GET /getAction quote response. Used to correlate the signed executions with the original action on the relay.

​
chainId
integer
required

Source chain ID of the swap.

​
executions
object[]
required

All execution steps from the getAction response, each with a signature field populated by the user's wallet. Must be in the same order as returned by getAction.

A single signing step returned in the executions array of a gasless getAction response. Only available for Tron same-chain swaps. The client must sign each item in order and include the signatures when calling POST /submitTx.

Response

Transaction accepted for relay broadcast

​
success
boolean
required

Whether the relay broadcast was accepted.

​
txId
string

Internal transaction ID. Pass this to GET /getStatus to poll for completion — the status endpoint will return the on-chain transaction hash once the relay broadcast confirms.

​
error
string

Error message when success is false.