v1

latestOpenAPI 3.0.22026-07-26123510445.2 KB

Transfer (Out/In)

Create Transfer

Initiate an XUSD fund transfer from the Stablecoin Account to the Issuing account (Type: transfer-out: 4001). Fiat transfers between the Stablecoin Account and Global Account are no longer supported. Stablecoin Account API Publisher Disclaimer

post/v1/ramp/transfer

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 created 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"
  }
}