# Sui

### /getsuibalance

Get the balance or number of the given token in the requested public address.

<mark style="color:blue;">`GET`</mark> `https://historicallp.api.expand.network/chain/getsuibalance`

#### Query Parameters

| Name                                      | Type   | Description                                                                                                                                 |
| ----------------------------------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------- |
| rpc                                       | String | Remote procedural call URL                                                                                                                  |
| chainId<mark style="color:red;">\*</mark> | String | Refer to the [Chain ID ](/ids/chain-ids.md)page for details.                                                                                |
| chainSymbol                               | String | Refer to the [Chain ID ](/ids/chain-ids.md)page for details.                                                                                |
| blockNumber                               | String | <p>Block number for which the balance needs to be retrieved.</p><p>By default, it will pick the latest block number when not specified.</p> |
| address<mark style="color:red;">\*</mark> | String | The public address to get the balance of.                                                                                                   |
| tokenAddress                              | String | The address of token to get the balance of.                                                                                                 |

{% tabs %}
{% tab title="Sample Request" %}

```url
https://historicallp.api.expand.network/chain/getsuibalance?chainId=101&address=0x160d7516429e4b5c6e593ab4b5c162484b4719961f5411f1ad48670278334eec&blockNumber=34214422
```

{% endtab %}

{% tab title="Sample Response" %}

```json
{
    "status": 200,
    "msg": "success",
    "data": {
        "balance": "61175416762399"
    }
}
```

{% endtab %}
{% endtabs %}

### /getblock

Get details of a block.

<mark style="color:blue;">`GET`</mark> `https://historicallp.api.expand.network/chain/getblock`

#### Query Parameters

| Name                                          | Type   | Description                                                  |
| --------------------------------------------- | ------ | ------------------------------------------------------------ |
| rpc                                           | String | Remote procedural call URL.                                  |
| chainId<mark style="color:red;">\*</mark>     | String | Refer to the [Chain ID ](/ids/chain-ids.md)page for details. |
| chainSymbol                                   | String | Refer to the [Chain ID ](/ids/chain-ids.md)page for details. |
| blockNumber<mark style="color:red;">\*</mark> | String | The block(Checkpoint) number or block hash.                  |

{% tabs %}
{% tab title="Sample Request" %}

```url
https://historicallp.api.expand.network/chain/getblock?blockNumber=4925305&chainId=101
```

{% endtab %}

{% tab title="Sample Response" %}

```json
{
    "status": 200,
    "msg": "success",
    "data": {
        "difficulty": null,
        "gasLimit": null,
        "gasUsed": {
            "computationFee": "319667546316",
            "storageFee": "1667423348400",
            "storageRebate": "1188416311632",
            "nonRefundableStorageFee": "12004205168"
        },
        "hash": "gZArqpuwddYeuxyK582fs5tTYeagBw6NBU1RD314hzC",
        "miner": null,
        "nonce": null,
        "number": "4925305",
        "parentHash": "8cFaKwc7s52Mt8csDbcqRizCTXGzRLFFkUf8cpw7pb2D",
        "size": null,
        "timestamp": "1686567354670",
        "totalDifficulty": null,
        "transactions": [
            "8SoUvGSix7Ds3qnLRh2Pe2dGHPsnMWM6wv7j8g2XBBs8",
            "8zEWsQkgTdFtqzeGu6aBUgDe6Hysqdfv7LEhDxt4so8p",
            "C8j1ZR3immv3a6bGRUwFnEZ8SNd794nKFL4acLu4pg1C",
            "CaYL9Vg57rHSwsgaHhT8WoXXDfftcozbtaKiJVgk7qA7",
            "Fkm8avKi2qxeTS8aDKeohyn4DT1psoC8Et8jPEXQuxhS",
            "GECi5Pe5MNgUzPSUcwDp1CcBxUiHiZegs4LPvRb21wTU",
            "JAznEFvDf3Wm3C8uyPi1kNEBJcj88x4HgfyPATUUjEGz"
        ],
        "transactionsRoot": null,
        "uncles": null
    }
}
```

{% endtab %}
{% endtabs %}

### /getgasprice

Get the current gas price from the network.

<mark style="color:blue;">`GET`</mark> `https://api.expand.network/chain/getgasprice`

#### Query Parameters

| Name                                      | Type   | Description                                                  |
| ----------------------------------------- | ------ | ------------------------------------------------------------ |
| rpc                                       | String | Remote procedural call URL.                                  |
| chainId<mark style="color:red;">\*</mark> | String | Refer to the [Chain ID ](/ids/chain-ids.md)page for details. |
| chainSymbol                               | String | Refer to the [Chain ID ](/ids/chain-ids.md)page for details. |

{% tabs %}
{% tab title="Sample Request" %}

```url
https://api.expand.network/chain/getgasprice?chainId=101
```

{% endtab %}

{% tab title="Sample Response" %}

```json
{
    "status": 200,
    "msg": "success",
    "data": {
        "gasPrice": 820
    }
}
```

{% endtab %}
{% endtabs %}

### /getstorage

Get data stored in the given slot.

<mark style="color:blue;">`GET`</mark> `https://api.expand.network/chain/getstorage`

#### Query Parameters

| Name                                      | Type   | Description                                                  |
| ----------------------------------------- | ------ | ------------------------------------------------------------ |
| rpc                                       | String | Remote procedural call URL.                                  |
| chainId<mark style="color:red;">\*</mark> | String | Refer to the [Chain ID ](/ids/chain-ids.md)page for details. |
| chainSymbol                               | String | Refer to the [Chain ID ](/ids/chain-ids.md)page for details. |
| address<mark style="color:red;">\*</mark> | String | Object Id whose storage is needed.                           |

{% tabs %}
{% tab title="Sample Request" %}

```url
https://api.expand.network/chain/getstorage?chainId=101&address=0x2c0c60250556852f3391645418c3a1939557ef3f86197bfd8d5f08e42bf8a562
```

{% endtab %}

{% tab title="Sample Response" %}

```json
{
    "status": 200,
    "msg": "success",
    "data": {
        "data": {
            "data": {
                "objectId": "0x2c0c60250556852f3391645418c3a1939557ef3f86197bfd8d5f08e42bf8a562",
                "version": "5832321",
                "digest": "4U8VJLHhmwcSLQKZ4E94i3LpVkfTEgqTs2JvJnaHjAWE",
                "type": "0x2::coin::Coin<0x2::sui::SUI>",
                "owner": {
                    "AddressOwner": "0x4e6c09c10308e273b01f9be9f4eebc4cd47408156dcf580036946ca17468efbd"
                },
                "previousTransaction": "BTA1oPx1mxoh8eE7abaZjn68661kmK5HR778Xh5wnDhV",
                "content": {
                    "dataType": "moveObject",
                    "type": "0x2::coin::Coin<0x2::sui::SUI>",
                    "hasPublicTransfer": true,
                    "fields": {
                        "balance": "3247896304",
                        "id": {
                            "id": "0x2c0c60250556852f3391645418c3a1939557ef3f86197bfd8d5f08e42bf8a562"
                        }
                    }
                }
            }
        }
    }
}
```

{% endtab %}
{% endtabs %}

### /gettransaction

Get details of a transaction.

<mark style="color:blue;">`GET`</mark> `https://api.expand.network/chain/gettransaction`

#### Query Parameters

| Name                                              | Type   | Description                                                  |
| ------------------------------------------------- | ------ | ------------------------------------------------------------ |
| rpc                                               | String | Remote procedural call URL.                                  |
| chainId<mark style="color:red;">\*</mark>         | String | Refer to the [Chain ID ](/ids/chain-ids.md)page for details. |
| chainSymbol                                       | String | Refer to the [Chain ID ](/ids/chain-ids.md)page for details. |
| transactionHash<mark style="color:red;">\*</mark> | String | The transaction(digest) hash.                                |

{% tabs %}
{% tab title="Sample Request" %}

```url
https://api.expand.network/chain/gettransaction?chainId=101&transactionHash=fcT9BaBGgRXHo2ngJAVAPACnYVUPtu1qAmUqLACNGZ2
```

{% endtab %}

{% tab title="Sample Response" %}

```json
{
    "status": 200,
    "msg": "success",
    "data": {
        "hash": "fcT9BaBGgRXHo2ngJAVAPACnYVUPtu1qAmUqLACNGZ2",
        "transactionStatus": "success",
        "blockNumber": "5851982",
        "timestamp": "1687511099697",
        "from": "0x3171f5feed9f73a6ce73764c8c713816c8ad02b3cd2c72bfb46421bee417f488",
        "to": null,
        "value": null,
        "transactionFees": {
            "computationFee": "820000",
            "storageFee": "8048400",
            "storageRebate": "6568452",
            "nonRefundableStorageFee": "66348"
        },
        "gas": {
            "payment": [
                {
                    "objectId": "0xe68aa8790c973b9b56de6082570aa24a6b07827e11e8d7c76de36c8a55f7e1a2",
                    "version": 5752185,
                    "digest": "DUGMzaGpSsQHS5DvcZmCTFupJxRWEmjm1H3YcCyNRv4p"
                }
            ],
            "owner": "0x1d632d46ff70491033fefc4e6398dceaa4943dcf62512b4d57378b5ab703bc5e",
            "price": "820",
            "budget": "10000000"
        },
        "gasPrice": 820,
        "input": [
            {
                "type": "object",
                "objectType": "sharedObject",
                "objectId": "0xa12497d95f761a3d7337e1f690c4dbbee5bc6fa52302a97d10249e856062aee5",
                "initialSharedVersion": "4338970",
                "mutable": true
            }
        ],
        "nonce": null,
        "network": null
    }
}
```

{% endtab %}
{% endtabs %}

### **/sendtransaction**

Send transaction on the chain.

<mark style="color:green;">`POST`</mark> `https://api.expand.network/chain/sendtransaction`

#### Request Body

| Name                                             | Type   | Description                                                    |
| ------------------------------------------------ | ------ | -------------------------------------------------------------- |
| rpc                                              | String | Remote procedural call URL.                                    |
| chainId<mark style="color:red;">\*</mark>        | String | Refer to the [Chain ID ](/ids/chain-ids.md)page for details.   |
| chainSymbol                                      | String | Refer to the [Chain ID ](/ids/chain-ids.md)page for details.   |
| rawTransaction<mark style="color:red;">\*</mark> | String | The encoded transaction, obtained from the signed transaction. |
| signature<mark style="color:red;">\*</mark>      | String | Signature, received after signing the transaction.             |

{% tabs %}
{% tab title="Sample Request" %}

```json
{
    "chainId": "101",
    "rawTransaction": "AAACAAjoAwAAAAAAAAAgjoLsljoRhNzWIhv109/7Y5u+3rE+m3cIAS6+9fY1CV0CAgABAQAAAQEDAAAAAAEBAHU9KMxqJHko4cO7vudRc1fUWhlgTsWqhC49Sd/RqeJ3AWLHsjiaUXCf24QTPngz4YscltY7WXx8EEvwMWY3bQi2EgAAAAAAAAAgAnvVen24ygZdxuPGTP5c0y9v4Q6gBEBrVZToO1VwKO91PSjMaiR5KOHDu77nUXNX1FoZYE7FqoQuPUnf0anid+gDAAAAAAAAEJAtAAAAAAAA",
    "signature": "AIZ7D4E4VKOy2biUd2O7Wayjjj+voVX1fUtX7Hx5Ga/twHIZ1BbfMrMoPDLIWU774K0199NZXrFIw+aILTTj7Q5Dii+a4T1FLWxQvLizpwhD6VXBW4qPG0vYYOJ2O0GuhQ=="
}
```

{% endtab %}

{% tab title="Sample Response" %}

```json
{
    "status": 200,
    "msg": "success",
    "data": {
        "chainId": "101",
        "transactionHash": "67yEnYvTfkNnKPtxrLfYomhWoi5cH7XCPbVQtjJ3UAW9" 
    }
}
```

{% endtab %}
{% endtabs %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.expand.network/integrations/blockchains/non-evm-based-chains/sui.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.