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.batch— more than one value movement in one request. The root carries the order-level members, andtransferscarries one entry per movement.
POST /transfers
Request Body
| Field | Type | Required | Description |
|---|---|---|---|
from | CAIP-10 | Yes | Source account and chain (eip155:{chainId}:{address}). |
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 in the token's base units, as an integer string. |
deadline | string | No | Latest execution time (ISO 8601). Defaults to +1 hour. |
callData | string | No | Hex-encoded calldata forwarded to the recipient output. Max 10,240 bytes. |
options | object | No | Per-request options. See Options. |
Options
Every field is optional. Omit options to take the defaults.
| Option | Type | Description |
|---|---|---|
simulate | boolean | Check the transfer against the current chain state before answering. Defaults to false. See Simulation. |
slippageBps | integer | Exact-input slippage floor for a same-chain swap, in basis points. Defaults to 50. Ignored by transfers, bridges, and exact-output swaps. |
protocols.include | string[] | Narrow a swap or bridge to these served protocols. |
protocols.exclude | string[] | Remove these served protocols; applied after include. |
{
"from": "eip155:11155111:0x3165...",
"to": "eip155:11155111:0x8f66...",
"asset": "eip155:11155111:0xA0b8...",
"amount": "1000000"
}{
"from": "eip155:11155111:0x3165...",
"to": "eip155:11155111:0x8f66...",
"asset": {
"in": "eip155:11155111:0xA0b8...",
"out": "eip155:11155111:0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE"
},
"amount": "1000000",
"options": {
"slippageBps": 50,
"protocols": { "include": ["uniswap"] }
}
}{
"from": "eip155:1:0x3165...",
"to": "eip155:42161:0x8f66...",
"asset": {
"in": "eip155:1:0xA0b8...",
"out": "eip155:42161:0xFF97..."
},
"amount": "1000000"
}{
"deadline": "2026-06-05T13:00:00Z",
"transfers": [
{
"from": "eip155:11155111:0x3165...",
"to": "eip155:11155111:0x8f66...",
"asset": "eip155:11155111:0xA0b8...",
"amount": "1000000"
},
{
"from": "eip155:11155111:0x3165...",
"to": "eip155:42161:0x8f66...",
"asset": {
"in": "eip155:11155111:0xA0b8...",
"out": "eip155:42161:0xFF97..."
},
"amount": { "out": "1000000" }
}
]
}{
"id": "int_transfer_01HT...",
"type": "transfer",
"status": "draft",
"orderId": "0x0000000000000000000000000000000000000000000000000000000000000000",
"createdAt": "2026-06-05T12:00:00Z",
"updatedAt": "2026-06-05T12:00:00Z",
"metadata": {
"chainId": "eip155:11155111",
"gas": "21000"
},
"tx": {
"to": "0x...",
"data": "0x...",
"value": "0",
"chainId": 11155111
}
}{
"id": "int_transfer_01HT...",
"type": "swap",
"status": "draft",
"orderId": "0x0000000000000000000000000000000000000000000000000000000000000000",
"createdAt": "2026-06-05T12:00:00Z",
"updatedAt": "2026-06-05T12:00:00Z",
"metadata": {
"chainId": "eip155:1",
"slippageBps": 50,
"provider": "uniswap",
"route": [
{ "chainId": "eip155:1", "tokenIn": "0xA0b8...", "tokenOut": "0xC02a...", "venue": "v2" }
],
"costs": {
"total": "22906",
"sources": [{ "source": "protocol", "includedInRanking": true, "amountUsd": "0.022906" }],
"outputUsd": "99.975842"
},
"in": { "chainId": "eip155:1", "amount": "100000000" },
"out": { "chainId": "eip155:1", "expectedAmount": "99985841", "minAmount": "99485912" }
},
"tx": { "to": "0x...", "data": "0x...", "value": "0", "chainId": 1 }
}Quote metadata
A request that routes to the quote service carries the quote projection flat on
metadata. A plain same-chain transfer, and any request served by the legacy
path, carries none of these fields.
| Field | Type | Description |
|---|---|---|
provider | string | The protocol that produced the winning quote: across, cow, mayan, relay, sushiswap, or uniswap. |
route | array | The described path, in order. Each hop is { chainId, tokenIn, tokenOut, venue? }; a multi-hop swap is more entries. |
costs | object | The normalized quote costs: total in micro-USD, a non-empty sources list, and outputUsd. |
in | object | The input side: { chainId, amount?, expectedAmount?, minAmount? }. |
out | object | The output side, the same shape. |
slippageBps | integer | The settlement band the composer committed, in bps. minAmount derives from it. |
For an exact-input request, in.amount is the amount you sent, and out
carries expectedAmount and minAmount. For an exact-output request the sides
swap: out.amount is the amount you pinned, and in carries expectedAmount
and minAmount. minAmount is expectedAmount minus the committed band
(slippageBps), so it is the floor the order can settle at.
Amounts are base-unit integer strings, like amount; costs.total is in
micro-USD (1 unit = 1e-6 USD).
Batch requests
A batch request moves value to more than one place in one order. Put the
order-level members at the root and the movements in transfers:
| Field | Type | Required | Description |
|---|---|---|---|
deadline | string | No | Latest execution time for the whole order (ISO 8601). Defaults to +1 hour. |
options.simulate | boolean | No | Check the whole order against current chain state before answering. |
transfers | array | Yes | 1 to 25 movements. Each entry takes from, to, asset, amount, callData, and the two per-transfer options. |
Each entry spends from the same account on the same source chain; a request
that names two payers, or a from that disagrees with its input asset's chain,
answers a 422 that names the entry.
Response Fields
| Field | Type | Description |
|---|---|---|
id | string | Unique intent ID (int_transfer_{ulid}). |
type | string | Inferred operation type: transfer, swap, bridge, or batch. A request with more than one transfer answers batch. |
status | string | Lifecycle status. See Intent Lifecycle. |
orderId | string | Deterministic on-chain order identifier (bytes32 hex). |
createdAt | string | ISO 8601 creation timestamp. |
updatedAt | string | ISO 8601 last update timestamp. |
metadata | object | Chain ID, gas estimate, optional transaction details, and — when the request routed to the quote service — the quote projection. See Quote metadata. Always carries metadata.transfers. |
metadata.transfers | array | One record per transfer, in request order. Each record carries that transfer's own type (transfer, swap, or bridge), its recipient and token (CAIP-10), its delivered amount, and its settled outputHash. A record carries no index: array order is the position. A one-transfer response also carries the quote members flat on metadata; a multi-transfer response does not. |
tx | object | Transaction payload ready for on-chain submission. |
Errors
| HTTP | Type | When |
|---|---|---|
| 400 | bad-request | Malformed JSON or a payload that fails schema validation. |
| 400 | empty-protocol-set | The protocol filter removed every protocol the request could use. |
| 400 | simulation-failed | options.simulate was set and the transfer reverted against the current chain state. |
| 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. |
| 422 | exact-output-requires-quote | An exact-output swap was requested while the swap quote service is unavailable. |
| 422 | exact-output-unsupported | An exact-output swap targets a chain whose route settles through the DeFi adapter lane. |
| 429 | rate-limited | Rate limit exceeded. |
| 500 | transfer-service-failure | Unexpected transfer service error. |