Simulate Transfer

Dry-run a value-movement intent to preview fees, routing, and transaction data without executing on-chain. The request body is identical to Create Transfer.

POST /transfers/simulate

Request Body

Identical to Create Transfer.

Field	Type	Required	Description
`from`	CAIP-10	Yes	Source account and chain.
`to`	CAIP-10	Yes	Destination account and chain.
`asset`	CAIP-10 \| `{ in: CAIP-10, out: CAIP-10 }`	Yes	Token to move. Use `{ in, out }` for swaps.
`amount`	string	Yes	Amount as a decimal string.
`deadline`	string	No	Latest execution time (ISO 8601).
`callData`	string	No	Hex-encoded calldata.

{
  "from": "eip155:11155111:0x3165...",
  "to": "eip155:11155111:0x8f66...",
  "asset": "eip155:11155111:0xA0b8...",
  "amount": "1000.50"
}

Response

{
  "simulationId": "sim_01HT...",
  "valid": true,
  "resolvedPath": ["transfer"],
  "estimatedFees": {
    "gasUsd": "0.12",
    "protocolFeeBps": 30,
    "solverFeeBps": 10,
    "totalUsd": "0.15"
  },
  "estimatedTimeS": 12,
  "warnings": [],
  "errors": [],
  "expiresAt": "2026-06-05T12:00:30Z",
  "tx": {
    "to": "0x...",
    "data": "0x...",
    "value": "0",
    "chainId": 11155111
  }
}

Response Fields

Field	Type	Description
`simulationId`	string	Unique identifier for this simulation result.
`valid`	boolean	Whether the intent would succeed as submitted.
`resolvedPath`	string[]	Ordered list of primitive operations (e.g. `["transfer"]`, `["swap"]`, or `["bridge"]`).
`estimatedFees`	object	Breakdown of gas, protocol, and solver fees.
`estimatedTimeS`	number	Expected settlement time in seconds.
`warnings`	string[]	Non-fatal issues.
`errors`	string[]	Fatal validation errors if `valid` is `false`.
`expiresAt`	string	ISO 8601 timestamp after which quoted fees may no longer be accurate.
`tx`	object	Optional transaction payload ready for submission.

Errors

HTTP	Type	When
400	bad-request	Malformed JSON or a payload that fails schema validation.
401	missing-api-key	No `api-key` header.
403	invalid-api-key	Invalid API key.
403	chain-not-allowed-for-key-environment	The key's environment cannot act on the requested chain.
422	validation-failed	Domain validation failure such as an unknown asset symbol or insufficient funds.
429	rate-limited	Rate limit exceeded.
500	transfer-service-failure	Unexpected transfer service error.
422	CurrencyError	Bridge provider quote failure for cross-chain requests.