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

[
  {
    "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

[
  {
    "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

[
  {
    "_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

{
    "_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

{
    "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

{
    "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

{
    "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

{
    "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

{
  "_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

{
    "_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

[
    {
        "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

{
    "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

{
    "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

{
    "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

{
    "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

{
    "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

[
  {
    "_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

[
  {
    "_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

Headers

Name

Value

Content-Type

application/json

Authorization

Bearer xxxx

Name

Type

Description

network

string

supported network id

Response

{
    "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

{
    "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

{
    "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

{
    "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

{
    "_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
    }
}

PreviousAPI Keys NextBeraVote.js

Last updated 10 months ago

hashtagEndpoints

hashtagChain

hashtagChains Definition

hashtagHeaders

hashtagResponse

hashtagSupported networks

hashtagHeaders

hashtagResponse

hashtagHome

hashtagPopular Proposals

hashtagHeaders

hashtagResponse

hashtagProposal

hashtagProposal information by cid

hashtagHeaders

hashtagResponse

hashtagProposal's comments

hashtagHeaders

hashtagResponse

hashtagProposal's Votes

hashtagHeaders

hashtagResponse

hashtagSpace Votes

hashtagHeaders

hashtagResponse

hashtagSpace Stats

hashtagHeaders

hashtagResponse

hashtagVote of the address for the proposal

hashtagHeaders

hashtagResponse

hashtagVote of the address for the proposal filtered by network

hashtagHeaders

hashtagResponse

hashtagProposal Stats

hashtagHeaders

hashtagResponse

hashtagVoter balance for certain proposal

hashtagHeaders

hashtagResponse

hashtagList proposals

hashtagHeaders

hashtagResponse

hashtagPending Proposals

hashtagHeaders

hashtagResponse

hashtagActive Proposals

hashtagHeaders

hashtagResponse

hashtagClosed Proposals

hashtagHeaders

hashtagResponse

hashtagAccount

hashtagJoined Spaces

hashtagHeaders

hashtagBody

hashtagResponse

hashtagFind space members

hashtagHeaders

hashtagResponse

hashtagSpaces

hashtagAll Spaces for the specific network

hashtagHeaders

hashtagResponse

hashtagAll Spaces

hashtagHeaders

hashtagResponse

hashtagAll Spaces (without hidden)

hashtagHeaders

hashtagResponse

hashtagFind spaces created by certain owner

hashtagHeaders

hashtagResponse

hashtagSpace Information

hashtagHeaders

hashtagResponse

Endpoints

Chain

Chains Definition

Headers

Response

Supported networks

Headers

Response

Home

Popular Proposals

Headers

Response

Proposal

Proposal information by cid

Headers

Response

Proposal's comments

Headers

Response

Proposal's Votes

Headers

Response

Space Votes

Headers

Response

Space Stats

Headers

Response

Vote of the address for the proposal

Headers

Response

Vote of the address for the proposal filtered by network

Headers

Response

Proposal Stats

Headers

Response

Voter balance for certain proposal

Headers

Response

List proposals

Headers

Response

Pending Proposals

Headers

Response

Active Proposals

Headers

Response

Closed Proposals

Headers

Response

Account

Joined Spaces

Headers

Body

Response

Find space members

Headers

Response

Spaces

All Spaces for the specific network

Headers

Response

All Spaces

Headers

Response

All Spaces (without hidden)

Headers

Response

Find spaces created by certain owner

Headers

Response

Space Information

Headers

Response