Skip to main content
POST
transactions - Execute a balance swap from a promise

Headers

authorization
string
required

The API key as a string.

signature
string
required

See the Generating Signature section for more details.

timestamp
number
required

A timestamp in milliseconds. See the Timestamp Security section for more details.

timstamp-tolerance
number

An additional, non-required parameter, that you can send to specify the number of milliseconds after the timestamp for the request to be valid. See the Timestamp Security section for more details.

Body

application/json
promise
string
required

The swap promise token (uuid) returned by POST /transactions/quotes/.

Example:

"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."

Response

Swap transaction created successfully.

error_code
string
message
string
data
object

Transaction object returned by the transactions list, detail and creation endpoints (GET /transactions/, GET /transactions/{id}/, and the 201 responses of every /transactions/{rail}/{action}/ endpoint). All three surfaces share this exact shape.