> For the complete documentation index, see [llms.txt](https://docs.octusbridge.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.octusbridge.io/ob-id/integrate/octus-bridge-api/bridge-api/dao.md).

# DAO

## Mendapatkan data pemegang saham

<mark style="color:green;">`POST`</mark> `https://api.octusbridge.io/v1/dao/search/stakeholders`

{% tabs %}
{% tab title="200: OK Successful request" %}

```
{
  "stakeholders": [
    {
      "userAddress": "0:0a75c8fa5a9efa817eda3fcd51717d9690cc7ec989881fecb73616f249b8fbce",
      "votes": "0",
      "voteWeight": "0",
      "proposalVotesCount": 1
    },
    ...
{
      "userAddress": "0:8e17dbaa03a309b9f05867595126a72e5cbbe8c61d10f1250fb8d9753aaf0f7d",
      "votes": "0",
      "voteWeight": "0",
      "proposalVotesCount": 0
    }
  ],
  "totalCount": 206
}
```

{% endtab %}
{% endtabs %}

Fungsi ini digunakan untuk mendapatkan data pemegang saham.

Dapat digunakan untuk menampilkan daftar jumlah pemegang saham yang diinginkan, di mana informasi tentang jumlah total suara yang dikumpulkan oleh pemegang saham, berapa banyak suara pemegang saham yang dapat ditimbang, alamat dan jumlah pengajuan yang dia pilih diurutkan berdasarkan bobot suara.

### Parameter permintaan

Parameter tubuh yang diperlukan:

| Nama     | Nilai contoh          | Komentar                                                                                                                                                                                                               |
| -------- | --------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| limit    | `50`                  | Jumlah maksimum pemegang saham yang akan diambil                                                                                                                                                                       |
| offset   | `0`                   | Offset                                                                                                                                                                                                                 |
| ordering | `voteweightascending` | Nilai berdasarkan data pemegang saham yang diambil akan diurutkan (voteweightascending, voteweightdescending…)berdasarkan data pemegang saham yang diambil akan diurutkan (voteweightascending, voteweightdescending…) |

### Penjelasan bidang respons

| Nama               | Nilai contoh                                                         | Komentar                                                         |
| ------------------ | -------------------------------------------------------------------- | ---------------------------------------------------------------- |
| stakeholders       | -                                                                    | Daftar data pemegang saham ditentukan oleh parameter tubuh batas |
| proposalVotesCount | `1`                                                                  | Jumlah pengajuan pemegang saham mengangkat suara                 |
| userAddress        | `0:0c3fbf8b400ce637a49e09e7ae2fc5e92920680b1d10f4cd6956c7aebde93903` | Alamat pemegang saham                                            |
| voteWeight         | `0`                                                                  | Jumlah per suara                                                 |
| votes              | `0`                                                                  | Jumlah total suara yang terkumpul                                |
| totalCount         | `208`                                                                | Jumlah pemegang saham                                            |

### Contoh

```java
app.post('/dao/search/stakeholders', (req, res) => {
    axios({
        method: 'post',
        url: `${apiUrl}/dao/search/stakeholders`,
        data: {
            limit: req.body.limit,
            offset: req.body.offset,
            ordering: req.body.ordering
        }
      })
    .then(function (response) {
        res.send(response.data)
    })
    .catch(function(error){
        console.error(error)
        res.send('Error')
    })
})
```

## Mendapatkan data pemegang saham

<mark style="color:blue;">`GET`</mark> `https://api.octusbridge.io/v1/dao/user/{user_address}`

{% tabs %}
{% tab title="200: OK Successful request" %}

```python
{
  "userAddress": "0:66003d2db4bc1566c3d7d3c118004b1e1d54f1f62c30c6b173845db3aa459f07",
  "votes": "100002.580351726000",
  "voteWeight": "3.4000",
  "proposalVotesCount": 1
}
```

{% endtab %}
{% endtabs %}

Fungsi ini digunakan untuk mendapatkan data pemegang saham.

Dapat digunakan untuk menampilkan data pemegang saham seseorang berdasarkan alamat akunnya. Informasi yang dapat ditampilkan adalah jumlah suara yang diajukan oleh pemegang saham tertentu, bobot suaranya, alamat dan jumlah total suara pengajuan.

### Parameter permintaan

Parameter yang diperlukan:

| Nama        | Nilai Contoh                                                       | Komentar             |
| ----------- | ------------------------------------------------------------------ | -------------------- |
| userAddress | 0:66003d2db4bc1566c3d7d3c118004b1e1d54f1f62c30c6b173845db3aa459f07 | Alamat akun tertentu |

### Penjelasan bidang respons

| Nama               | Nilai contoh                                                       | Komentar                                         |
| ------------------ | ------------------------------------------------------------------ | ------------------------------------------------ |
| proposalVotesCount | 1                                                                  | Jumlah pengajuan pemegang saham mengangkat suara |
| userAddress        | 0:66003d2db4bc1566c3d7d3c118004b1e1d54f1f62c30c6b173845db3aa459f07 | Alamat pengguna                                  |
| voteWeight         | 3.400                                                              | Jumlah yang mewakili bobot suara (per suara)     |
| votes              | 100002.580351726000                                                | Jumlah total suara yang terkumpul                |

### Contoh

```java
app.get('/dao/user/:user_address', (req, res) => {
    axios({
        method: 'get',
        url: `${apiUrl}/dao/user/${req.params.user_address}`
      })
    .then(function (response) {
        res.send(response.data)
    })
    .catch(function(error){
        console.error(error)
        res.send('Error')
    })
})
```