> ## Documentation Index
> Fetch the complete documentation index at: https://docs.uniblock.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# suix_getCoins

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

### Parameters

<ParamField query="chainId" type="string" default="sui" required>
  Unique identifier for a blockchain network.
</ParamField>

<ParamField body="id" type="number" default={1} required>
  Request identifier used to match responses.
</ParamField>

<ParamField body="jsonrpc" type="string" default="2.0" required>
  JSON-RPC version.
</ParamField>

<ParamField body="method" type="string" default="suix_getCoins" required>
  JSON-RPC method name.
</ParamField>

<ParamField body="params" type="object" default={["0x6d907beaa3a49db57bdfdb3557e6d405cbf01c293a53e01457d65e92b5d8dd68","0x2::sui::SUI","0xee6b5173afedb35330f60397c2cbb48196ba41921246c304be7b490cee0904eb",3]} placeholder="[&#x22;0x6d907beaa3a49db57bdfdb3557e6d405cbf01c293a53e01457d65e92b5d8dd68&#x22;,&#x22;0x2::sui::SUI&#x22;,&#x22;0xee6b5173afedb35330f60397c2cbb48196ba41921246c304be7b490cee0904eb&#x22;,3]" required>
  Parameters for suix\_getCoins: \[ownerAddress, coinType, cursor, limit].

  Positional parameters for <code>suix\_getCoins</code>:

  <ul>
    <li><code>params\[0]</code>: The owner's Sui address</li>
    <li><code>params\[1]</code>: Optional type name for the coin</li>
    <li><code>params\[2]</code>: Optional paging cursor</li>
    <li><code>params\[3]</code>: Maximum number of items per page</li>
  </ul>
</ParamField>

### Returns

<ResponseField name="result" type="object">
  The array of coin objects.

  <Expandable title="properties">
    <ResponseField name="data" type="array">
      Array of Coin objects owned by the user

      <Expandable title="items">
        <ResponseField name="items[]" type="object">
          <Expandable title="properties">
            <ResponseField name="coinType" type="string">
              Coin type
            </ResponseField>

            <ResponseField name="coinObjectId" type="string">
              Coin object ID
            </ResponseField>

            <ResponseField name="version" type="string">
              Version of the coin object
            </ResponseField>

            <ResponseField name="digest" type="string">
              Digest of the coin object
            </ResponseField>

            <ResponseField name="balance" type="string">
              Coin balance as string (BigInt for uint128)
            </ResponseField>
          </Expandable>
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="hasNextPage" type="boolean">
      Whether there are more pages to fetch
    </ResponseField>

    <ResponseField name="nextCursor" type="string">
      Cursor for the next page
    </ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```bash Curl theme={null}
  curl --request POST \
    --url https://api.uniblock.dev/uni/v1/json-rpc?chainId=sui \
    --header 'content-type: application/json' \
    --data '{
      "id": 1,
      "jsonrpc": "2.0",
      "method": "suix_getCoins",
      "params": [
        "0x6d907beaa3a49db57bdfdb3557e6d405cbf01c293a53e01457d65e92b5d8dd68",
        "0x2::sui::SUI",
        "0xee6b5173afedb35330f60397c2cbb48196ba41921246c304be7b490cee0904eb",
        3
      ]
    }'
  ```
</RequestExample>

<ResponseExample>
  ```json Success theme={null}
  {
    "jsonrpc": "2.0",
    "id": 1,
    "result": {}
  }
  ```
</ResponseExample>