Simulate

POST

/api/v1/transformer/transaction/simulate

This endpoint simulates a transaction between two entities. It validates the entities, accounts, and jurisdictions, finds eligible infrastructure providers, and creates an execution record.

Important Note for Off-Ramp Transactions: Each off-ramp transaction receives a unique, disposable deposit wallet address. Always verify the deposit wallet address returned in the response before sending any stablecoins or crypto assets. Do not reuse wallet addresses from previous transactions.

Request

Authorization

API Key

Add parameter in header

x-api-token

Example:

x-api-token: ********************

Body Params application/json

Examples

Responses

🟢200OK

application/json

Transaction simulation successful

Body

🟠400Bad Request

🟠401Unauthorized

🟠404Record Not Found

🔴500Server Error

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST '/api/v1/transformer/transaction/simulate' \
--header 'x-api-token: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "transactionId": "txn_12345abcde",
    "fromEntityId": "entity_sender123",
    "fromAccountId": "account_sender123",
    "toEntityId": "entity_recipient456",
    "toAccountId": "account_recipient456",
    "exactAmountIn": 100.5,
    "exactAmountOut": 95.25,
    "depositMemo": "string",
    "counterPartyRiskAcknowledged": "string"
}'

Response Example

200 - Example 1

{
    "success": true,
    "data": {
        "executionId": "exec_67d58fee2a31c2e919701a10",
        "quote": {
            "inAmount": {
                "amount": 275,
                "currency": "AED"
            },
            "outAmount": {
                "amount": 70.40528,
                "currency": "USDT"
            },
            "exchangeRate": {
                "rate": 0.2725,
                "conversion": "1 AED = 0.2725 USDT"
            },
            "fees": {
                "partnerFees": {
                    "amount": 0,
                    "currency": "AED"
                },
                "zynkGasFees": {
                    "amount": 0,
                    "currency": "AED"
                },
                "zynkNetworkFees": {
                    "amount": 0.004,
                    "currency": "AED"
                },
                "infraProviderFees": {
                    "amount": 0.006,
                    "currency": "AED"
                },
                "bankingFees": {
                    "amount": 7,
                    "currency": "AED"
                },
                "txFees": {
                    "amount": 0,
                    "currency": "AED"
                },
                "totalFees": {
                    "amount": 7.01,
                    "currency": "AED"
                }
            },
            "feeBase": "AED"
        },
        "depositAccount": {
            "account_holder_name": "Varni Labs FZE Client Money Account",
            "currency_code": "AED",
            "account_number": "TEST_AED_ACCOUNT_NO",
            "bank_display_name": "Zand Bank",
            "routing_code_type_1": "SWIFT",
            "routing_code_value_1": "TESTXXXX",
            "routing_code_type_2": "",
            "routing_code_value_2": "",
            "bank_address": "HD-189 SRT, FLOOR 23, SHEIKH RASHID TOWER, DUBAI",
            "bank_account_type": "LOCAL",
            "networkName": "Solana Devnet",
            "chainId": "103",
            "currency": "USDC",
            "tokenAddress": "Kk4sTVi1FMABcKLGjvhXUmXhzoCk8M5xP9LSrwJi8P6",
            "depositWalletAddress": "H6TeWMSXUSvh1pVmY5fSk2htWoeP35X52Lqb16E2aomT",
            "amount": 10
        },
        "message": "Transaction simulation successful"
    },
    "validUntil": "2019-08-24T14:15:22Z",
    "payloadToSign": "string"
}

Modified at 2025-11-11 17:07:58

Get Entity Accounts

Transfer