suix_getCoins

Coin Query API

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

Parameters

• owner · SuiAddress · requiredthe owner's Sui address
• coin_type · string · optionaloptional type name for the coin (e.g., 0x168da5bf1f48dafc111b0a488fa454aca95e0b5e::usdc::USDC), default to 0x2::sui::SUI if not specified.
• cursor · string · optionaloptional paging cursor
• limit · integer (uint) · optionalmaximum number of items per page

Result

• CoinPage · Page<Coin, String>

  • data · Coin[] · required
  • hasNextPage · boolean · required
  • nextCursor · string or null · optional

Example

Request

curl https://mainnet-api.inodra.com/v1/jsonrpc \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: YOUR_API_KEY' \
  -d '{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "suix_getCoins",
  "params": [
    "0x6d907beaa3a49db57bdfdb3557e6d405cbf01c293a53e01457d65e92b5d8dd68",
    "0x2::sui::SUI",
    "0xee6b5173afedb35330f60397c2cbb48196ba41921246c304be7b490cee0904eb",
    3
  ]
}'

Response

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "data": [
      {
        "coinType": "0x2::sui::SUI",
        "coinObjectId": "0xd62ca040aba24f862a763851c54908cd2a0ee7d709c11b93d4a2083747b76856",
        "version": "103626",
        "digest": "C9fdokK19BpDCgUgWsJv3cfd4LDyk7WGYBeGhFHbEL2Z",
        "balance": "200000000",
        "previousTransaction": "tw5DzJTfdxTn4f3rekFrhN7dQTUezBgsEhycDobTBLb"
      },
      {
        "coinType": "0x2::sui::SUI",
        "coinObjectId": "0xf44d295a385dc3544d211411b865e8bc4f01f49186970c7cf61e1cc829cc0be7",
        "version": "103626",
        "digest": "5qZkmtN5J5uGHURtiy9BtBhnXATPR2Wa6BJBDLrMzCaf",
        "balance": "200000000",
        "previousTransaction": "AfgFe7ZfjJ5dWV6VAy2LbtvBFhcABkvdvwEjLrRcFqtr"
      },
      {
        "coinType": "0x2::sui::SUI",
        "coinObjectId": "0x42ef9314ccc792dd4401a88e69c66b4c5e43f21e9e57f4abe3c702649d3a7dd0",
        "version": "103626",
        "digest": "FLE2nB2Wio3oUyTx6HyzkrMsWiZxDg9Kk8s7ivvuoBbD",
        "balance": "200000000",
        "previousTransaction": "9er6jxigfuQEKsn9gtPV2oW1zGQRcFtKNijHVe88GUJD"
      }
    ],
    "nextCursor": "abcd",
    "hasNextPage": true
  }
}