Links

sui_getCoins

Return all Coin<`coin_type`> objects owned by an address.

Parameters

  • owner : <SuiAddress> - the owner's Sui address
  • coin_type : <string> - optional fully qualified type names for the coin (e.g., 0x168da5bf1f48dafc111b0a488fa454aca95e0b5e::usdc::USDC), default to 0x2::sui::SUI if not specified.
  • cursor : <ObjectID> - optional paging cursor
  • limit : <uint> - maximum number of items per page

Returns

CoinPage : <Page_for_Coin_and_ObjectID>

Example Request and Result for sui_getCoins

Request
curl
--location --request POST 'https://sui-devnet.blastapi.io/<project_id>' \
--header 'Content-Type: application/json' \
--data-raw '{
"jsonrpc": "2.0",
"id": 1,
"method": "sui_getCoins",
"params": [
"0xed1d0a1d117609a401bcc98e441aadb868f3ed95",
"0x2::sui::SUI",
"0x61019b0d2ab4a6f9f204fdba268ca5f57872cf88",
3
]
}'
Result
{
"jsonrpc": "2.0",
"result": {
"data": [
{
"coinType": "0x2::sui::SUI",
"coinObjectId": "0x61019b0d2ab4a6f9f204fdba268ca5f57872cf88",
"version": 11258,
"digest": "p8jPYUeWrdFTyuVSzcJ1SyThtYjNtox+JoyOH+Qz7tM=",
"balance": 10000000
},
{
"coinType": "0x2::sui::SUI",
"coinObjectId": "0x6703dd19f1ba474bd71ab1f918eeca9d690a577e",
"version": 11259,
"digest": "RmwtpggSBkBlz1Ef5ODldcYzovc3f/2uZknyGduxtpQ=",
"balance": 10000000
},
{
"coinType": "0x2::sui::SUI",
"coinObjectId": "0x9736941eb42377582ec07a580adaf17816cfbb20",
"version": 11259,
"digest": "N0gqYXAO7gD34iagyJ+GFcELXMi9jDp7GMssyShbrCk=",
"balance": 10000000
}
],
"nextCursor": "0x9d90644dd686f50edf6824418191587f4a0b4316"
},
"id": 1
}