Input schema (JSON)
{
"type": "object",
"required": [
"sourceAsset",
"destinationAsset",
"destinationAddress",
"refundAddress",
"numberOfChunks"
],
"properties": {
"apiKey": {
"type": [
"string",
"null"
],
"default": null,
"description": "Optional partner API key."
},
"sourceAsset": {
"type": "string",
"description": "Source asset identifier (e.g., 'btc.btc', 'eth.eth', 'usdc.eth')"
},
"minimumPrice": {
"type": [
"number",
"null"
],
"default": null,
"description": "Optional minimum accepted price as a destination-per-source ratio (e.g., for a btc.btc to eth.eth swap, 28.5 means 1 BTC gets at least 28.5 ETH). When omitted, automatically calculated from current pool prices with 2% slippage tolerance. Set to 0 to accept any price."
},
"refundAddress": {
"type": "string",
"description": "Refund address on the source chain, used if minimum price cannot be met"
},
"numberOfChunks": {
"type": "integer",
"description": "Number of sub-swaps for DCA (Dollar Cost Averaging). Must be >= 1."
},
"destinationAsset": {
"type": "string",
"description": "Destination asset identifier (e.g., 'eth.eth', 'btc.btc', 'sol.sol')"
},
"destinationAddress": {
"type": "string",
"description": "Destination address on the target chain"
},
"chunkIntervalBlocks": {
"type": [
"integer",
"null"
],
"default": null,
"description": "Optional delay between DCA sub-swaps in state-chain blocks (1 block = 6 seconds). Defaults to 2 blocks (12 seconds)."
},
"livePriceSlippageTolerancePercent": {
"type": [
"number",
"null"
],
"default": null,
"description": "Optional live price protection: how far, in percent (0 to 100, at most 2 decimals, e.g. 0.5), the execution price may fall below Chainflip's oracle price before a sub-swap is retried and the rest refunded. Use a quote's recommendedLivePriceSlippageTolerancePercent. Rejected when either asset has no oracle price on Chainflip. When omitted, Chainflip's default protection for the pair applies."
}
}
}