Integrator Markups & Fees

Fortress enables integrators to apply markups and pass-through gas fees when creating transfers using the v2 Transfers API.

This endpoint supports the following optional fields to control fee behavior:

Field	Type	Required	Description
`spreadBasisPoints`	integer	No	Optional markup fee in basis points (1–10000). Adds a percentage fee to the transfer.
`applyGasFee`	boolean	No	If `true` Fortress will apply blockchain gas fees to the custodial account. Default is`false`.

POST /api/trust/v2/transfers

{
  "type": "withdrawal",
  "assetType": "crypto",
  "asset": "usdc",
  "network": "mainnet",
  "amount": 100,
  "from": {
    "type": "account",
    "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
  },
  "to": {
    "type": "address",
    "id": "string",
  },
  "comment": "string",
  "spreadBasisPoints": 0,
  "applyGasFee": false
}

Behavior Notes

If applyGasFee is true, the transfer will include estimated gas costs, which will be applied to the originating custodial account.
The spreadBasisPoints fee is added on top of the transfer amount and reflected in internal ledgering for tracking markup revenue.

Version Support

This feature is supported in v2 Transfers API only. It is not available in v1.