Initiate new On-chain Trade Transaction

Initiate a new on-chain transaction to trade assets.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
uuid
required
Body Params
string
required

Unique ID to ensure idempotency

string
required

Code of asset to sell

string
required

The total amount to be sold

string
required

Code of asset to buy

string | null

Optional quote ID, does market order if not provided

string | null

Optional fee to pay treasury in from_asset_code for network fee

Responses

400

Possible reasons:

  • amount must be positive
  • amount must not be negative
  • unknown from asset_code
  • unknown to asset_code
  • transaction with this external_id was already attempted
500

Possible reasons:

  • failed to get asset code
  • failed to get asset code
  • failed to get authority public key
  • attempt to verify existing contract failed
  • failed to get treasury user
  • treasury user is not configured
  • could not begin transactional query
  • failed to save contract
  • failed to save contract actions
  • failed to create transaction
  • failed to commit database transaction
Language
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json