Buy/Sell Crypto

Overview

The general workflow for crypto trades will look like the following:

1. Pull the market price for the crypto your end user is looking to buy/sell from our API.
2. Give the end user the ability to confirm a trade after looking at the market price.
3. Call the Fortress API to initiate a trade
4. Monitor the webhooks sent for a change in the status of a trade.
5. Once completed, update your front end with the new balance for the end user.

❗️

Testnet Tokens

When testing trades in sandbox, please keep amounts low (greater than $15 but less than $30) as testnet tokens are in limited supply. Once finished testing, please "sell" the tokens so we can maintain a steady supply for all integrators in sandbox.

Lets review each step a bit more.

1. Pull the market price

GET /api/trust/v1/crypto-currency/crypto-currency-price/{network}/{currency}

//Sample Response

{ 
"price": {
  "buy": 21489.79,
  "sell": 21457.19
  }
}

_Note: The API can return zero values for buy or sell market prices. Zero dollar value trades ($0.00) will not be executed.

Note2: Currently it will be an API call to pull the market price at that time. Eventually we will implement a websocket that will stream prices to you.

2. Allow the end user to confirm that they want the trade after presenting them the market price.

3. Initiate a trade using the API

POST /api/trust/v1/trades

//Sample Request

{
     "accountId": "A3CA08AB-3058-4C3C-81E7-51DA24B171FF", 
     "type": "market", //only "market" is available at this time
     "from": {
          "asset": "usd",
          "amount": 100 
      },
     "to": {
          "asset": "eth",
          "network": "mainnet"
      },
     "comment": "Any Comment Here" 
}

OR

POST /api/trust/v1/trades

// Sample Request

{
     "accountId": "A3CA08AB-3058-4C3C-81E7-51DA24B171FF", 
     "type": "market", //only "market" is availbable at this time
     "from": {
          "asset": "eth",
          "network": "mainnet" 
          "amount": 100 
      },
     "to": {
          "asset": "usd" 
      },
     "comment": "Any Comment Here" 
}

👍

All in one

The trades endpoint facilitates both buys and sells by designating the from and to fields.

4. Monitor webhooks

An integrator will receive one webhook when the buy/sell crypto transaction is moved to the Processing status and another webhook when the settlement process is completed. Here are a list of the status's available for the trades endpoint:

• Pending (the buy/sell crypto request is created)

• Processing (the buy/sell crypto request is in progress, pending incoming crypto/fiat is displayed in an account
  balance)

• Completed (settlement process is completed)

• Aborted (processing of the buy/sell crypto request is failed)

5. Once a trade is completed, update your front end with the new balance

GET /custodial-accounts/{custodialAccountId}/balances

//Sample Response

{ 
"data": [ 
   {
   "assetType": "cryptoCurrency",
   "assetFiatType": "eth",
   "network": "mainnet",
   "disbursable": .001,
   "locked": 0,
   "pending": 0,
   "total": .001 
   } 
 ]
}

Trading Pending Balances

After an order is executed, but awaiting settlement, the custodial account's balance will update with a value update in the pendingFromTrade field (as well as the pending field). If the end user decides to, they can initiate a trade in the opposite direction, and receive the assets/fiat they requested without needing to wait for the settlement to happen. If the order in the opposite direction is a subset of the initial trade, then the asset/fiat being traded will settle, and the remaining assets/fiat from the initial transaction will lower in amount for what needs to be settled.

GET /custodial-accounts/balances

{
    "data": [
        {
            "assetType": "fiatCurrency",
            "assetFiatType": "usd",
            "disbursable": 525.000000000000000000,
            "locked": 0.000000000000000000,
            "pending": 0.000000000000000000,
            "total": 525.000000000000000000,
            "subBalances": {
                "pendingFromTrade": 0.000000000000000000,
                "lockedPendingFromTrade": 0.000000000000000000
            }
        },
        {
            "assetType": "cryptoCurrency",
            "assetFiatType": "btc",
            "network": "bitcoinTestnet",
            "disbursable": 0.000000000000000000,
            "locked": 0.000000000000000000,
            "pending": 0.001052660000000000,
            "total": 0.000000000000000000,
            "subBalances": {
                "pendingFromTrade": 0.001052660000000000,
                "lockedPendingFromTrade": 0.000000000000000000
            }
        }
    ]
}