unsafe_paySui

POST

/{apiKey}

Creates an unsigned transaction that sends SUI to multiple recipients. The transaction uses SUI coins for both transfer and gas without requiring a separate gas object. 1. Debits each input coin to create new coins for recipients. 2. Consolidates residual SUI into the first coin, which becomes the gas coin. 3. Updates the first coin balance to: total_input - total_output - gas_cost. 4. Deletes all other input coins.

Path Parameters

stringrequireddefaults to docs-demo

For higher throughput, create your own API key

Request

stringrequired

The transaction signer's Sui address.

string[]required

List of Coin<SUI> object IDs to use, including the one used for gas.

string[]required

List of recipient Sui addresses.

string[]required

List of amounts (same order as recipients).

stringrequired

The gas budget for the transaction.

Responses

200

Unsigned transaction that transfers SUI to recipients.

POST/v2/{apiKey}

curl --request POST \  --url https://sui-mainnet.g.alchemy.com/v2/docs-demo \  --header 'Content-Type: application/json' \  --data '{  "jsonrpc": "2.0",  "id": 1,  "method": "unsafe_paySui",  "params": [    "0xeeb30f4dc675a7d49b8abedf58eb2e3738facfc554c80f4b27ab62aa02878f56",    [      "0xee65df446c896504512cb35a83f82510c10fd2fab5de2b51a3a63ff6f7106da7"    ],    [      "0x1f446cc6caa6dff121d1540568e91e89b7e0d36f6e009522c59265c627ed0361"    ],    [      "2"    ],    "2000"  ]}'

200Success

{  "jsonrpc": "2.0",  "id": 1,  "result": {    "txBytes": "AAACAAgCAAAAAAAAAAAgH0Rsxsqm3/Eh0VQFaOkeibfg029uAJUixZJlxiftA2ECAgABAQA...",    "gas": [      {        "objectId": "0xee65df446c896504512cb35a83f82510c10fd2fab5de2b51a3a63ff6f7106da7",        "version": 1,        "digest": "jKbAsTuqaK9k6hb27Z5xxnQVmTSWoU6dkL82x44c2dW"      }    ],    "inputObjects": [      {        "ImmOrOwnedMoveObject": {          "objectId": "0xee65df446c896504512cb35a83f82510c10fd2fab5de2b51a3a63ff6f7106da7",          "version": 1,          "digest": "jKbAsTuqaK9k6hb27Z5xxnQVmTSWoU6dkL82x44c2dW"        }      }    ]  }}

Was this page helpful?