Sign in

v1

latestOpenAPI 3.1.02026-07-2411601020.7 KB

Create a blockchain withdrawal

[Available in Production environment] Send funds to your verified blockchain addresses with your StraitsX Business Account

post/blockchain_transfer/withdrawals

Headers

X-XFERS-APP-API-KEYstring required

You can retrieve this from your Dashboard Developer Tools.<br><br><strong>Note:</strong> The X-XFERS-APP-API-KEY is a mandatory header for all authentication methods, including standard API key usage and HTTP Request Signing mode.

X-PUBLIC-KEY-IDstring

The Key ID, can be retrieved from your StraitsX Dashboard.<br><br><strong>Note:</strong> This header attribute is required when HTTP Request Signing is enabled for your account.

X-TIMESTAMPstring

Current Unix epoch time in seconds. Must be within ±300 seconds of server time.<br><br><strong>Note:</strong> This header attribute is required when HTTP Request Signing is enabled for your account.

X-NONCEstring

A unique UUID string per request, used for replay protection. Must not be reused within the timestamp window.<br>Regex: /\A[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}\z/i<br><br><strong>Note:</strong> This header attribute is required when HTTP Request Signing is enabled for your account.

X-SIGNATUREstring

Base64-encoded digital signature of the canonical request string.<br><br><strong>Note:</strong> This header attribute is required when HTTP Request Signing is enabled for your account.

Request body

address_idstring required

Address ID is retrieved from the response of Get a list of blockchain addresses API<br>Regex: /^(?!\s*$).+$/

amountnumber float required

Transaction amount (Must be a positive float up to 2 d.p.)<br>Regex: /^(?!0(\.0+)?$)([1-9]\d*(\.\d+)?|0\.\d*[1-9]\d*)$/

idempotency_idstring required

Unique reference number provided by you to prevent double transaction, this cannot be repeated.<br>Regex: /^\s*.{1,191}\s*$/

wallet_source'sgd' | 'usd' | 'xsgd' | 'xusd'

Which source of funds the deduction will be made from. If no value is specified for this field, XSGD and XUSD withdrawals will, by default, be deducted from the XSGD and XUSD balances respectively.

Response

200

Example response

[
  {
    "data": {
      "id": "contract_42ecd1af41924578a71c1a5e75081dbe",
      "type": "stablecoin_withdraw_contract",
      "attributes": {
        "transaction_hash": "pending",
        "amount": "$13.00",
        "network_fees": "$3.00",
        "total_amount": "$16.00",
        "transaction_source": "0x4d9819943042ccb61d73690008193b25b6167e33",
        "status": "pending",
        "idempotency_id": "unique_trxn_id",
        "network": "Polygon",
        "token": "xsgd",
        "created_at": "2024-02-01T06:56:16.160Z"
      }
    }
  }
]