API Endpoints

Endpoints

Chain

Endpoint

EVM Supported Chains

https://evm.dvote.ai/api/

Solana

https://sol.dvote.ai/api/

Bitcoin (BRC20, Ordinals, Runes)

https://btc.dvote.ai/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

Body

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 Key

Last updated 10 months ago

hashtagEndpoints

hashtagChain

hashtagChains Definition

hashtagSupported networks

hashtagHome

hashtagPopular Proposals

hashtagProposal

hashtagProposal information by cid

hashtagProposal's comments

hashtagProposal's Votes

hashtagSpace Votes

hashtagSpace Stats

hashtagVote of the address for the proposal

hashtagVote of the address for the proposal filtered by network

hashtagProposal Stats

hashtagVoter balance for certain proposal

hashtagList proposals

hashtagPending Proposals

hashtagActive Proposals

hashtagClosed Proposals

hashtagAccount

hashtagJoined Spaces

hashtagFind space members

hashtagSpaces

hashtagAll Spaces for the specific network

hashtagAll Spaces

hashtagAll Spaces (without hidden)

hashtagResponse

hashtagFind spaces created by certain owner

hashtagSpace Information

Endpoints

Chain

Chains Definition

Supported networks

Home

Popular Proposals

Proposal

Proposal information by cid

Proposal's comments

Proposal's Votes

Space Votes

Space Stats

Vote of the address for the proposal

Vote of the address for the proposal filtered by network

Proposal Stats

Voter balance for certain proposal

List proposals

Pending Proposals

Active Proposals

Closed Proposals

Account

Joined Spaces

Find space members

Spaces

All Spaces for the specific network

All Spaces

All Spaces (without hidden)

Response

Find spaces created by certain owner

Space Information