Skip to content
Logo

Create Transfer

Submit a value-movement intent. The same endpoint handles same-chain transfers, same-chain swaps, and cross-chain bridges. Mure infers the operation type from the request:

  • transfer — same chain, same asset.
  • swap — same chain, different input and output assets.
  • bridge — different source and destination chains.
POST /transfers

Request Body

FieldTypeRequiredDescription
fromCAIP-10YesSource account and chain (eip155:{chainId}:{address}).
toCAIP-10YesDestination account and chain.
assetCAIP-10 | { in: CAIP-10, out: CAIP-10 }YesToken to move. Use { in, out } for swaps.
amountstringYesAmount as a decimal string.
deadlinestringNoLatest execution time (ISO 8601). Defaults to +1 hour.
callDatastringNoHex-encoded calldata forwarded to the recipient output. Max 10,240 bytes.
{
  "from": "eip155:11155111:0x3165...",
  "to": "eip155:11155111:0x8f66...",
  "asset": "eip155:11155111:0xA0b8...",
  "amount": "1000.50"
}

Response Fields

FieldTypeDescription
idstringUnique intent ID (int_transfer_{ulid}).
typestringInferred operation type: transfer, swap, or bridge.
statusstringLifecycle status. See Intent Lifecycle.
orderIdstringDeterministic on-chain order identifier (bytes32 hex).
createdAtstringISO 8601 creation timestamp.
updatedAtstringISO 8601 last update timestamp.
metadataobjectChain ID, gas estimate, and optional transaction details.
txobjectTransaction payload ready for on-chain submission.

Errors

HTTPTypeWhen
422ValidationErrorInvalid request body or field validation failure.
422BlockchainErrorOn-chain simulation or validation failure.
422ChainNotConfiguredErrorThe specified chain is not supported.
422CAIPErrorInvalid CAIP-2 chain identifier.
422IntentIdErrorIntent ID generation failure.
422CurrencyErrorBridge provider quote failure for cross-chain requests.
500TransferServiceErrorUnexpected transfer service error.