Skip to content
NoetherDocs
Endpoint referenceOrders and transactions

POST /v1/tx/submit

POST
/v1/tx/submit

Submit a signed Soroban transaction (base64 XDR) and poll until SUCCESS, FAILED, or pollTimeoutMs (default 30s). Resubmitting the same XDR is idempotent: a DUPLICATE is polled by hash and the prior result returned. When the RPC queue is full the response is 503 with a Retry-After header. FAILED transactions include the decoded Noether contract error number + name when one is present in the diagnostic events, and hostError when the host aborted outside contract code (a resource overrun reports type "budget", code "exceeded_limit") — previously such failures carried no detail.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/v1/tx/submit" \  -H "Content-Type: application/json" \  -d '{    "signedXdr": "string"  }'
{  "hash": "string",  "status": "SUCCESS",  "ledger": 0,  "contractError": null,  "hostError": null,  "txResultCode": null,  "resultXdr": "string"}