v1

latestOpenAPI 3.0.22026-07-26123510445.2 KB

Transfers

Create Issuing Transfer

Create a new issuing transfer by specifying the source account ID, destination account ID, currency, and other relevant information.

This API is specifically designed for fund transfers between the master account and its sub-accounts, and does not apply to cross-business-line or external transfers.

post/v1/issuing/transfers

Headers

x-on-behalf-ofstring

Specifies the sub-account on whose behalf the request is made. This should be set to the account_id, which can be retrieved via the List Connected Accounts API. If omitted or empty, the request is executed using the master account. More information at Connected Accounts.

x-idempotency-keystring uuid

A unique identifier (UUID) used to maintain operation idempotency, ensuring that repeated executions of the same operation do not result in unintended effects or duplication. It helps preserve data consistency in the face of network errors, retries, or failures.

Request body

currencystring required

Wallet currency for this transfer. Only XUSD is supported.

amountstring required

Amount for this transfer

type4001 required

Transfer type. Only 4001 (transfer out to the Issuing account) is supported.

reasonstring

Transaction remark

Example request

{
  "currency": "XUSD",
  "amount": "100.50",
  "type": 4001,
  "reason": "Business transfer"
}

Response

Transfer creation successfully.

codeinteger required

messagestring required

Example response

{
  "code": 200,
  "message": "Success",
  "data": {
    "order_id": "3c9e22ba-7b5e-4b7c-b92e-197d0406b86b",
    "short_order_id": "TO260123-JZBHC9IA",
    "order_status": "Pending",
    "order_type": "Transfer Out",
    "amount": 100,
    "currency": "USD",
    "reason": "testAPI",
    "create_time": "2026-01-23 13:12:27 +08:00"
  }
}