Initiate new On-chain Transaction to burn assets

Initiate a new on-chain transaction to burn funds

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 transfer.

string
required
^-?[0-9]+(\.[0-9]+)?$

Amount to transfer.

string
enum
required
Allowed:
string | null

Optional memo to attach to transaction.

string | null

Optional backend vendor, defaults to default custody vendor

Responses

400

Possible reasons:

  • amount must be positive
  • asset code not configured for vendor
  • asset must not be a base asset
  • custody vendor not configured
  • transaction with this external_id was already attempted
401

Not authenticated

403

the authority account cannot be used as the account for a transaction

404

Not found

409

user is archived

422

The request body is valid JSON but does not match the expected schema.

500

Possible reasons:

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