Execute a trade quote

POST 
/v1/trades/quotes/:id/execute

Executes a previously generated trade quote. The quote must not be expired and the user must have sufficient balance in the specified wallet.

Request

Path Parameters

id stringrequired

application/json

Body

required

Trade quote execution request

walletId stringrequired

ID of the wallet to use for the trade execution

Responses

201

Trade executed successfully

application/json

Schema

Schema

traceId string
message string

data

object

parentTransactionId stringrequired

Parent transaction ID for the trade order

sourceAssetTransferId stringrequired

Source asset transfer transaction ID

targetAssetTransferId stringrequired

Target asset transfer transaction ID

feeTransferId stringnullablerequired

Fee transfer transaction ID (null if no fee)

spreadTransferId stringnullablerequired

Spread transfer transaction ID (null if no spread revenue)

success booleanrequired

Whether the trade was executed successfully

filledPrice stringrequired

Filled price from the exchange

totalSourceAmount stringrequired

Total source amount used in the trade

totalTargetAmount stringrequired

Total target amount received from the trade

totalFeeAmount stringrequired

Total fee amount charged

message string

Success or error message

error object

Error details if trade failed

txType stringrequired

Transaction type (buy or sell)

date stringrequired

Trade execution timestamp

reference stringrequired

External reference or vendor transaction ID

relatedTransactions string[]required

Related transaction IDs

network stringrequired

Blockchain network for the asset

transaction stringrequired

Transaction hash or ID

sourceAssetAcronym stringrequired

Source asset acronym

targetAssetAcronym stringrequired

Target asset acronym

from stringrequired

Source wallet name

to stringrequired

Destination wallet name

feeDeductedFrom stringrequired

Asset from which fees were deducted

Example (from schema)

{
  "traceId": "string",
  "message": "string",
  "data": {
    "parentTransactionId": "123e4567-e89b-12d3-a456-426614174000",
    "sourceAssetTransferId": "123e4567-e89b-12d3-a456-426614174001",
    "targetAssetTransferId": "123e4567-e89b-12d3-a456-426614174002",
    "feeTransferId": "123e4567-e89b-12d3-a456-426614174003",
    "spreadTransferId": "123e4567-e89b-12d3-a456-426614174004",
    "success": true,
    "filledPrice": "50000.00",
    "totalSourceAmount": "1000.00",
    "totalTargetAmount": "0.02",
    "totalFeeAmount": "10.00",
    "message": "Trade executed successfully",
    "error": {
      "code": "INSUFFICIENT_BALANCE",
      "message": "Not enough funds"
    },
    "txType": "buy",
    "date": "2025-10-24T10:30:00.000Z",
    "reference": "fx_quote_abc123",
    "relatedTransactions": [
      "123e4567-e89b-12d3-a456-426614174000"
    ],
    "network": "ETH",
    "transaction": "123e4567-e89b-12d3-a456-426614174002",
    "sourceAssetAcronym": "USD",
    "targetAssetAcronym": "BTC",
    "from": "User Wallet",
    "to": "User Wallet",
    "feeDeductedFrom": "USD"
  }
}

400

Invalid request payload. This can happen if required fields are missing or have invalid formats.

application/json

Schema

Schema

traceId string
message string

Example (from schema)

{
  "traceId": "string",
  "message": "string"
}

403

The API key is invalid or the client does not have sufficient permissions.

application/json

Schema

Schema

traceId string
message string

Example (from schema)

{
  "traceId": "string",
  "message": "string"
}

404

One of the specified resources was not found. Does not apply for empty result set.

application/json

Schema

Schema

traceId string
message string

Example (from schema)

{
  "traceId": "string",
  "message": "string"
}

Loading...