Skip to content
LogoLogo

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
400bad-requestMalformed JSON or a payload that fails schema validation.
401missing-api-keyNo api-key header.
403invalid-api-keyInvalid API key.
403chain-not-allowed-for-key-environmentThe key's environment cannot act on the requested chain.
422validation-failedDomain validation failure such as an unknown asset symbol.
429rate-limitedRate limit exceeded.
500transfer-service-failureUnexpected transfer service error.