v1

latestOpenAPI 3.1.02026-07-2411601020.7 KB

Create a bank account

[Available in Production/Sandbox environment] Add a new bank account to the user's StraitsX account. Supports both Singapore and overseas bank accounts.

post/withdrawals/bank-accounts

Headers

X-XFERS-APP-API-KEYstring required

You can retrieve this from your Dashboard Developer Tools. Note: 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. Note: 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. Note: 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. Regex: /\A[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}\z/i Note: 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. Note: This header attribute is required when HTTP Request Signing is enabled for your account.

Request body

Response

201

Example response

{
  "data": {
    "id": "bank_account_6f0a69c0-1837-4968-9866-e32389c1234",
    "type": "bankAccount",
    "attributes": {
      "accountHolderName": "JOHN DOE",
      "accountNo": "0123456789",
      "bank": "DBS",
      "swiftBic": "DBSSSGSGXXX",
      "status": "pending",
      "createdAt": "2025-03-05T11:43:41.866+08:00",
      "updatedAt": "2025-03-05T11:43:41.866+08:00"
    }
  }
}