Routes

Endpoints

Chain	Endpoint
Berachain Mainnet & Berachain bArtio B2	https://beravote.com/api/

---

Chain

Chains Definition

GET /api/chains/definition

Retrieve metadata for all supported chains.

Headers

Name	Value
Content-Type	application/json
Authorization	Bearer xxxx

Response

200

[
  {
    "network": "ethereum",
    "decimals": 18,
    "name": "Ethereum",
    "supportAssetTypes": [
      "evm_erc20"
    ],
    "symbol": "ETH"
  },
  {
    "network": "solana",
    "decimals": 18,
    "name": "Solana",
    "supportAssetTypes": [
      "svm_token_extension"
    ],
    "symbol": "SOL"
  }
  ...
]

---

Supported networks

GET /api/networks

Get the list of the supported and active networks

Headers

Name	Value
Content-Type	application/json
Authorization	Bearer xxxx

Response

200

[
  {
    "network": "ethereum",
    "ss58Format": null
  },
  {
    "network": "taiko",
    "ss58Format": 167008
  },
  ...
]

---

Home

Popular Proposals

GET /api/home/hottest

Find most active proposals along all spaces

Headers

Name	Value
Content-Type	application/json
Authorization	Bearer xxxx

Response

200

[
  {
    "_id": "672687d903fb1822856384ee",
    "space": "mafia",
    "networksConfig": {
      "symbol": "MAFIA",
      "decimals": 9,
      "networks": [
        {
          "network": "solana",
          "ss58Format": null,
          "assets": [
            {
              "symbol": "MAFIA",
              "decimals": 9,
              "votingThreshold": "1000000000",
              "multiplier": 1,
              "type": "solana",
              "contract": "BcJgLEF5viPPgRVYCcLyR59vDM3UqyuU8jUJT1BVZVF9"
            }
          ]
        }
      ],
      "strategies": [
        "balance-of"
      ],
      "version": "4"
    },
    "postUid": "53",
    "title": "Select an option",
    "content": "Mafia or Police",
    "contentType": "markdown",
    "choiceType": "single",
    "choices": [
      "Mafia",
      "Police"
    ],
    "startDate": 1730494800000,
    "endDate": 1732914000000,
    "snapshotHeights": {
      "solana": 299151323
    },
    "weightStrategy": [
      "balance-of"
    ],
    "proposer": "3fuMzf46n9bb5cbeccUSz6SE1eYEQbLK6JkibALyazeR",
    "proposerNetwork": "solana",
    "banner": null,
    "data": {
      "space": "mafia",
      "networksConfig": {
        "symbol": "MAFIA",
        "decimals": 9,
        "networks": [
          {
            "network": "solana",
            "ss58Format": null,
            "assets": [
              {
                "symbol": "MAFIA",
                "decimals": 9,
                "votingThreshold": "1000000000",
                "multiplier": 1,
                "type": "solana",
                "contract": "BcJgLEF5viPPgRVYCcLyR59vDM3UqyuU8jUJT1BVZVF9"
              }
            ]
          }
        ],
        "strategies": [
          "balance-of"
        ],
        "version": "4"
      },
      "title": "Select an option",
      "content": "Mafia or Police",
      "contentType": "markdown",
      "choiceType": "single",
      "choices": [
        "Mafia",
        "Police"
      ],
      "startDate": 1730494800000,
      "endDate": 1732914000000,
      "snapshotHeights": {
        "solana": 299151323
      },
      "realProposer": null,
      "proposerNetwork": "solana",
      "version": "5",
      "timestamp": 1730578380
    },
    "address": "3fuMzf46n9bb5cbeccUSz6SE1eYEQbLK6JkibALyazeR",
    "signature": "8ff54221a912dd17049b8d08d77a7ae989aa12bfe5721e2101a1c9328f899d0cc8fdab7f7deb6bd2a224340961dbed46ce1a75209d5063f6b2d86b45dec00601",
    "lastActivityAt": "2024-11-02T20:14:20.982Z",
    "createdAt": "2024-11-02T20:13:04.057Z",
    "updatedAt": "2024-11-02T20:13:04.057Z",
    "cid": "Qmd2ijbAzLVoYHv73gpPpF5yxw33Nuyv7EQ35zRsm3WcBy",
    "pinHash": "Qmd2ijbAzLVoYHv73gpPpF5yxw33Nuyv7EQ35zRsm3WcBy",
    "version": "3",
    "status": "active"
  },...
]

---

Proposal

Proposal information by cid

GET /api/proposal/:proposalId

Get proposal information by its IPFS cid

Headers

Name	Value
Content-Type	application/json
Authorization	Bearer xxxx

Name	Type	Description
proposalId	string	Proposal ID

Response

200

{
    "_id": "66739f2c3694d19bcb3edd59",
    "space": "taiko",
    "networksConfig": {
        "symbol": "TAIKO",
        "decimals": 18,
        "networks": [
            {
                "network": "taiko-mainnet",
                "ss58Format": 167000,
                "assets": [
                    {
                        "symbol": "TAIKO",
                        "decimals": 18,
                        "votingThreshold": "1000000000000000000",
                        "multiplier": 1,
                        "type": "erc20",
                        "contract": "0xa9d23408b9ba935c230493c40c73824df71a0975"
                    }
                ]
            }
        ],
        "strategies": [
            "balance-of"
        ],
        "version": "4"
    },
    "postUid": "44",
    "title": "Top word battle",
    "content": "Gentleman (and women if any) we are here to choose the top word of the history of mankind, pls vote...",
    "contentType": "markdown",
    "choiceType": "single",
    "choices": [
        "skibidy ",
        "edgemaxxing",
        "gyatt",
        "mewing"
    ],
    "startDate": 1718821800000,
    "endDate": 1750357800000,
    "snapshotHeights": {
        "taiko-mainnet": 82327
    },
    "weightStrategy": [
        "balance-of"
    ],
    "proposer": "0x887014462d81893f716cfb7aa392ba8e20c08dad",
    "proposerNetwork": "taiko-mainnet",
    "banner": null,
    "data": {
        "space": "taiko",
        "networksConfig": {
            "symbol": "TAIKO",
            "decimals": 18,
            "networks": [
                {
                    "network": "taiko-mainnet",
                    "ss58Format": 167000,
                    "assets": [
                        {
                            "symbol": "TAIKO",
                            "decimals": 18,
                            "votingThreshold": "1000000000000000000",
                            "multiplier": 1,
                            "type": "erc20",
                            "contract": "0xa9d23408b9ba935c230493c40c73824df71a0975"
                        }
                    ]
                }
            ],
            "strategies": [
                "balance-of"
            ],
            "version": "4"
        },
        "title": "Top word battle",
        "content": "Gentleman (and women if any) we are here to choose the top word of the history of mankind, pls vote...",
        "contentType": "markdown",
        "choiceType": "single",
        "choices": [
            "skibidy ",
            "edgemaxxing",
            "gyatt",
            "mewing"
        ],
        "startDate": 1718821800000,
        "endDate": 1750357800000,
        "snapshotHeights": {
            "taiko-mainnet": 82327
        },
        "realProposer": null,
        "proposerNetwork": "taiko-mainnet",
        "version": "5",
        "timestamp": 1718853407
    },
    "address": "0x887014462d81893f716cfb7aa392ba8e20c08dad",
    "signature": "0xdbda78d0e33d06bc1c9708b06c85a722252e7fca9aee0930029f14bac3ba68e14f01dcb2a60bced68008399161849cc529ec55f99b58e6ede58f43f2f69bdf781b",
    "lastActivityAt": "2024-10-25T15:00:25.672Z",
    "createdAt": "2024-06-20T03:16:56.485Z",
    "updatedAt": "2024-06-20T03:16:56.485Z",
    "cid": "Qmd2AXFPk2KKfUQeZ4BjoK5uYhuZhcwCpZLPyFVnK8kz2t",
    "pinHash": "Qmd2AXFPk2KKfUQeZ4BjoK5uYhuZhcwCpZLPyFVnK8kz2t",
    "version": "3",
    "status": "active",
    "appendants": [],
    "votesCount": 223,
    "votedWeights": {
        "balanceOf": "1.4707506613345033515329e+22",
        "quadraticBalanceOf": "929193294116002060420"
    },
    "startTime": 1718821800,
    "endTime": 1750357800
}

---

Proposal's comments

GET /api/proposal/:proposalCid/comments

Get proposal comments by its IPFS cid

Route support page_size (default is 10, max is 1000) and page eg ?page=1&page_size=1000

Headers

Name	Value
Content-Type	application/json
Authorization	Bearer xxxx

Name	Type	Description
proposalCid	string	Proposal ID

Response

200

{
    "items": [
        {
            "_id": "6717f94451dfd81674141dde",
            "proposal": "66739f2c3694d19bcb3edd59",
            "content": "I like words",
            "contentType": "markdown",
            "commenterNetwork": "taiko-mainnet",
            "data": {
                "proposalCid": "Qmd2AXFPk2KKfUQeZ4BjoK5uYhuZhcwCpZLPyFVnK8kz2t",
                "content": "I like words",
                "contentType": "markdown",
                "commenterNetwork": "taiko-mainnet",
                "version": "2",
                "timestamp": 1729624373
            },
            "address": "0xde3913b6f469be3085ab69c434e1ce39edaa970e",
            "signature": "0xd53f50cc06376adae669327892ea266a08ddbe84fe14aeddc46f238d7fd0a68a0ba03ac55d601bcd4ed3957be64bfa517894c9e58d7e2c00c6d096ed067069191b",
            "height": 1,
            "createdAt": "2024-10-22T19:13:08.427Z",
            "updatedAt": "2024-10-22T19:13:08.427Z",
            "cid": "QmNk55pNAJmz3gTH8LEKW5fxKE4U7PhxjLewqkEHvNgiE3",
            "pinHash": "QmNk55pNAJmz3gTH8LEKW5fxKE4U7PhxjLewqkEHvNgiE3"
        }
    ],
    "total": 1,
    "page": 1,
    "pageSize": 10
}

---

Proposal's Votes

GET /api/proposal/:proposalCid/votes

Get proposal votes by its IPFS cid

Route support page_size (default is 10, max is 1000) and page eg ?page=1&page_size=1000

Headers

Name	Value
Content-Type	application/json
Authorization	Bearer xxxx

Name	Type	Description
proposalCid	string	Proposal ID

Response

200

{
    "items": [
        {
            "_id": "66739f634686eefad8d6d177",
            "proposal": "66739f2c3694d19bcb3edd59",
            "voter": "0x887014462d81893f716cfb7aa392ba8e20c08dad",
            "voterNetwork": "taiko-mainnet",
            "address": "0x887014462d81893f716cfb7aa392ba8e20c08dad",
            "choices": [
                "skibidy "
            ],
            "cid": "QmRY9YaVfKy5iQqPtYnettMWpYYki63CSg9VrjVRf5z2T6",
            "createdAt": "2024-06-20T03:17:55.108Z",
            "data": {
                "proposalCid": "Qmd2AXFPk2KKfUQeZ4BjoK5uYhuZhcwCpZLPyFVnK8kz2t",
                "choices": [
                    "skibidy "
                ],
                "remark": "skibidy is etherial ",
                "voterNetwork": "taiko-mainnet",
                "version": "4",
                "timestamp": 1718853471
            },
            "delegators": null,
            "pinHash": "QmNSJH7m78omxkkHC4tLcnqGArYAuk1fbBRPtMromUVTcF",
            "remark": "skibidy is etherial ",
            "signature": "0x9daed62a7ea6f214a3321ccbaa2ea5892247b67aba37927ff1520cdbc05a9e855f977ea6e27d7989501b2dd42d30e78db1c4d0ba56a44fc2575b47ce6137bca61b",
            "updatedAt": "2024-06-20T03:17:55.108Z",
            "version": "4",
            "weights": {
                "balanceOf": "85000000000000000000",
                "quadraticBalanceOf": "9219544457292887310",
                "details": [
                    {
                        "symbol": "TAIKO",
                        "decimals": 18,
                        "balance": "85000000000000000000",
                        "multiplier": 1,
                        "votingThreshold": "1000000000000000000"
                    }
                ]
            }
        }...
    ],
    "total": 223,
    "page": 1,
    "pageSize": 10
}

---

Space Votes

GET /api/space/:spaceName/votes

Get space votes

Route support page_size (default is 10, max is 1000) and page eg ?page=1&page_size=1000

Headers

Name	Value
Content-Type	application/json
Authorization	Bearer xxxx

Name	Type	Description
spaceName	string	space ID

Response

200

{
    "items": [
        {
            "_id": "671bb289eb87d5c5b7503a28",
            "proposal": "66739f2c3694d19bcb3edd59",
            "voter": "0xeCaCF5FEF2E6c1F662101FC784d6fEc26Dca5aC9",
            "voterNetwork": "taiko-mainnet",
            "address": "0xeCaCF5FEF2E6c1F662101FC784d6fEc26Dca5aC9",
            "choices": [
                "skibidy "
            ],
            "cid": "QmZYcDqixRYexfNCHG42Q6fXre2UYbPfgu8sxo8xvEU3Rh",
            "createdAt": "2024-10-25T15:00:23.782Z",
            "data": {
                "proposalCid": "Qmd2AXFPk2KKfUQeZ4BjoK5uYhuZhcwCpZLPyFVnK8kz2t",
                "choices": [
                    "skibidy "
                ],
                "remark": "",
                "voterNetwork": "taiko-mainnet",
                "version": "4",
                "timestamp": 1729868410
            },
            "delegators": null,
            "pinHash": "QmZYcDqixRYexfNCHG42Q6fXre2UYbPfgu8sxo8xvEU3Rh",
            "remark": "",
            "signature": "0x6098fc4d5e5ddedaf81604d0a0ea33d37b7bed3dff1c9cc1a4273536eaea9de240db58c0b731c15d21b338efcba282ec870415cfc531b2ab207fec479762805a1b",
            "updatedAt": "2024-10-25T15:00:23.782Z",
            "version": "4",
            "weights": {
                "balanceOf": "31900000000000000013",
                "quadraticBalanceOf": "5648008498577175478",
                "details": [
                    {
                        "symbol": "TAIKO",
                        "decimals": 18,
                        "balance": "31900000000000000013",
                        "multiplier": 1,
                        "votingThreshold": "1000000000000000000"
                    }
                ]
            }
        }
    ],
    "total": 629,
    "page": 1,
    "pageSize": 10
}

---

Space Stats

GET /api/space/:spaceName/stats

Get space most active voters and and richest voters

Headers

Name	Value
Content-Type	application/json
Authorization	Bearer <token>

Name	Type	Description
spaceName	string	space ID

Response

200

{
    "mostActiveVoters": [
        {
            "_id": "0x5f8538bbc30326b0e2738aa547401b404c72653b",
            "voteCount": 8,
            "rank": 1
        },
        {
            "_id": "0x2c485d6392979aae0f542a0cfba45c886d012c1e",
            "voteCount": 8,
            "rank": 1
        }...
    ],
    "richestVotersBySymbol": [
        {
            "_id": {
                "voter": "0xc2f8de2c509c6d9c8430af6925481955f47df022",
                "symbol": "TAIKO",
                "decimals": 18
            },
            "totalBalance": "10782",
            "rank": 1
        },
        {
            "_id": {
                "voter": "0x8be4491ced884d5c6b1667bd4e20b975e079a469",
                "symbol": "TAIKO",
                "decimals": 18
            },
            "totalBalance": "4549.132921367891272415",
            "rank": 2
        }...
    ]
}

---

Vote of the address for the proposal

GET /api/proposal/:proposalCid/votes/:address

Find vote of the address for the proposal

Headers

Name	Value
Content-Type	application/json
Authorization	Bearer <token>

Name	Type	Description
proposalCid	string	Proposal ID
address	string	wallet address

Response

200

{
  "_id": "671bb289eb87d5c5b7503a28",
  "proposal": "66739f2c3694d19bcb3edd59",
  "voter": "0xeCaCF5FEF2E6c1F662101FC784d6fEc26Dca5aC9",
  "voterNetwork": "taiko-mainnet",
  "address": "0xeCaCF5FEF2E6c1F662101FC784d6fEc26Dca5aC9",
  "choices": [
    "skibidy "
  ],
  "cid": "QmZYcDqixRYexfNCHG42Q6fXre2UYbPfgu8sxo8xvEU3Rh",
  "createdAt": "2024-10-25T15:00:23.782Z",
  "data": {
    "proposalCid": "Qmd2AXFPk2KKfUQeZ4BjoK5uYhuZhcwCpZLPyFVnK8kz2t",
    "choices": [
      "skibidy "
    ],
    "remark": "",
    "voterNetwork": "taiko-mainnet",
    "version": "4",
    "timestamp": 1729868410
  },
  "delegators": null,
  "pinHash": "QmZYcDqixRYexfNCHG42Q6fXre2UYbPfgu8sxo8xvEU3Rh",
  "remark": "",
  "signature": "0x6098fc4d5e5ddedaf81604d0a0ea33d37b7bed3dff1c9cc1a4273536eaea9de240db58c0b731c15d21b338efcba282ec870415cfc531b2ab207fec479762805a1b",
  "updatedAt": "2024-10-25T15:00:23.782Z",
  "version": "4",
  "weights": {
    "balanceOf": "31900000000000000013",
    "quadraticBalanceOf": "5648008498577175478",
    "details": [
      {
        "symbol": "TAIKO",
        "decimals": 18,
        "balance": "31900000000000000013",
        "multiplier": 1,
        "votingThreshold": "1000000000000000000"
      }
    ]
  }
}

---

Vote of the address for the proposal filtered by network

GET /api/proposal/:proposalCid/votes/network/:network/address/:address

Find vote of the address for the proposal (filtered by network)

Headers

Name	Value
Content-Type	application/json
Authorization	Bearer xxxx

Name	Type	Description
proposalCid	string	Proposal ID
network	string	supported network id
address	string	wallet address

Response

200

{
    "_id": "671bb289eb87d5c5b7503a28",
    "proposal": "66739f2c3694d19bcb3edd59",
    "voter": "0xeCaCF5FEF2E6c1F662101FC784d6fEc26Dca5aC9",
    "voterNetwork": "taiko-mainnet",
    "address": "0xeCaCF5FEF2E6c1F662101FC784d6fEc26Dca5aC9",
    "choices": [
        "skibidy "
    ],
    "cid": "QmZYcDqixRYexfNCHG42Q6fXre2UYbPfgu8sxo8xvEU3Rh",
    "createdAt": "2024-10-25T15:00:23.782Z",
    "data": {
        "proposalCid": "Qmd2AXFPk2KKfUQeZ4BjoK5uYhuZhcwCpZLPyFVnK8kz2t",
        "choices": [
            "skibidy "
        ],
        "remark": "",
        "voterNetwork": "taiko-mainnet",
        "version": "4",
        "timestamp": 1729868410
    },
    "delegators": null,
    "pinHash": "QmZYcDqixRYexfNCHG42Q6fXre2UYbPfgu8sxo8xvEU3Rh",
    "remark": "",
    "signature": "0x6098fc4d5e5ddedaf81604d0a0ea33d37b7bed3dff1c9cc1a4273536eaea9de240db58c0b731c15d21b338efcba282ec870415cfc531b2ab207fec479762805a1b",
    "updatedAt": "2024-10-25T15:00:23.782Z",
    "version": "4",
    "weights": {
        "balanceOf": "31900000000000000013",
        "quadraticBalanceOf": "5648008498577175478",
        "details": [
            {
                "symbol": "TAIKO",
                "decimals": 18,
                "balance": "31900000000000000013",
                "multiplier": 1,
                "votingThreshold": "1000000000000000000"
            }
        ]
    }
}

---

Proposal Stats

POST /api/proposal/:proposalCid/stats

Find proposal stats

Headers

Name	Value
Content-Type	application/json
Authorization	Bearer xxxx

Name	Type	Description
proposalCid	string	Proposal ID
network	string	supported network id
address	string	wallet address

Response

200

[
    {
        "choice": "skibidy ",
        "balanceOf": "1.4382820316629550016565e+22",
        "quadraticBalanceOf": "891318260731125209630",
        "votesCount": 217
    },
    {
        "choice": "edgemaxxing",
        "balanceOf": "128000000000000000000",
        "quadraticBalanceOf": "11313708498984760390",
        "votesCount": 1
    },
    {
        "choice": "gyatt",
        "balanceOf": "91804286665322303511",
        "quadraticBalanceOf": "9581455352154092437",
        "votesCount": 1
    },
    {
        "choice": "mewing",
        "balanceOf": "104882010050161195253",
        "quadraticBalanceOf": "16979869533737997963",
        "votesCount": 4
    }
]

---

Voter balance for certain proposal

GET /api/proposal/:proposalCid/voterbalance/:network/:address

Find voter balance for certain proposal

Headers

Name	Value
Content-Type	application/json
Authorization	Bearer xxxx

Name	Type	Description
proposalCid	string	Proposal ID
network	string	supported network id
address	string	wallet address

Response

200

{
    "balanceOf": "186228061096705622100",
    "decimals": 18,
    "symbol": "TAIKO",
    "details": [
        {
            "symbol": "TAIKO",
            "decimals": 18,
            "balance": "186228061096705622100",
            "multiplier": 1,
            "votingThreshold": "1000000000000000000"
        }
    ]
}

---

List proposals

GET /api/:space/proposals

List space proposals

Route support page_size (default is 10, max is 1000) and page eg ?page=1&page_size=1000

Headers

Name	Value
Content-Type	application/json
Authorization	Bearer xxxx

Name	Type	Description
space	string	space id

Response

200

{
    "items": [
        {
            "_id": "66739f2c3694d19bcb3edd59",
            "space": "taiko",
            "networksConfig": {
                "symbol": "TAIKO",
                "decimals": 18,
                "networks": [
                    {
                        "network": "taiko-mainnet",
                        "ss58Format": 167000,
                        "assets": [
                            {
                                "symbol": "TAIKO",
                                "decimals": 18,
                                "votingThreshold": "1000000000000000000",
                                "multiplier": 1,
                                "type": "erc20",
                                "contract": "0xa9d23408b9ba935c230493c40c73824df71a0975"
                            }
                        ]
                    }
                ],
                "strategies": [
                    "balance-of"
                ],
                "version": "4"
            },
            "postUid": "44",
            "title": "Top word battle",
            "content": "Gentleman (and women if any) we are here to choose the top word of the history of mankind, pls vote...",
            "contentType": "markdown",
            "choiceType": "single",
            "choices": [
                "skibidy ",
                "edgemaxxing",
                "gyatt",
                "mewing"
            ],
            "startDate": 1718821800000,
            "endDate": 1750357800000,
            "snapshotHeights": {
                "taiko-mainnet": 82327
            },
            "weightStrategy": [
                "balance-of"
            ],
            "proposer": "0x887014462d81893f716cfb7aa392ba8e20c08dad",
            "proposerNetwork": "taiko-mainnet",
            "banner": null,
            "data": {
                "space": "taiko",
                "networksConfig": {
                    "symbol": "TAIKO",
                    "decimals": 18,
                    "networks": [
                        {
                            "network": "taiko-mainnet",
                            "ss58Format": 167000,
                            "assets": [
                                {
                                    "symbol": "TAIKO",
                                    "decimals": 18,
                                    "votingThreshold": "1000000000000000000",
                                    "multiplier": 1,
                                    "type": "erc20",
                                    "contract": "0xa9d23408b9ba935c230493c40c73824df71a0975"
                                }
                            ]
                        }
                    ],
                    "strategies": [
                        "balance-of"
                    ],
                    "version": "4"
                },
                "title": "Top word battle",
                "content": "Gentleman (and women if any) we are here to choose the top word of the history of mankind, pls vote...",
                "contentType": "markdown",
                "choiceType": "single",
                "choices": [
                    "skibidy ",
                    "edgemaxxing",
                    "gyatt",
                    "mewing"
                ],
                "startDate": 1718821800000,
                "endDate": 1750357800000,
                "snapshotHeights": {
                    "taiko-mainnet": 82327
                },
                "realProposer": null,
                "proposerNetwork": "taiko-mainnet",
                "version": "5",
                "timestamp": 1718853407
            },
            "address": "0x887014462d81893f716cfb7aa392ba8e20c08dad",
            "signature": "0xdbda78d0e33d06bc1c9708b06c85a722252e7fca9aee0930029f14bac3ba68e14f01dcb2a60bced68008399161849cc529ec55f99b58e6ede58f43f2f69bdf781b",
            "lastActivityAt": "2024-10-25T15:00:25.672Z",
            "createdAt": "2024-06-20T03:16:56.485Z",
            "updatedAt": "2024-06-20T03:16:56.485Z",
            "cid": "Qmd2AXFPk2KKfUQeZ4BjoK5uYhuZhcwCpZLPyFVnK8kz2t",
            "pinHash": "Qmd2AXFPk2KKfUQeZ4BjoK5uYhuZhcwCpZLPyFVnK8kz2t",
            "version": "3",
            "status": "active",
            "terminatedOrEndedAt": 1750357800000,
            "startTime": 1718821800,
            "endTime": 1750357800
        },...
    ],
    "total": 21,
    "page": 1,
    "pageSize": 10
}

---

Pending Proposals

GET /api/:space/proposals/pending

List Pending space proposals

Route support page_size (default is 10, max is 1000) and page eg ?page=1&page_size=1000

Headers

Name	Value
Content-Type	application/json
Authorization	Bearer xxxx

Name	Type	Description
name	string	Name of the user
age	number	Age of the user

Response

200

{
    "items": [],
    "total": 0,
    "page": 1,
    "pageSize": 10
}

---

Active Proposals

GET /api/:space/proposals/active

List Active space proposals

Route support page_size (default is 10, max is 1000) and page eg ?page=1&page_size=1000

Headers

Name	Value
Content-Type	application/json
Authorization	Bearer xxxx

Name	Type	Description
space	string	space id

Response

200

{
    "items": [
        {
            "_id": "66739f2c3694d19bcb3edd59",
            "space": "taiko",
            "networksConfig": {
                "symbol": "TAIKO",
                "decimals": 18,
                "networks": [
                    {
                        "network": "taiko-mainnet",
                        "ss58Format": 167000,
                        "assets": [
                            {
                                "symbol": "TAIKO",
                                "decimals": 18,
                                "votingThreshold": "1000000000000000000",
                                "multiplier": 1,
                                "type": "erc20",
                                "contract": "0xa9d23408b9ba935c230493c40c73824df71a0975"
                            }
                        ]
                    }
                ],
                "strategies": [
                    "balance-of"
                ],
                "version": "4"
            },
            "postUid": "44",
            "title": "Top word battle",
            "content": "Gentleman (and women if any) we are here to choose the top word of the history of mankind, pls vote...",
            "contentType": "markdown",
            "choiceType": "single",
            "choices": [
                "skibidy ",
                "edgemaxxing",
                "gyatt",
                "mewing"
            ],
            "startDate": 1718821800000,
            "endDate": 1750357800000,
            "snapshotHeights": {
                "taiko-mainnet": 82327
            },
            "weightStrategy": [
                "balance-of"
            ],
            "proposer": "0x887014462d81893f716cfb7aa392ba8e20c08dad",
            "proposerNetwork": "taiko-mainnet",
            "banner": null,
            "data": {
                "space": "taiko",
                "networksConfig": {
                    "symbol": "TAIKO",
                    "decimals": 18,
                    "networks": [
                        {
                            "network": "taiko-mainnet",
                            "ss58Format": 167000,
                            "assets": [
                                {
                                    "symbol": "TAIKO",
                                    "decimals": 18,
                                    "votingThreshold": "1000000000000000000",
                                    "multiplier": 1,
                                    "type": "erc20",
                                    "contract": "0xa9d23408b9ba935c230493c40c73824df71a0975"
                                }
                            ]
                        }
                    ],
                    "strategies": [
                        "balance-of"
                    ],
                    "version": "4"
                },
                "title": "Top word battle",
                "content": "Gentleman (and women if any) we are here to choose the top word of the history of mankind, pls vote...",
                "contentType": "markdown",
                "choiceType": "single",
                "choices": [
                    "skibidy ",
                    "edgemaxxing",
                    "gyatt",
                    "mewing"
                ],
                "startDate": 1718821800000,
                "endDate": 1750357800000,
                "snapshotHeights": {
                    "taiko-mainnet": 82327
                },
                "realProposer": null,
                "proposerNetwork": "taiko-mainnet",
                "version": "5",
                "timestamp": 1718853407
            },
            "address": "0x887014462d81893f716cfb7aa392ba8e20c08dad",
            "signature": "0xdbda78d0e33d06bc1c9708b06c85a722252e7fca9aee0930029f14bac3ba68e14f01dcb2a60bced68008399161849cc529ec55f99b58e6ede58f43f2f69bdf781b",
            "lastActivityAt": "2024-10-25T15:00:25.672Z",
            "createdAt": "2024-06-20T03:16:56.485Z",
            "updatedAt": "2024-06-20T03:16:56.485Z",
            "cid": "Qmd2AXFPk2KKfUQeZ4BjoK5uYhuZhcwCpZLPyFVnK8kz2t",
            "pinHash": "Qmd2AXFPk2KKfUQeZ4BjoK5uYhuZhcwCpZLPyFVnK8kz2t",
            "version": "3",
            "status": "active",
            "terminatedOrEndedAt": 1750357800000,
            "startTime": 1718821800,
            "endTime": 1750357800
        }
    ],
    "total": 1,
    "page": 1,
    "pageSize": 10
}

---

Closed Proposals

GET /api/:space/proposals/closed

List Closed space proposals

Headers

Name	Value
Content-Type	application/json
Authorization	Bearer <token>

Name	Type	Description
space	string	space id

Response

200

{
    "items": [
        {
            "_id": "6715984130470944d5f196f0",
            "space": "taiko",
            "networksConfig": {
                "symbol": "TAIKO",
                "decimals": 18,
                "networks": [
                    {
                        "network": "taiko-mainnet",
                        "ss58Format": 167000,
                        "assets": [
                            {
                                "symbol": "TAIKO",
                                "decimals": 18,
                                "votingThreshold": "0",
                                "multiplier": 1,
                                "type": "erc20",
                                "contract": "0xA9d23408b9bA935c230493c40C73824Df71A0975"
                            }
                        ]
                    }
                ],
                "strategies": [
                    "balance-of"
                ],
                "version": "4"
            },
            "postUid": "52",
            "title": "What the best taiko DEX",
            "content": "best dex on taiko",
            "contentType": "markdown",
            "choiceType": "single",
            "choices": [
                "Izumi",
                "Bebop",
                "DTX",
                "Ritsu"
            ],
            "startDate": 1729393200000,
            "endDate": 1729738800000,
            "snapshotHeights": {
                "taiko-mainnet": 470739
            },
            "weightStrategy": [
                "balance-of"
            ],
            "proposer": "0x056f760ad49a3b678a9b027ba12fbc15a4d46c7c",
            "proposerNetwork": "taiko-mainnet",
            "banner": null,
            "data": {
                "space": "taiko",
                "networksConfig": {
                    "symbol": "TAIKO",
                    "decimals": 18,
                    "networks": [
                        {
                            "network": "taiko-mainnet",
                            "ss58Format": 167000,
                            "assets": [
                                {
                                    "symbol": "TAIKO",
                                    "decimals": 18,
                                    "votingThreshold": "0",
                                    "multiplier": 1,
                                    "type": "erc20",
                                    "contract": "0xA9d23408b9bA935c230493c40C73824Df71A0975"
                                }
                            ]
                        }
                    ],
                    "strategies": [
                        "balance-of"
                    ],
                    "version": "4"
                },
                "title": "What the best taiko DEX",
                "content": "best dex on taiko",
                "contentType": "markdown",
                "choiceType": "single",
                "choices": [
                    "Izumi",
                    "Bebop",
                    "DTX",
                    "Ritsu"
                ],
                "startDate": 1729393200000,
                "endDate": 1729738800000,
                "snapshotHeights": {
                    "taiko-mainnet": 470739
                },
                "realProposer": null,
                "proposerNetwork": "taiko-mainnet",
                "version": "5",
                "timestamp": 1729468464
            },
            "address": "0x056f760ad49a3b678a9b027ba12fbc15a4d46c7c",
            "signature": "0x6b868501c8e279d206a3a8cefe80df20657acbb6b0b4a541e572546ebf82c01943f20d998af88327427b96ec4527c45664b7f3290f4f37943b110546479546491c",
            "lastActivityAt": "2024-10-20T23:54:41.517Z",
            "createdAt": "2024-10-20T23:54:36.167Z",
            "updatedAt": "2024-10-20T23:54:36.167Z",
            "cid": "QmSnZjWRAhbyZcPx4caNKjVNdRc7wEUp7j72AWGecQmPU1",
            "pinHash": "QmSnZjWRAhbyZcPx4caNKjVNdRc7wEUp7j72AWGecQmPU1",
            "version": "3",
            "status": "closed",
            "terminatedOrEndedAt": 1729738800000,
            "startTime": 1729393200,
            "endTime": 1729738800
        },...
    ],
    "total": 20,
    "page": 1,
    "pageSize": 10
}

---

Account

Joined Spaces

GET /api/account/:address/spaces

Find joined spaces

Headers

Name	Value
Content-Type	application/json
Authorization	Bearer xxxx

Body

Name	Type	Description
address	string	Wallet address to check

Response

200

[
  {
    "_id": "6726a2fc9dd73922d8ba3d13",
    "member": "3fuMzf46n9bb5cbeccUSz6SE1eYEQbLK6JkibALyazeR",
    "space": "mafia",
    "joinedAt": "2024-11-02T22:09:00.970Z",
    "updatedAt": "2024-11-02T22:09:00.970Z"
  }
]

---

Find space members

GET /api/account/spaces/:space/members

Find space members

Headers

Name	Value
Content-Type	application/json
Authorization	Bearer <token>

Name	Type	Description
space	string	space id

Response

200

[
  {
    "_id": "6726a2fc9dd73922d8ba3d13",
    "member": "3fuMzf46n9bb5cbeccUSz6SE1eYEQbLK6JkibALyazeR",
    "space": "mafia",
    "joinedAt": "2024-11-02T22:09:00.970Z",
    "updatedAt": "2024-11-02T22:09:00.970Z"
  }
]

---

Spaces

All Spaces for the specific network

GET /api/spaces-by-network/:network

<Description of the endpoint>

Headers

Name	Value
Content-Type	application/json
Authorization	Bearer xxxx

Name	Type	Description
network	string	supported network id

Response

200

{
    "taiko": {
        "_id": "66576f8f4686eefad8c4c4c3",
        "id": "taiko",
        "address": "0x8d1a108f4b109e874f002814daf056b1d2dac8f2",
        "decimals": 18,
        "description": "taiko",
        "name": "taiko",
        "networks": [
            {
                "network": "taiko-mainnet",
                "ss58Format": 167000,
                "assets": [
                    {
                        "symbol": "TAIKO",
                        "decimals": 18,
                        "votingThreshold": "0",
                        "multiplier": 1,
                        "type": "erc20",
                        "contract": "0xA9d23408b9bA935c230493c40C73824Df71A0975"
                    }
                ]
            }
        ],
        "proposeThreshold": "0",
        "pubkey": "0x8d1a108f4b109e874f002814daf056b1d2dac8f2",
        "spaceIcon": "QmW3oM9Y3SNz3mQ5D2Qu18tY9SoDKd2r8TDkNv8Yfo6h8K",
        "symbol": "TAIKO",
        "version": "4",
        "website": "https://taikoscan.io/token/0xa9d23408b9ba935c230493c40c73824df71a0975",
        "weightStrategy": [
            "balance-of"
        ],
        "verified": true,
        "activeProposalsCount": 1,
        "proposalsCount": 21
    },
    "nothing": {
        "_id": "66914a19d958f7f6da142860",
        "id": "nothing",
        "address": "0x740909a8e52da6dc7d533c69adc8d02499a7b0d1",
        "decimals": 18,
        "description": "Nothing",
        "name": "Nothing",
        "networks": [
            {
                "network": "taiko-mainnet",
                "ss58Format": 167000,
                "assets": [
                    {
                        "symbol": "WETH",
                        "decimals": 18,
                        "votingThreshold": "1000000000000000000",
                        "multiplier": 1,
                        "type": "erc20",
                        "contract": "0xA51894664A773981C6C112C43ce576f315d5b1B6"
                    }
                ]
            }
        ],
        "proposeThreshold": "0",
        "pubkey": "0x740909a8e52da6dc7d533c69adc8d02499a7b0d1",
        "spaceIcon": "QmTysaAgrNmB7eE9P8M2C5Uzv6uogt7XHNNgiu5QGhTSx2",
        "symbol": "WETH",
        "version": "4",
        "weightStrategy": [
            "balance-of"
        ],
        "activeProposalsCount": 0,
        "proposalsCount": 1
    },...
}

---

All Spaces

GET /api/spaces

Get all spaces (route is used for frontend, some spaces are hidden by moderator)

Headers

Name	Value
Content-Type	application/json
Authorization	Bearer xxxx

Response

200

{
    "ethereum-weth": {
        "_id": "6604fa644686eefad8649925",
        "id": "ethereum-weth",
        "decimals": 18,
        "name": "Ethereum-WETH",
        "networks": [
            {
                "network": "ethereum",
                "ss58Format": null,
                "assets": [
                    {
                        "symbol": "WETH",
                        "decimals": 18,
                        "votingThreshold": "10000000000000000",
                        "multiplier": 1,
                        "type": "erc20",
                        "contract": "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2"
                    }
                ]
            }
        ],
        "proposeThreshold": "0",
        "spaceIcon": "QmeeRZ6p5wYsPCeEKQjMFNYEVjTkgt4yoKCFBTWrNdWQCL",
        "symbol": "WETH",
        "version": "4",
        "weightStrategy": [
            "balance-of"
        ],
        "address": "0x23459a89eac054bdac1c13eb5ccb39f42574c26a",
        "pubkey": "0x23459a89eac054bdac1c13eb5ccb39f42574c26a",
        "activeProposalsCount": 0,
        "proposalsCount": 1
    },
    "ethereal-nexus": {
        "_id": "66111f2f4686eefad86d5507",
        "id": "ethereal-nexus",
        "address": "0x227d660c0de72cd2480e0e831701c070e6741b3d",
        "decimals": 18,
        "name": "Ethereal Nexus",
        "networks": [
            {
                "network": "linea",
                "ss58Format": 59144,
                "assets": [
                    {
                        "symbol": "NEX",
                        "decimals": 18,
                        "votingThreshold": "1000000000000000000",
                        "multiplier": 1,
                        "type": "erc20",
                        "contract": "0x7046A49F7c452e206643e678D19f850E63bde25f"
                    }
                ]
            }
        ],
        "proposeThreshold": "0",
        "pubkey": "0x227d660c0de72cd2480e0e831701c070e6741b3d",
        "spaceIcon": "QmYxDXFZqHhw9YPUdqYoZr6vQsm3WEv6ahFugNnGhgcUYz",
        "symbol": "NEX",
        "version": "4",
        "weightStrategy": [
            "balance-of"
        ],
        "activeProposalsCount": 0,
        "proposalsCount": 2
    },...
}

---

All Spaces (without hidden)

GET /api/spaces-without-filter

Get all spaces (no filter applied)

Headers

Name	Value
Content-Type	application/json
Authorization	Bearer xxxx

Response

200

{
    "ethereum-weth": {
        "_id": "6604fa644686eefad8649925",
        "id": "ethereum-weth",
        "decimals": 18,
        "name": "Ethereum-WETH",
        "networks": [
            {
                "network": "ethereum",
                "ss58Format": null,
                "assets": [
                    {
                        "symbol": "WETH",
                        "decimals": 18,
                        "votingThreshold": "10000000000000000",
                        "multiplier": 1,
                        "type": "erc20",
                        "contract": "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2"
                    }
                ]
            }
        ],
        "proposeThreshold": "0",
        "spaceIcon": "QmeeRZ6p5wYsPCeEKQjMFNYEVjTkgt4yoKCFBTWrNdWQCL",
        "symbol": "WETH",
        "version": "4",
        "weightStrategy": [
            "balance-of"
        ],
        "address": "0x23459a89eac054bdac1c13eb5ccb39f42574c26a",
        "pubkey": "0x23459a89eac054bdac1c13eb5ccb39f42574c26a",
        "activeProposalsCount": 0,
        "proposalsCount": 1
    },
    "ethereal-nexus": {
        "_id": "66111f2f4686eefad86d5507",
        "id": "ethereal-nexus",
        "address": "0x227d660c0de72cd2480e0e831701c070e6741b3d",
        "decimals": 18,
        "name": "Ethereal Nexus",
        "networks": [
            {
                "network": "linea",
                "ss58Format": 59144,
                "assets": [
                    {
                        "symbol": "NEX",
                        "decimals": 18,
                        "votingThreshold": "1000000000000000000",
                        "multiplier": 1,
                        "type": "erc20",
                        "contract": "0x7046A49F7c452e206643e678D19f850E63bde25f"
                    }
                ]
            }
        ],
        "proposeThreshold": "0",
        "pubkey": "0x227d660c0de72cd2480e0e831701c070e6741b3d",
        "spaceIcon": "QmYxDXFZqHhw9YPUdqYoZr6vQsm3WEv6ahFugNnGhgcUYz",
        "symbol": "NEX",
        "version": "4",
        "weightStrategy": [
            "balance-of"
        ],
        "activeProposalsCount": 0,
        "proposalsCount": 2
    },...
}

---

Find spaces created by certain owner

GET /api/spaces/space/:address

Find all spaces created by certain owner address

Headers

Name	Value
Content-Type	application/json
Authorization	Bearer xxxx

Name	Type	Description
address	string	Wallet address to check

Response

200

{
    "ethereum-weth": {
        "_id": "6604fa644686eefad8649925",
        "id": "ethereum-weth",
        "decimals": 18,
        "name": "Ethereum-WETH",
        "networks": [
            {
                "network": "ethereum",
                "ss58Format": null,
                "assets": [
                    {
                        "symbol": "WETH",
                        "decimals": 18,
                        "votingThreshold": "10000000000000000",
                        "multiplier": 1,
                        "type": "erc20",
                        "contract": "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2"
                    }
                ]
            }
        ],
        "proposeThreshold": "0",
        "spaceIcon": "QmeeRZ6p5wYsPCeEKQjMFNYEVjTkgt4yoKCFBTWrNdWQCL",
        "symbol": "WETH",
        "version": "4",
        "weightStrategy": [
            "balance-of"
        ],
        "address": "0x23459a89eac054bdac1c13eb5ccb39f42574c26a",
        "pubkey": "0x23459a89eac054bdac1c13eb5ccb39f42574c26a",
        "activeProposalsCount": 0,
        "proposalsCount": 1
    },
    "taikohorse": {
        "_id": "6613bbf84686eefad87791c0",
        "id": "taikohorse",
        "address": "0x23459a89eac054bdac1c13eb5ccb39f42574c26a",
        "decimals": 18,
        "name": "TaikoHorse",
        "networks": [
            {
                "network": "taiko",
                "ss58Format": 167008,
                "assets": [
                    {
                        "symbol": "HORSE.t",
                        "decimals": 18,
                        "votingThreshold": "1000000000000000000",
                        "multiplier": 1,
                        "type": "erc20",
                        "contract": "0xD69d3e64D71844BBDdA51Cd7f23ED3631E9FAC49"
                    }
                ]
            }
        ],
        "proposeThreshold": "0",
        "pubkey": "0x23459a89eac054bdac1c13eb5ccb39f42574c26a",
        "spaceIcon": "QmU52ZxmSiGX24uDPNUGG3URyZr5aQdLpACCiD6tap4Mgc",
        "symbol": "HORSE.t",
        "version": "4",
        "weightStrategy": [
            "balance-of"
        ],
        "verified": false,
        "activeProposalsCount": 0,
        "proposalsCount": 1
    },...
}

---

Space Information

GET /api/spaces/:space

Certain Space details

Headers

Name	Value
Content-Type	application/json
Authorization	Bearer <token>

Name	Type	Description
space	string	space id

Response

200

{
    "_id": "66576f8f4686eefad8c4c4c3",
    "id": "taiko",
    "address": "0x8d1a108f4b109e874f002814daf056b1d2dac8f2",
    "decimals": 18,
    "description": "taiko",
    "name": "taiko",
    "networks": [
        {
            "network": "taiko-mainnet",
            "ss58Format": 167000,
            "assets": [
                {
                    "symbol": "TAIKO",
                    "decimals": 18,
                    "votingThreshold": "0",
                    "multiplier": 1,
                    "type": "erc20",
                    "contract": "0xA9d23408b9bA935c230493c40C73824Df71A0975"
                }
            ]
        }
    ],
    "proposeThreshold": "0",
    "pubkey": "0x8d1a108f4b109e874f002814daf056b1d2dac8f2",
    "spaceIcon": "QmW3oM9Y3SNz3mQ5D2Qu18tY9SoDKd2r8TDkNv8Yfo6h8K",
    "symbol": "TAIKO",
    "version": "4",
    "website": "https://taikoscan.io/token/0xa9d23408b9ba935c230493c40c73824df71a0975",
    "weightStrategy": [
        "balance-of"
    ],
    "verified": true,
    "latestFinalizedHeights": {
        "taiko-mainnet": 574802
    }
}