curl --request POST \
--url https://api.breet.io/v1/trades/sell/mock-trade \
--header 'Content-Type: application/json' \
--header 'X-Breet-Env: <api-key>' \
--header 'x-app-id: <api-key>' \
--header 'x-app-secret: <api-key>' \
--data '
{
"walletAddress": "TV8dNYYBgL3xLbQcJLMBNavY4gYNqPF8Jv",
"asset": "TRX_TEST",
"amountInUSD": 50,
"cryptoReceived": 500,
"reference": "mock-ref-550e8400-e29b-41d4-a716-446655440000",
"txHash": "0xmock550e8400e29b41d4a716446655440000"
}
'{
"message": "mock trade initiated",
"success": true,
"data": {},
"meta": {},
"summary": {},
"stats": {}
}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 sandbox. 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.
curl --request POST \
--url https://api.breet.io/v1/trades/sell/mock-trade \
--header 'Content-Type: application/json' \
--header 'X-Breet-Env: <api-key>' \
--header 'x-app-id: <api-key>' \
--header 'x-app-secret: <api-key>' \
--data '
{
"walletAddress": "TV8dNYYBgL3xLbQcJLMBNavY4gYNqPF8Jv",
"asset": "TRX_TEST",
"amountInUSD": 50,
"cryptoReceived": 500,
"reference": "mock-ref-550e8400-e29b-41d4-a716-446655440000",
"txHash": "0xmock550e8400e29b41d4a716446655440000"
}
'{
"message": "mock trade initiated",
"success": true,
"data": {},
"meta": {},
"summary": {},
"stats": {}
}Authorizations
Your application ID from the Breet dashboard
Your application secret from the Breet dashboard
Environment selector: sandbox or production
Body
The deposit wallet address (from Generate Wallet Address or Fetch Wallet Addresses). Must belong to your integration and match the asset.
Asset identifier (e.g. TRX_TEST, USDC_TEST3). Must match the wallet's asset. Use GET /trades/assets for the list.
Amount in USD (must be greater than zero).
x > 0Crypto amount received (must be greater than zero).
x > 0Unique reference for this mock transaction (e.g. UUID or test ref).
Mock transaction hash for the deposit.
Optional sender/source address for the mock deposit.
Optional number of confirmations to simulate (positive integer).
x >= 1Response
Mock trade initiated successfully; the trade will be processed asynchronously.
Was this page helpful?