This API function enables the creation of a transaction and the transfer of funds to a specified destination address. The transfer can be executed using either Native Coins or Tokens, depending on your requirements.
Quick Navigation: Function Index
- Send Many Transaction via Native Coin
- Send Many Transaction via Token
- Initiate Mobile MPC Wallet Transaction via Express
- Send Many Transaction via Native Coin using Memo
1. Send Many Transaction via Native Coin
For transactions involving Native Coins such as Ethereum (ETH), Bitcoin (BTC), Polygon Matic, etc., the following request format should be used:
Example Request Body (Non-UTXO chains)
{
"wallet":{
"coin": "eth",
"walletId":1,
"allToken":true
},
"transactions":{
"recipientsData":{
"recipients":[
{
"address":"0x42c8909a4e67e5db1D0e510E0E592B39F3fADE7c",
"amount":0.0001
}
],
"sequenceId":"ca1aa351-a2d8-4dd6-9474-fd7b8b7a5ed20"
}
}
}
Example Request Body (UTXO chains)
{
"wallet":{
"coin": "btc",
"walletId":1,
"allToken":true
},
"transactions":{
"recipientsData":{
"recipients":[
{
address:"2NBwP2FNqAbs6zZjnkEcTqdic1xK7Msy9Fn",
amount:0.0006
},
{
address:"2Mz7cLmCrPZJJ5SKwHwVezSYwQjNXCjGMTK",
amount:0.0007
},
{
address:"2MvnUDYuAXgvbYBik1JS6ee6M5GyYrN5L3q",
amount:0.0008
},
{
address:"2NEkNZdDyDo9672pjfEDAaHKe3YFpsoqEDX",
amount:0.0009
}
],
"sequenceId":"ca1aa351-a2d8-4dd6-9474-fd7b8b7a5ed20"
}
}
}
2. Send Many Transaction via Token
For transactions involving ERC20 tokens like DAI, USDC, USDT, etc., the following request format should be used:
Discover Token Addresses: Navigating to the Token Section for Key Addresses
Token addresses can be found within the dedicated Token section of the documentation. Kindly direct your attention to that section for the relevant addresses.
Example Request Body
{
"wallet":{
"coin": "eth",
"walletId":1,
"allToken":true,
"tokenOptions":{
"tokenName":"dai",
"tokenAddress":"0xdc31Ee1784292379Fbb2964b3B9C4124D8F89C60"
}
},
"transactions":{
"recipientsData":{
"recipients":[
{
"address":"0x92BFFd4DC976c7781DE152DcE439a7C57740CE04",
"amount":1
}
],
"sequenceId":"ca1aa351-a2d8-4dd6-9474-fd7b8b7a5ed9"
}
}
}
Property | Description |
---|---|
status | 1 -> Transaction Initiate 2 -> Transaction Broadcast 4 -> Transaction Confirmed 5 -> Transaction Failed/ Cancelled |
identifier | It is also used as Transaction Hash (txHash) or Transaction ID(txID) |
sequenceId | The sequenceID is a unique identifier that is assigned to each transfer transaction at the time of its creation. This identifier is indispensable for the execution of the transfer, as the transaction cannot be processed without it. The sequenceID serves as a key tool for tracking the status of transfer transactions, making it a vital element in the transaction process. It's important to note that the sequenceID is a mandatory parameter for initiating transfers. With the help of sequenceID, tracking the status of transfer transactions becomes a straightforward task. |
Multi-Recipient Support: UTXO vs Non-UTXO Chains
For UTXO chains, multiple recipients can be included in the request body, and funds will be distributed to these recipient addresses. For non-UTXO chains, this API supports only one recipient.
Cautionary Note: Recipient Address Whitelisting
It's important to note that the recipient addresses listed are not whitelisted by Liminal. Therefore, clients are advised to exercise caution when specifying recipient addresses.
3. Initiate Mobile MPC Wallet Transaction via Express
3.1 Transfer Transaction Using Native Coin
Example Request Body
{
"wallet":{
"coin": "eth",
"walletId":3,
"allToken":true
},
"transactions":{
"recipientsData":{
"recipients":[
{
"address":"0xa5946470206572eC729DA064fDe6a044CCfbE537",
"amount":0.008
}
],
"sequenceId":"{{guid}}"
}
}
}
3.2 Transfer Transaction Using Token
Example Request Body
{
"wallet":{
"coin": "eth",
"walletId":3,
"allToken":true,
"tokenOptions":{
"tokenName":"USDC",
"tokenAddress":"0xD87Ba7A50B2E7E660f678A895E4B72E7CB4CCd9C"
}
},
"transactions":{
"recipientsData":{
"recipients":[
{
"address":"0x8C3958cdb467bE0D0581d2A5D5387A78D598svfbf",
"amount":10
}
],
"sequenceId":"76a26d77-34b1-4382-9fca-3f3bad05edb5"
}
}
}
4. Send Many Transaction via Native Coin using Memo
As of the current update, Memo is supported for both XRP and Cosmos chains.
Example Request Body
{
"wallet":{
"coin": "xrp",
"walletId":4,
"allToken":true
},
"transactions":{
"recipientsData":{
"recipients":[
{
"address":"rEAGpikkiMRDfGMszGLiMUu71u7Diw88cZ",
"amount":52,
"data":"13"
}
],
"sequenceId":"76a26d77-34b1-4382-9fca-3f3bad05ed52"
}
}
}