v1

latestOpenAPI 3.0.0Proprietary2026-07-2233792.6 KB

Testing

Mock a trade (non-production only)

Simulates an incoming deposit so you can test your integration without sending real crypto. Only available when X-Breet-Env is development. The wallet is identified by walletAddress; it must match the given asset. The trade is processed as if it came from the blockchain and will trigger the same webhooks and flows as a real deposit.

post/trades/sell/mock-trade

Request body

walletAddressstring required

The deposit wallet address (from Generate Wallet Address or Fetch Wallet Addresses). Must belong to your integration and match the asset.

assetstring required

Asset identifier (e.g. TRX_TEST, USDC_TEST3). Must match the wallet's asset. Use GET /trades/assets for the list.

amountInUSDnumber required

Amount in USD (must be greater than zero).

cryptoReceivednumber required

Crypto amount received (must be greater than zero).

referencestring required

Unique reference for this mock transaction (e.g. UUID or test ref).

txHashstring required

Mock transaction hash for the deposit.

sourceAddressstring

Optional sender/source address for the mock deposit.

confirmationsinteger

Optional number of confirmations to simulate (positive integer).

Response

Mock trade initiated successfully; the trade will be processed asynchronously.