/sendStellarTransaction

1 min

POST

Send a Stellar (XLM) transaction using the specified parameters.

Use getSuggestedFee to get the current suggested fee before running the transaction.

NOTE: Success or failure in this API call does not necessarily mean success or failure in the transaction itself. For example, the transaction may succeed, but the "success" response to the client can be lost if the client's internet connection is down. To verify the status of the transaction:

Call getCurrentToken and make a note of the return value.
Send your transaction. The transaction created uses the token from step 1.
Call getTransactionByToken using your token from getCurrentToken to track the current status of the transaction you just sent.

This function is part of the transaction flow detailed at https://docs.gk8.io/api-v19/sending-transactions-from-the-api. See the linked article for more details.

return: JSON object containing the transaction details.

example: sendStellarTransaction(1, [("GA3F...GF", "5")], 100)

account_idintegerThe account ID we want to use in this operation

outputsarray<p>List of tuples representing the destination address and amount to transfer.</p> <ul> <li>Format: [(destination_address: str, amount_to_transfer: int)]</li> </ul>

feeintegerthe fee in XLM Stroops we want to transfer.

descriptionstring<p>free text for describing the transaction (will not be sent to the blockchain)</p>

specificFromAddressstringDeposit address to send from

acceptstringGenerated from available response content types

bodyobjectRequest data for transferring funds.

200success

curl --request POST \
     --url '/sendStellarTransaction?account_id=1&outputs=array&fee=100&description=Test&specificFromAddress=GDCEWT2N6HKZTULS34GYCOWEA2QODRNDP7O5N4MW6H55EHCOLGXTMRQF' \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '{
     "AccountId": 1,
     "CoinType": "XLM",
     "Fee": {
     "Fee": 100
     },
     "SpecificFromAddress": "GDCEWT2N6HKZTULS34GYCOWEA2QODRNDP7O5N4MW6H55EHCOLGXTMRQF",
     "Transactions": [
     {
     "AmountToTransfer": 5,
     "DestinationAddress": "GBMDG2KCYGH3CKERPIVY6W7KG2MQOP7DNT3SGF2X3E6UTDZ3RKBAAUXQ"
     }
     ],
     "UserDescription": "Test",
     "Meta": {
     "FunctionName": "sendStellarTransaction",
     "RandomData": "288cd49d4b8bf00e7d6114b78d5668d5581d6b953fafef779133caa844cd4229",
     "Destination": "b9cb8afe52f1d52521cf2b62dfe12146156ad5328f83c62c20c7da81b263356a61340de745c858998544c041798b01c2f4fac31bebe52a19280a32cd57d6d374ea",
     "Time": "2021-02-07T18:37:46.948Z",
     "Source": "048b99461a70a49abe63fd585cb224177a22a92d2e9e4ddfbc0027887bee9d1843388f42a3eb2e740565e115ad8b7981abf59e3b03b771f4b063b53c517d7a9d99",
     "AccessToken": "51311c84d2c8fd2fafbe56ceb1fb30a99d3417abfc55769577338ab286798087"
     }
     }'