API Release 1.55

Deployed in UAT - Yes, available to test.

Deployed in Production - July 11, 2023.

🚀New Features - What’s New?

None

2. 🎉Feature Enhancements - We are making it better for you!!

2.1 Enhancement to Travel rules + bankAccountID combo

Existing Feature - With the current implementation of the Travel rule, it is required as a mandate for the partners to add the below-mentioned details for INSTANT_FUNDING deposits/redemptions

Bank Account Number
Bank Routing Number
Bank Name
Bank Address
Bank Country
Account Holder’s name
Account Holder’s Address
Account Holder’s country

What is improving? - Instead of asking partners to add the source details for Travel rules manually for every INSTANT_FUNDING request, we want to utilize the bank account API to capture the travel rule details.

POST bank-account changes for Travel Rule + Bank Account ID combo

{
  "bankAccountNumber":"123456789",
  "bankRoutingNumber":"CHASUS33",
  "userID":"userID",
  "bankAccountNickname": "Kakashi's spending ACRT account",
  "bankAccountPurpose" : "TRAVEL_RULE",
  "beneficiaryDetails" : {
      "accountHolderName" : "Kakashi Hatake",
      "accountHolderAddress" : "Village hidden in sand",
      "accountHolderCountry" : "JPN"
  },
  "bankName" : "Bank of Konoha",
  "bankAddress" : "Village hidden in mist",
  "bankCountry" : "JPN"
}

{
    "id": "bank_2b8c12f1-048b-44a1-ae83-c367972de5b4",
    "userDetails": {
        "userID": "d519fbf6-3a9a-4656-99a2-7e219776c678",
        "username": "test.individual.1688034596",
        "firstName": "Levi",
        "lastName": "Ackermann",
        "email": "b@b.com",
        "parentIB": {
            "id": "80f9b672-120d-4b73-9cc9-42fb3262c4b9",
            "name": "DriveWealth"
        },
        "wlpID": "DW"
    },
    "bankAccountDetails": {
        "bankAccountNickname": "Traveller's spending ACRT account",
        "bankAccountNumber": "****0027",
        "bankRoutingNumber": "121141822",
        "bankName": "Bank of Konoha",
        "bankAddress": {
            "addressLine1": "Village hidden in mist",
            "country": "Jpn"
        }
    },
    "default": false,
    "status": "ACTIVE",
    "bankAccountPurpose": "TRAVEL_RULE",
    "beneficiaryDetails": {
        "accountHolderName": "Kakashi Hatake",
        "accountHolderAddress": "Village hidden in sand",
        "accountHolderCountry": "Jpn"
    },
    "created": "2023-06-29T10:30:20.568Z",
    "updated": "2023-06-29T10:30:20.568Z"
}

🚧
Use the bankAccountID generated for making INSTANT_FUNDING deposit/Redemptions

{
   "accountNo": "DWQT000095",
   "amount": 1000,
   "currency": "USD",
   "type": "INSTANT_FUNDING",
   "note": "Here's some money",
   "bankAccountID": "bank_b47c01cc-bd1c-43df-bf05-512c926c140e"
}

{
   "accountNo": "DWQT000095",
   "amount": 100,
   "currency": "USD",
   "type": "INSTANT_FUNDING",
   "note": "Here's some money",
   "bankAccountID": "bank_b47c01cc-bd1c-43df-bf05-512c926c140e"
}

PATCH bank-account changes for Travel Rule + Bank Account ID combo

{
  "bankAccountPurpose" : "TRAVEL_RULE",
  "bankAccountDetails": {
        "bankName": "Bank of Konoha",
        "bankAddress": "Village Hidden in the Sand, Sunagakure",
        "bankCountry": "jpn",
        "accountHolderName": "Naruto Uzumaki",
        "accountHolderAddress": "Village Hidden in the Leaves, Konohagakure",
        "accountHolderCountry": "JPN"
    }
}

Expected change - This update will sit behind a Feature Toggle. When turned on for the partners, it will:

Rename bankAccountPurpose: TRAVEL_RULE
Return mandatory bank and beneficiary details for Travel rule in GET, PATCH, POST API.
Return bankAccountID in DEPOSIT/REDEMPTION in response for INSTANT_FUNDING.
Add all mandatory details in bankAccounts.created and bankAccounts.updated Event

2.2 Adding Position Quantity to orders.completed or positions.updated SQS events

Existing Feature - Currently, DW is only sending availableForTradingQuantity in the account summary endpoint.

What is improving? - Going forward, our partners will be able to consume openQuantity and availableForTradingQuantity within the following endpoint and SQS events.

getOrderById
getOrderByNo
getAuditOrderById
orders.completed event
orders.created event

{
    "id": "KE.64637a12-24f3-478c-a411-02de46f1fdf8",
    "orderNo": "KEWG000012",
    "type": "MARKET",
    "side": "SELL",
    "status": "FILLED",
    "symbol": "AA",
    "averagePrice": 33.66,
    "averagePriceRaw": 33.66,
    "totalOrderAmount": 33.66,
    "cumulativeQuantity": 1,
    "openQuantity": 7,
    "availableForTradingQuantity": 7,
    "quantity": 1,
    "fees": 2.99,
    "orderExpires": "2023-05-18T20:00:00.000Z",
    "createdBy": "9a8cebff-6b1f-4f99-bb9c-f6843626a684",
    "userID": "9a8cebff-6b1f-4f99-bb9c-f6843626a684",
    "accountID": "9a8cebff-6b1f-4f99-bb9c-f6843626a684.1682435763668",
    "accountNo": "DWXN000105",
    "created": "2023-05-18T13:24:32.259Z",
    "lastExecuted": "2023-05-18T13:30:02.153Z",
    "extendedHours": false,
    "preventQueuing": false
}

{
    "id": "KE.64637a12-24f3-478c-a411-02de46f1fdf8",
    "orderNo": "KEWG000012",
    "type": "MARKET",
    "side": "SELL",
    "status": "FILLED",
    "symbol": "AA",
    "averagePrice": 33.66,
    "averagePriceRaw": 33.66,
    "totalOrderAmount": 33.66,
    "cumulativeQuantity": 1,
    "openQuantity": 7,
    "availableForTradingQuantity": 7,
    "quantity": 1,
    "fees": 2.99,
    "orderExpires": "2023-05-18T20:00:00.000Z",
    "createdBy": "9a8cebff-6b1f-4f99-bb9c-f6843626a684",
    "userID": "9a8cebff-6b1f-4f99-bb9c-f6843626a684",
    "accountID": "9a8cebff-6b1f-4f99-bb9c-f6843626a684.1682435763668",
    "accountNo": "DWXN000105",
    "created": "2023-05-18T13:24:32.259Z",
    "lastExecuted": "2023-05-18T13:30:02.153Z",
    "extendedHours": false,
    "preventQueuing": false
}

{
    "id": "KE.64637a12-24f3-478c-a411-02de46f1fdf8",
    "orderNo": "KEWG000012",
    "accountID": "9a8cebff-6b1f-4f99-bb9c-f6843626a684.1682435763668",
    "accountNo": "DWXN000105",
    "quantities": {
        "requestedQuantity": 1,
        "totalFilledQuantity": 1
    },
    "openQuantity": 7,
    "availableForTradingQuantity": 7,
    "amountCash": 0,
    "status": "FILLED",
    "side": "SELL",
    "instrumentID": "1b474cec-97f7-4305-4d6e-f1ac72b8ee71",
    "symbol": "AA",
    "type": "1",
    "pricing": {
        "avgPxRaw": 33.66,
        "avgPx": 33.66,
        "stopPx": 0,
        "mitTriggerPrice": 0
    },
    "expires": "2023-05-18T20:00:00.000Z",
    "commissionOverride": {
        "commissionOverrideType": "NO_OVERRIDE",
        "commissionID": null,
        "commissionOverrideDesc": "Standard Commission"
    },
    "commissionAndFees": {
        "total": 2.99,
        "tefra": 0,
        "ptp": 0
    },
    "auditLog": [
        {
            "status": "NEW",
            "quantities": {
                "cumulativeQuantity": 0,
                "filledQuantity": 0,
                "remainingQuantity": 0
            },
            "pricing": {
                "averagePrice": 0,
                "averagePriceRaw": 0,
                "lastPrice": 0,
                "rateAsk": 0,
                "rateBid": 0
            },
            "commissionAndFees": {
                "commission": 0,
                "feeSec": 0,
                "feeTaf": 0,
                "feeBase": 0,
                "feeXtraShares": 0,
                "feeExchange": 0
            },
            "pnl": 0,
            "transactTime": "2023-05-18T13:24:32.097Z",
            "comment": "NOS started",
            "createdWhen": "2023-05-18T13:24:32.097Z"
        },
        {
            "status": "NEW",
            "quantities": {
                "cumulativeQuantity": 0,
                "filledQuantity": 0,
                "remainingQuantity": 1
            },
            "pricing": {
                "averagePrice": 0,
                "averagePriceRaw": 0,
                "lastPrice": 0,
                "rateAsk": 36.74,
                "rateBid": 36.4
            },
            "commissionAndFees": {
                "commission": 0,
                "feeSec": 0,
                "feeTaf": 0,
                "feeBase": 0,
                "feeXtraShares": 0,
                "feeExchange": 0
            },
            "pnl": 0,
            "transactTime": "2023-05-18T13:24:32.268Z",
            "comment": "NOS accepted",
            "createdWhen": "2023-05-18T13:24:32.268Z"
        },
        {
            "status": "FILLED",
            "quantities": {
                "cumulativeQuantity": 1,
                "filledQuantity": 1,
                "remainingQuantity": 0
            },
            "pricing": {
                "averagePrice": 33.66,
                "averagePriceRaw": 0,
                "lastPrice": 33.66,
                "rateAsk": 36.53,
                "rateBid": 36.29
            },
            "commissionAndFees": {
                "commission": 2.99,
                "feeSec": 0,
                "feeTaf": 0,
                "feeBase": 2.99,
                "feeXtraShares": 0,
                "feeExchange": 0
            },
            "pnl": 0,
            "transactTime": "2023-05-18T13:30:02.153Z",
            "comment": "LQBK01FILLED1fill1",
            "eventID": "event_b2ed6e73-cb30-481c-9b9e-93b57f456344",
            "createdWhen": "2023-05-18T13:30:01.863Z"
        }
    ],
    "violationExempt": false,
    "preventQueuing": false,
    "extendedHours": false
}

{
  "id": "event_97d605cb-860a-4161-b208-11d2089b8dc6",
  "type": "orders.created",
  "timestamp": "2023-06-06T17:03:54.522332054Z",
  "payload": {
    "id": "KF.1aaeecf1-2ab5-4f4d-9103-51cb160bda52",
    "orderNo": "KFGJ000002",
    "type": "MARKET",
    "side": "BUY",
    "status": "NEW",
    "symbol": "AA",
    "averagePrice": 0,
    "averagePriceRaw": 0,
    "totalOrderAmount": 0,
    "cumulativeQuantity": 0,
    "openQuantity": 7,
    "availableForTradingQuantity": 7,
    "quantity": 1,
    "fees": 0,
    "orderExpires": "2023-06-06T20:00:00.000Z",
    "createdBy": "9a8cebff-6b1f-4f99-bb9c-f6843626a684",
    "userID": "9a8cebff-6b1f-4f99-bb9c-f6843626a684",
    "accountID": "9a8cebff-6b1f-4f99-bb9c-f6843626a684.1682435763668",
    "accountNo": "DWXN000105",
    "created": "2023-06-06T11:33:43.105Z"
  }
}

{
  "id": "event_53446c29-13f4-410b-898e-1a9066fa08e7",
  "type": "orders.completed",
  "timestamp": "2023-06-06T17:03:55.108307483Z",
  "payload": {
    "id": "KF.1aaeecf1-2ab5-4f4d-9103-51cb160bda52",
    "orderNo": "KFGJ000002",
    "type": "MARKET",
    "side": "BUY",
    "status": "REJECTED",
    "statusMessage": {
      "errorCode": "O099",
      "message": "Internal error."
    },
    "symbol": "AA",
    "averagePrice": 0,
    "averagePriceRaw": 0,
    "totalOrderAmount": 0,
    "cumulativeQuantity": 0,
    "openQuantity": 7,
    "availableForTradingQuantity": 7,
    "quantity": 1,
    "fees": 0,
    "orderExpires": "2023-06-06T20:00:00.000Z",
    "createdBy": "9a8cebff-6b1f-4f99-bb9c-f6843626a684",
    "userID": "9a8cebff-6b1f-4f99-bb9c-f6843626a684",
    "accountID": "9a8cebff-6b1f-4f99-bb9c-f6843626a684.1682435763668",
    "accountNo": "DWXN000105",
    "created": "2023-06-06T11:33:43.105Z"
  }
}

2.3 POST/PATCH changes to accommodate non-supported countries

Expected change - Today, the logic for POST/PATCH changes to accommodate non-supported countries is convoluted, this change will help clean up and make the logic more simple.

In either POST or PATCH on the user

📘
For country of residence (country field)

Check country's active flag.

If country is active > Request Allowed

If inactive > For POST - block user; for PATCH – allow request but set the account to FROZEN

For citizenship field

Always check country active flag first.

If country is active > let user through

If inactive > Check expat logic

Expat logic:

If expat allowed > Request allowed

If not allowed > For POST - block user; for PATCH – allow request but set account to FROZEN

2.4 Additional SQS queues for events

❗️
Limited Availability
Partners can now have events sent to multiple SQS queues. Please reach out to your relationship management team if this is something you are interested in.

2.5 Change in Cash Promotion Types

This is for partners who use our cash promotion endpoints

👍
API : {{bo-url}}/back-office/transactions/types

We are deprecating the type “PROMOTION” for cash promotions and are adding a new type called “CASH_PROMOTION”. Additionally, cash promotions will no longer show as cash journals in the transaction history. The Cash Promotion will show two transactions. One is a disbursement (CSD) from the Cash Promotion account. The second transaction is a receipt (CSR) of the cash promotion into the user's account.

Creating a Cash Promotion for a user account.

{
  "currency": "USD",
  "type": "CASH_PROMOTION"
  "accountNo": "DWBG000052",
  "amount": 250.25,
}

2.6 Ongoing Enhancement to PDT Calculations

We are making improvements to the timing and detection of PDTs to provide a better user experience. More improvements are to come in upcoming releases.

3.🔧Bug Fixes

3.1 Autopilot redemptions failing due to commission & fees not being deducted.

What is improving? - Autopilot will now include commissions, SEC, and TAF fees when calculating the liquidation amount for withdrawals. This will eliminate withdrawals failing for “Insufficient Funds” even though there is sufficient money in the user's account.

4. 🎁New API endpoints

None

⭐️ Coming Soon!

Due to compliance and regulatory requirements, we will be imposing minimum notional quantity limits on trades for certain instruments like BRK.A (Berkshire Hathaway).

More information and updates to follow in future communications.

In the meantime, please feel free to ask us any questions that you may have.