API Documentation

1. Root Endpoint

Endpoint: /

Method: GET

Description: Renders the documentation page.

2. Get Unique Voters

Endpoint: /members/<space>

Method: GET

Description: Fetches unique voters for a given space. Optionally fetches on-chain members and delegates if onchain parameter is provided.

Parameters:

• space (path parameter):
  • Type: string
  • Description: The space ID from which to fetch the unique voters.
• offchain_cursor (query parameter, optional):
  • Type: integer
  • Description: Cursor for paginating off-chain votes.
• onchain_cursor (query parameter, optional):
  • Type: integer
  • Description: Cursor for paginating on-chain members and delegates.
• onchain (query parameter, optional):
  • Type: string
  • Description: The slug of the on-chain organization to fetch members and delegates from.
• refresh (query parameter, optional):
  • Type: boolean
  • Description: If set to true, forces a refresh of the cached data.

Response:

200 OK

Content-Type: application/json

Description: Returns the list of unique voters, and optionally on-chain members and delegates, with pagination cursors.

{
  "Members": {
    "@context": "http://daostar.org/schemas",
    "type": "DAO",
    "name": "Example DAO",
    "members": {
      "offchain": {
        "members": [
          {"id": "0x123...", "type": "EthereumAddress"},
          {"id": "0x456...", "type": "EthereumAddress"}
        ],
        "offchain_cursor_str": 123456789
      },
      "onchain": {
        "members": [
          {"id": "0xabc...", "role": "member", "type": "EthereumAddress"},
          {"id": "0xdef...", "role": "delegate", "type": "EthereumAddress"}
        ],
        "onchain_cursor_str": 987654321
      }
    }
  }
}

400 Bad Request

Content-Type: application/json

Description: Returns an error message if an invalid cursor is provided.

{
  "error": "Invalid offchain cursor format. Cursor must be an integer."
}

3. Is Member Endpoint

Endpoint: /is_member/<space>

Method: GET

Description: Checks if a given address is a member of the specified DAO space.

URL Parameters:

• space (required): The Snapshot space identifier (e.g., arbitrumfoundation.eth).

Query Parameters:

• voter (required): The Ethereum address to check.
• onchain (optional): The on-chain slug for the DAO space (e.g., arbitrum).

Example Request:

Example Response:

{
    "voter": "0xDB6A3e437D6D3F5AC5f7C0D21Ba3F44Fe3A4F3a3",
    "offchain": true,
    "onchain": false,
    "is_member": true
}

Parameter Combinations

1. Basic Request (Fetch off-chain voters only)

URL: /members/ens.eth

Description: Fetches unique off-chain voters for the space "example-space".

2. Request with Off-chain Pagination

URL: /members/ens.eth?offchain_cursor=12345

Description: Fetches unique off-chain voters with pagination, starting after cursor 12345.

3. Request with On-chain Data

URL: /members/ens.eth?onchain=example-slug

Description: Fetches unique off-chain voters and on-chain members/delegates for the specified space and on-chain organization.

4. Request with Both Off-chain and On-chain Pagination

URL: /members/ens.eth?offchain_cursor=12345&onchain_cursor=67890&onchain=example-slug

Description: Fetches unique off-chain voters with pagination and on-chain members/delegates with pagination.

5. Request with Data Refresh

URL: /members/ens.eth?refresh=true

Description: Forces a refresh of cached data for the specified space.

6. Request with Data Refresh

URL: /is_member/arbitrumfoundation.eth?voter=0xDB6A3e437D6D3F5AC5f7C0D21Ba3F44Fe3A4F3a3&onchain=arbitrum

Description:Checks if a voter is a member both on onchain and offchain DAO.