REST APIStablecoin

POST

Creates a mint or burn order via the issuer-direct (Path 2) flow, bypassing the standard client deposit verification.

Path Params

  • enterpriseId string required
    Enterprise id

    at least 1 characters

Body Params

object

Parameters for creating issuer-direct stablecoin orders (bypass deposit verification, no fees applied)
  • type string enum required
    Type of order operation (mint or burn)
    mintburn
  • asset string required
    Full asset identifier (e.g., "eth:usd1", "hteth:sofid")

    at least 1 characters

  • amount string required
    Amount in base units. For burn, this is stablecoin base-units. For mint: stablecoin base-units when the enterprise has the stablecoins-issuer-mint-stablecoin-units flag enabled; otherwise USD base-units (e.g. cents) for legacy behavior.

    matches ^[1-9][0-9]*$

  • destinationType string enum required
    Type of destination for the order. Only go_account is supported for both mint and burn.
    go_account
  • destinationWalletId string required
    Destination wallet identifier. Required for all order types.

    at least 1 characters

Responses

200
OK

Response Body

object

  • asset string
    Full asset identifier (e.g., "eth:usd1", "hteth:sofid")

    at least 1 characters

  • destinationWalletId string
    Destination wallet identifier
  • destinationAddress string
    Destination blockchain address

    at least 1 characters · matches ^[0-9a-f]{32}$

  • userId string
    User identifier who initiated the order

    at least 1 characters

  • clientDepositTxHash string
    Transaction hash of the client deposit

    at least 1 characters

  • transactions array of objects
    transactions object
    • type string enum required
      Transaction type
      clientDepositmintburnburnTokenTransferclientDisbursementtreasuryMintTransfertreasuryBurnTransfermintRequestmintOffermintAcceptmintTransferburnRequestburnAccept
    • txHash string nullable required
      Transaction hash (for on-chain transactions)

      at least 1 characters

    • asset string required
      Asset token identifier

      at least 1 characters

    • amount string required
      Transaction amount in lowest denomination

      at least 1 characters

    • status string enum required
      Current status of transaction
      initiatedsignedunconfirmedconfirmedrejectedfailed
    • createdAt string required
      Timestamp when transaction was created
    • updatedAt string required
      Timestamp when transaction was last updated
  • memo string
    Optional free-text memo or comment annotating the order.
  • createdAt string date-time required
    Timestamp when the order was created
  • updatedAt string date-time required
    Timestamp when the order was last updated
  • fromAssetId string uuid required
    Source asset identifier (UUID)
  • toAssetId string uuid required
    Destination asset identifier (UUID)
  • fromAsset string required
    Source asset token identifier

    at least 1 characters

  • fromAmount string required
    Amount to be transferred from source asset, specified in its lowest denomination.

    at least 1 characters

  • toAsset string required
    Destination asset token identifier

    at least 1 characters

  • toAmount string required
    Amount to be received in destination asset

    at least 1 characters

  • orderMethod string enum
    How the order was initiated: issuer-direct or standard client deposit flow
    issuer_directclient_deposit
  • id string uuid required
    Unique identifier for the order
  • type string enum required
    Type of order operation
    mintburnreward
  • status string enum required
    Current status of the order
    createdconfirmed_fiat_depositconfirmed_token_depositinitiated_burn_token_transfercompleted_burn_token_transferapproved_minttriggering_minttriggering_burncompleted_burnapproved_client_disbursalinitiated_client_disbursalfulfilledfailed_mint_initiationfailed_mint_transactionfailed_burn_transactionfailed_burn_token_transferfailed_to_mintfailed_to_burnfailed_to_initiate_disbursalfailed_to_complete_disbursalrejectedfailedexpiredtriggering_mint_requestcompleted_mint_requesttriggering_mint_offercompleted_mint_offertriggering_mint_acceptcompleted_mint_accepttriggering_mint_transferfailed_to_mint_requestfailed_to_mint_offerfailed_to_mint_acceptfailed_to_mint_transferrejected_mint_transfercancelled_mint_transferexpired_mint_transfertriggering_burn_requestcompleted_burn_requesttriggering_burn_acceptfailed_to_burn_requestfailed_to_burn_accept
  • enterpriseId string required
    The Enterprise ID

    at least 1 characters · matches ^[0-9a-f]{32}$

400
Bad Request
No response body
401
Unauthorized
No response body
403
Forbidden
No response body
500
Internal Server Error
No response body