Sign in
latestOpenAPI 3.0.32026-08-224982,0272.8 MB

e445c15e5bee

Mint

Create an order

Submits a new mint or burn order for the enterprise

post/api/mint/v1/enterprise/{enterpriseId}/orders

Path parameters

enterpriseIdstring required
Example:67bc4ae090e8af8f9b412d3d67e85252

Enterprise ID submitting the order

Request body

idempotencyKeystring

Idempotency key to prevent duplicate order creation. Scoped per enterprise — the same key can be reused across different enterprises. Leading/trailing whitespace is stripped on decode; an all-whitespace value is rejected.

memostring

Optional free-text annotation for internal reference (max 500 characters). Stored on the order and returned in all read responses.

Example request

{
  "idempotencyKey": "mint-order-2025-04-04-001",
  "memo": "Q2 rebalance batch 3",
  "source": {
    "asset": "sol:usd1",
    "amount": "1000500000",
    "walletId": "67bc4b038f5408faefbfc8edcf6e6577",
    "type": "GO_ACCOUNT"
  },
  "destination": {
    "asset": "fiatusd",
    "address": "0x123456789abcdef123456789abcdef123456789a",
    "walletId": "67bc4b038f5408faefbfc8edcf6e6577"
  }
}

Response

Created

idstring required

Unique identifier for the exchange order @example "95bdbd9c-9cdc-41a4-ae70-165387b7aa51"

userIdstring required

User identifier @example "6437d9f07d6a87000613e6c06e4218d3"

type'MINT' | 'BURN' required

Order direction — MINT or BURN (derived from the execution plan)

status'CREATED' | 'CONFIRMED_DEPOSIT' | 'PROCESSING' | 'FULFILLED' | 'FAILED' required

Current status of the exchange order @example "CREATED"

enterpriseIdstring required

Enterprise identifier @example "67bc4ae090e8af8f9b412d3d67e85252"

createdAtstring date-time required

ISO8601 creation timestamp @example "2025-04-04T09:25:48.216Z"

updatedAtstring date-time required

ISO8601 last-updated timestamp @example "2025-04-04T09:25:48.216Z"

idempotencyKeystring

Idempotency key — present only when the order was created with one

orderMethod'ISSUER_DIRECT'

Present only for issuer-direct orders. Absent means standard deposit flow.

memostring

Free-text annotation provided at order creation @example "Q2 rebalance batch 3"

Example response

{
  "type": "MINT",
  "destination": {
    "address": "0x123456789abcdef123456789abcdef123456789a",
    "walletId": "67bc4b038f5408faefbfc8edcf6e6577",
    "transferId": "6437d9f07d6a87000613e6c06e4218d3",
    "transactionHash": "0xdeadbeef..."
  },
  "fee": {
    "basisPoints": "5"
  },
  "idempotencyKey": "mint-order-2025-04-04-001",
  "depositInstructions": {
    "type": "GO_ACCOUNT",
    "sequenceId": "order-deposit:95bdbd9c-9cdc-41a4-ae70-165387b7aa51",
    "address": "0x123456789abcdef123456789abcdef123456789a"
  },
  "orderMethod": "ISSUER_DIRECT"
}