curl --request POST \
--url https://api.blockradar.co/v1/wallets/{walletId}/addresses/{addressId}/swaps/execute \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"amount": "1000",
"amountSide": "source",
"fromAssetId": "d2176d80-010e-47fa-aa78-d04d4386c86b",
"toAssetId": "dd46b7c5-3f6a-4fec-b85b-4d6e25708561",
"recipientAddress": "0x2455eC6700092991Ce0782365A89d5Cd89c8Fa22",
"reference": "swap-01",
"metadata": {
"id": 1
},
"order": "RECOMMENDED"
}
'{
"data": {
"addressId": null,
"amlScreening": null,
"amount": "0.5",
"amountPaid": null,
"asset": {
"address": "0x8AC76a51cc950d9822D68b83fE1Ad97B32Cd580d",
"blockchain": {
"createdAt": "2024-05-14T17:53:33.106Z",
"derivationPath": "m/44'/60'/0'/0",
"id": "b80d3d5e-16f1-4d99-be5e-6dfcd27f89aa",
"isActive": true,
"isEvmCompatible": true,
"isL2": false,
"logoUrl": "https://res.cloudinary.com/blockradar/image/upload/v1716800080/crypto-assets/bnb-bnb-logo_e4qdyk.png",
"name": "BNB smart chain",
"slug": "bnb-smart-chain",
"symbol": "bnb",
"tokenStandard": "BEP20",
"updatedAt": "2024-11-26T19:04:13.941Z"
},
"createdAt": "2024-05-14T17:53:33.672Z",
"decimals": 18,
"id": "f31328ee-2db9-43ab-81ea-9a91db72957a",
"isActive": true,
"logoUrl": "https://res.cloudinary.com/blockradar/image/upload/v1716800083/crypto-assets/usd-coin-usdc-logo_fs9mhv.png",
"name": "USD Coin",
"network": "mainnet",
"standard": "BEP20",
"symbol": "USDC",
"updatedAt": "2024-06-15T04:36:43.855Z"
},
"assetSwept": null,
"assetSweptAmount": null,
"assetSweptAt": null,
"assetSweptGasFee": null,
"assetSweptHash": null,
"assetSweptRecipientAddress": null,
"assetSweptResponse": null,
"assetSweptSenderAddress": null,
"blockHash": null,
"blockNumber": null,
"blockchain": {
"createdAt": "2024-05-14T17:53:33.106Z",
"derivationPath": "m/44'/60'/0'/0",
"id": "b80d3d5e-16f1-4d99-be5e-6dfcd27f89aa",
"isActive": true,
"isEvmCompatible": true,
"isL2": false,
"logoUrl": "https://res.cloudinary.com/blockradar/image/upload/v1716800080/crypto-assets/bnb-bnb-logo_e4qdyk.png",
"name": "BNB smart chain",
"slug": "bnb-smart-chain",
"symbol": "bnb",
"tokenStandard": "BEP20",
"updatedAt": "2024-11-26T19:04:13.941Z"
},
"chainId": null,
"confirmations": null,
"confirmed": false,
"createdAt": "2025-04-01T15:00:28.604Z",
"currency": null,
"fee": null,
"feeMetadata": null,
"gasFee": null,
"gasPrice": null,
"gasUsed": null,
"hash": null,
"id": "59b8f26e-0a5d-4679-8686-f5032e4344d2",
"metadata": null,
"network": "mainnet",
"note": null,
"rate": "0.848566",
"reason": null,
"recipientAddress": "0xD2b6be31932E0294F2ebD14a008C3f1E05B47BC4",
"senderAddress": "0xD2b6be31932E0294F2ebD14a008C3f1E05B47BC4",
"status": "PENDING",
"toAmount": "0.424283",
"toAsset": {
"address": "0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85",
"blockchain": {
"createdAt": "2024-10-07T22:09:49.784Z",
"derivationPath": "m/44'/60'/0'/0",
"id": "1c9ca9df-325f-4b60-a7ec-b28d2235e0b7",
"isActive": true,
"isEvmCompatible": true,
"isL2": true,
"logoUrl": "https://res.cloudinary.com/blockradar/image/upload/v1728312943/crypto-assets/optimism-ethereum-op-logo_h62d1i.png",
"name": "optimism",
"slug": "optimism",
"symbol": "eth",
"tokenStandard": null,
"updatedAt": "2024-11-26T19:04:13.947Z"
},
"createdAt": "2024-10-08T19:12:41.930Z",
"decimals": 6,
"id": "ee7318c8-3a61-4437-88a0-de56b97f2a89",
"isActive": true,
"logoUrl": "https://res.cloudinary.com/blockradar/image/upload/v1716800083/crypto-assets/usd-coin-usdc-logo_fs9mhv.png",
"name": "USD Coin",
"network": "mainnet",
"standard": null,
"symbol": "USDC",
"updatedAt": "2024-10-08T19:12:41.930Z"
},
"toBlockchain": {
"createdAt": "2024-10-07T22:09:49.784Z",
"derivationPath": "m/44'/60'/0'/0",
"id": "1c9ca9df-325f-4b60-a7ec-b28d2235e0b7",
"isActive": true,
"isEvmCompatible": true,
"isL2": true,
"logoUrl": "https://res.cloudinary.com/blockradar/image/upload/v1728312943/crypto-assets/optimism-ethereum-op-logo_h62d1i.png",
"name": "optimism",
"slug": "optimism",
"symbol": "eth",
"tokenStandard": null,
"updatedAt": "2024-11-26T19:04:13.947Z"
},
"toWallet": {
"address": "0xD2b6be31932E0294F2ebD14a008C3f1E05B47BC4",
"configurations": null,
"createdAt": "2024-10-08T19:15:28.390Z",
"derivationPath": "m/44'/60'/0'/0/0",
"description": "This is Optimism Wallet",
"id": "f25dfef5-253a-4cb8-ab00-80f2e799f780",
"isActive": true,
"name": "Optimism Wallet",
"network": "mainnet",
"status": "ACTIVE",
"updatedAt": "2024-10-08T19:15:28.390Z"
},
"tokenAddress": null,
"type": "SWAP",
"updatedAt": "2025-04-01T15:00:28.604Z",
"wallet": {
"address": "0xD2b6be31932E0294F2ebD14a008C3f1E05B47BC4",
"apiCredential": {
"createdAt": "2024-08-24T19:49:15.617Z",
"id": "4ecea2c9-2ab7-4e9b-a436-16531233859f",
"isActive": true,
"key": "3OHh9gyDLb7h5ZPml638rXbeHShHb0OYMC34ehZRF6M4yepOR4wUOvrxHEh6lMCj",
"revokedAt": null,
"status": "active",
"type": "api_key",
"updatedAt": "2025-04-01T14:59:22.501Z",
"webhookUrl": "https://webhook.site/dbfbd5fa-d55f-4a31-a1d2-509cc60fa91d"
},
"blockchain": {
"createdAt": "2024-05-14T17:53:33.106Z",
"derivationPath": "m/44'/60'/0'/0",
"id": "b80d3d5e-16f1-4d99-be5e-6dfcd27f89aa",
"isActive": true,
"isEvmCompatible": true,
"isL2": false,
"logoUrl": "https://res.cloudinary.com/blockradar/image/upload/v1716800080/crypto-assets/bnb-bnb-logo_e4qdyk.png",
"name": "BNB smart chain",
"slug": "bnb-smart-chain",
"symbol": "bnb",
"tokenStandard": "BEP20",
"updatedAt": "2024-11-26T19:04:13.941Z"
},
"business": {
"configurations": {
"billing": {
"ccEmails": [
"[email protected]"
],
"toEmails": [
"[email protected]"
]
},
"contact": {
"email": "[email protected]"
},
"details": {
"description": "description",
"website": "https://www.blockradar.co"
},
"hideLogoUrlInResponse": false,
"useCustomWebhookSignatureHeader": true
},
"createdAt": "2024-08-22T15:28:37.522Z",
"id": "4b96c271-35eb-45e8-b558-6a53f95df601",
"name": "Blockradar",
"sector": "infrastructure",
"seedPhrase": "key day angry renew wife suit valve defy dose suspect night mandate friend resist regular entire industry sting trouble pyramid rail bright debate direct",
"status": "ACTIVE",
"testnetSeedPhrase": "around goddess ugly elephant network traffic horror climb dry rally flee city student jeans release fat correct trade miracle demand envelope bamboo orphan volume",
"updatedAt": "2025-03-27T16:28:26.587Z",
"user": {
"configurations": {
"setNewPasswordRequired": false
},
"createdAt": "2024-08-22T15:28:37.522Z",
"email": "[email protected]",
"emailVerified": true,
"firstname": "Test",
"id": "ad0ad16d-dc56-48e9-85da-a86adabff48e",
"lastname": "One",
"twoFactorAuthEnabled": true,
"updatedAt": "2025-03-27T16:28:26.592Z"
}
},
"configurations": null,
"createdAt": "2024-08-24T19:49:15.617Z",
"derivationPath": "m/44'/60'/0'/0/0",
"description": "This is BNB Smart Chain Mainnet Wallet",
"id": "23628012-2b69-4ed7-9627-63fb3f547381",
"isActive": true,
"name": "BNB Smart Chain Mainnet Wallet",
"network": "mainnet",
"status": "ACTIVE",
"updatedAt": "2024-08-24T19:49:15.617Z"
}
},
"message": "Swap transaction created successfully",
"statusCode": 200
}Swap
Child Address Execute
This endpoint allows the execution of a swap.
Body Parameters
| Key | Required | Type | Description |
|---|---|---|---|
| fromAssetId | true | string | The master wallet asset id to swap from. |
| toAssetId | true | string | The master wallet asset id to swap to. |
| amount | true | string | The source amount when amountSide is source, or the target amount when amountSide is target. |
| amountSide | false | string | source or target. Defaults to source. Use target to request an exact destination amount. |
| recipientAddress | false | string | The external address you want to swap to. For Stellar destinations, use a G… base account or M… muxed account. |
| recipientRouting | false | object | Supported only when the destination chain is Stellar. G… recipients must use none or memo_id; M… recipients must omit this field. Non-Stellar requests that include this field are rejected. |
| reference | false | string | This would be the transaction reference |
| metadata | false | object | This would be atteched to the transaction payload |
| order | false | string | eg, FASTEST, CHEAPEST, RECOMMENDED, NO_SLIPPAGE |
POST
/
v1
/
wallets
/
{walletId}
/
addresses
/
{addressId}
/
swaps
/
execute
curl --request POST \
--url https://api.blockradar.co/v1/wallets/{walletId}/addresses/{addressId}/swaps/execute \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"amount": "1000",
"amountSide": "source",
"fromAssetId": "d2176d80-010e-47fa-aa78-d04d4386c86b",
"toAssetId": "dd46b7c5-3f6a-4fec-b85b-4d6e25708561",
"recipientAddress": "0x2455eC6700092991Ce0782365A89d5Cd89c8Fa22",
"reference": "swap-01",
"metadata": {
"id": 1
},
"order": "RECOMMENDED"
}
'{
"data": {
"addressId": null,
"amlScreening": null,
"amount": "0.5",
"amountPaid": null,
"asset": {
"address": "0x8AC76a51cc950d9822D68b83fE1Ad97B32Cd580d",
"blockchain": {
"createdAt": "2024-05-14T17:53:33.106Z",
"derivationPath": "m/44'/60'/0'/0",
"id": "b80d3d5e-16f1-4d99-be5e-6dfcd27f89aa",
"isActive": true,
"isEvmCompatible": true,
"isL2": false,
"logoUrl": "https://res.cloudinary.com/blockradar/image/upload/v1716800080/crypto-assets/bnb-bnb-logo_e4qdyk.png",
"name": "BNB smart chain",
"slug": "bnb-smart-chain",
"symbol": "bnb",
"tokenStandard": "BEP20",
"updatedAt": "2024-11-26T19:04:13.941Z"
},
"createdAt": "2024-05-14T17:53:33.672Z",
"decimals": 18,
"id": "f31328ee-2db9-43ab-81ea-9a91db72957a",
"isActive": true,
"logoUrl": "https://res.cloudinary.com/blockradar/image/upload/v1716800083/crypto-assets/usd-coin-usdc-logo_fs9mhv.png",
"name": "USD Coin",
"network": "mainnet",
"standard": "BEP20",
"symbol": "USDC",
"updatedAt": "2024-06-15T04:36:43.855Z"
},
"assetSwept": null,
"assetSweptAmount": null,
"assetSweptAt": null,
"assetSweptGasFee": null,
"assetSweptHash": null,
"assetSweptRecipientAddress": null,
"assetSweptResponse": null,
"assetSweptSenderAddress": null,
"blockHash": null,
"blockNumber": null,
"blockchain": {
"createdAt": "2024-05-14T17:53:33.106Z",
"derivationPath": "m/44'/60'/0'/0",
"id": "b80d3d5e-16f1-4d99-be5e-6dfcd27f89aa",
"isActive": true,
"isEvmCompatible": true,
"isL2": false,
"logoUrl": "https://res.cloudinary.com/blockradar/image/upload/v1716800080/crypto-assets/bnb-bnb-logo_e4qdyk.png",
"name": "BNB smart chain",
"slug": "bnb-smart-chain",
"symbol": "bnb",
"tokenStandard": "BEP20",
"updatedAt": "2024-11-26T19:04:13.941Z"
},
"chainId": null,
"confirmations": null,
"confirmed": false,
"createdAt": "2025-04-01T15:00:28.604Z",
"currency": null,
"fee": null,
"feeMetadata": null,
"gasFee": null,
"gasPrice": null,
"gasUsed": null,
"hash": null,
"id": "59b8f26e-0a5d-4679-8686-f5032e4344d2",
"metadata": null,
"network": "mainnet",
"note": null,
"rate": "0.848566",
"reason": null,
"recipientAddress": "0xD2b6be31932E0294F2ebD14a008C3f1E05B47BC4",
"senderAddress": "0xD2b6be31932E0294F2ebD14a008C3f1E05B47BC4",
"status": "PENDING",
"toAmount": "0.424283",
"toAsset": {
"address": "0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85",
"blockchain": {
"createdAt": "2024-10-07T22:09:49.784Z",
"derivationPath": "m/44'/60'/0'/0",
"id": "1c9ca9df-325f-4b60-a7ec-b28d2235e0b7",
"isActive": true,
"isEvmCompatible": true,
"isL2": true,
"logoUrl": "https://res.cloudinary.com/blockradar/image/upload/v1728312943/crypto-assets/optimism-ethereum-op-logo_h62d1i.png",
"name": "optimism",
"slug": "optimism",
"symbol": "eth",
"tokenStandard": null,
"updatedAt": "2024-11-26T19:04:13.947Z"
},
"createdAt": "2024-10-08T19:12:41.930Z",
"decimals": 6,
"id": "ee7318c8-3a61-4437-88a0-de56b97f2a89",
"isActive": true,
"logoUrl": "https://res.cloudinary.com/blockradar/image/upload/v1716800083/crypto-assets/usd-coin-usdc-logo_fs9mhv.png",
"name": "USD Coin",
"network": "mainnet",
"standard": null,
"symbol": "USDC",
"updatedAt": "2024-10-08T19:12:41.930Z"
},
"toBlockchain": {
"createdAt": "2024-10-07T22:09:49.784Z",
"derivationPath": "m/44'/60'/0'/0",
"id": "1c9ca9df-325f-4b60-a7ec-b28d2235e0b7",
"isActive": true,
"isEvmCompatible": true,
"isL2": true,
"logoUrl": "https://res.cloudinary.com/blockradar/image/upload/v1728312943/crypto-assets/optimism-ethereum-op-logo_h62d1i.png",
"name": "optimism",
"slug": "optimism",
"symbol": "eth",
"tokenStandard": null,
"updatedAt": "2024-11-26T19:04:13.947Z"
},
"toWallet": {
"address": "0xD2b6be31932E0294F2ebD14a008C3f1E05B47BC4",
"configurations": null,
"createdAt": "2024-10-08T19:15:28.390Z",
"derivationPath": "m/44'/60'/0'/0/0",
"description": "This is Optimism Wallet",
"id": "f25dfef5-253a-4cb8-ab00-80f2e799f780",
"isActive": true,
"name": "Optimism Wallet",
"network": "mainnet",
"status": "ACTIVE",
"updatedAt": "2024-10-08T19:15:28.390Z"
},
"tokenAddress": null,
"type": "SWAP",
"updatedAt": "2025-04-01T15:00:28.604Z",
"wallet": {
"address": "0xD2b6be31932E0294F2ebD14a008C3f1E05B47BC4",
"apiCredential": {
"createdAt": "2024-08-24T19:49:15.617Z",
"id": "4ecea2c9-2ab7-4e9b-a436-16531233859f",
"isActive": true,
"key": "3OHh9gyDLb7h5ZPml638rXbeHShHb0OYMC34ehZRF6M4yepOR4wUOvrxHEh6lMCj",
"revokedAt": null,
"status": "active",
"type": "api_key",
"updatedAt": "2025-04-01T14:59:22.501Z",
"webhookUrl": "https://webhook.site/dbfbd5fa-d55f-4a31-a1d2-509cc60fa91d"
},
"blockchain": {
"createdAt": "2024-05-14T17:53:33.106Z",
"derivationPath": "m/44'/60'/0'/0",
"id": "b80d3d5e-16f1-4d99-be5e-6dfcd27f89aa",
"isActive": true,
"isEvmCompatible": true,
"isL2": false,
"logoUrl": "https://res.cloudinary.com/blockradar/image/upload/v1716800080/crypto-assets/bnb-bnb-logo_e4qdyk.png",
"name": "BNB smart chain",
"slug": "bnb-smart-chain",
"symbol": "bnb",
"tokenStandard": "BEP20",
"updatedAt": "2024-11-26T19:04:13.941Z"
},
"business": {
"configurations": {
"billing": {
"ccEmails": [
"[email protected]"
],
"toEmails": [
"[email protected]"
]
},
"contact": {
"email": "[email protected]"
},
"details": {
"description": "description",
"website": "https://www.blockradar.co"
},
"hideLogoUrlInResponse": false,
"useCustomWebhookSignatureHeader": true
},
"createdAt": "2024-08-22T15:28:37.522Z",
"id": "4b96c271-35eb-45e8-b558-6a53f95df601",
"name": "Blockradar",
"sector": "infrastructure",
"seedPhrase": "key day angry renew wife suit valve defy dose suspect night mandate friend resist regular entire industry sting trouble pyramid rail bright debate direct",
"status": "ACTIVE",
"testnetSeedPhrase": "around goddess ugly elephant network traffic horror climb dry rally flee city student jeans release fat correct trade miracle demand envelope bamboo orphan volume",
"updatedAt": "2025-03-27T16:28:26.587Z",
"user": {
"configurations": {
"setNewPasswordRequired": false
},
"createdAt": "2024-08-22T15:28:37.522Z",
"email": "[email protected]",
"emailVerified": true,
"firstname": "Test",
"id": "ad0ad16d-dc56-48e9-85da-a86adabff48e",
"lastname": "One",
"twoFactorAuthEnabled": true,
"updatedAt": "2025-03-27T16:28:26.592Z"
}
},
"configurations": null,
"createdAt": "2024-08-24T19:49:15.617Z",
"derivationPath": "m/44'/60'/0'/0/0",
"description": "This is BNB Smart Chain Mainnet Wallet",
"id": "23628012-2b69-4ed7-9627-63fb3f547381",
"isActive": true,
"name": "BNB Smart Chain Mainnet Wallet",
"network": "mainnet",
"status": "ACTIVE",
"updatedAt": "2024-08-24T19:49:15.617Z"
}
},
"message": "Swap transaction created successfully",
"statusCode": 200
}Authorizations
Path Parameters
Example:
"YOUR_WALLET_ID"
Example:
"ADDRESS_ID"
Body
application/json
The asset ID to swap from.
Example:
"eda105b9-9471-4149-adb3-7dbf285ec0ab"
The asset ID to swap to.
Example:
"84c8ad33-1450-4d61-9f8f-f0505039f2ec"
The source amount when amountSide is source, or the target amount when amountSide is target.
Example:
"1000"
Use source when amount is the asset amount to spend. Use target when amount is the destination asset amount to receive.
Available options:
source, target Example:
"source"
The external address you want to swap to. For Stellar destinations, send a G... base account or M... muxed account.
Recipient routing is supported only when the destination chain is Stellar. Non-Stellar requests that include this field are rejected. A G... Stellar base account must specify none or memo_id; an M... muxed account already embeds the routing ID and must not include this field. No separate recipient memo field is accepted or exposed. When type is memo_id, the backend normalizes the G... address to an M... address before requesting a quote or execution.
- Option 1
- Option 2
Show child attributes
Show child attributes
Quote preference.
Available options:
FASTEST, CHEAPEST, RECOMMENDED, NO_SLIPPAGE Example:
"RECOMMENDED"