Creating a Trade

Creating a trade is what captures the subscription/investment made by an investor.

The Webhooks below can be utilized for verification of successful creation or deletion.


Creating a Trade API Method

createTrade

Deleting a Trade API Method

deleteTrade

WEBHOOKS

deleteTrade
createTrade


Trade Statuses

There are several trade statuses reflected in the trade process. Please see the definitions and graphic below which depicts the potential flow options for each trade from creation to completion.

Please note that trade statuses are different from payment processing statuses. Payment statuses can be found on the Payments Overview page.

The webhooks listed below can trigger a notification when statuses are updated. Definitions of each trade status are listed below.

Status Definitions

Created Funds are pending to be received in escrow

Funded Funds have been received in escrow

Canceled Funds were never received in escrow and the investor has canceled their intention to invest (this status is done through the deleteTrade method)

Unwind Pending Funds have been received in escrow and a return of funds back to the investor's bank account is pending

Unwind Settled Funds have been received in escrow and a return of funds back to the investor's bank account has processed

Settled Funds have been sent from escrow to the issuer/sponsor's bank account

Triggering a Settled Status

Once an investment has been completed and all funds have been sent to the issuer, you are able to update the trade to a SETTLED status by using the API method below.


API METHOD

updateTradeStatus

WEBHOOKS

updateTradeStatus
deleteTrade
createTrade


What’s Next