🏛️DAOs

The /daos path is centered around data tied directly to the DAO. This includes general info and governance, social and treasury data.

Lookup DAOs

Looks up all live DAOs

GET https://api.daohq.co/data/daos/

Looks up all DAOs by a variety of query params, and returns basic DAO data for each.

Default limit is 10.

Query Parameters

Name	Type	Description
id	string[]	The DAO id
name	string[]	The DAO name
category	string[]	The category of the DAO (see /daos/categories)
minTreasury	integer	Must be used in conjunction with maxTreasury
maxTreasury	integer	Must be used in conjunction with minTreasury
tradable	boolean	If the DAO's token is present and live
verified	boolean	If DAOHQ has manually veirfied the DAO and their founders
limit	integer	Defaults to 10

200 Returns array of DAOs

[
  {
    "_id": "6204183eec11c39c6fcd97ad",
    "name": "KlimaDAO",
    "image": "https://daohq-dao-images.s3.us-east-2.amazonaws.com/images/7hlpmj4N_400x400.jpg",
    "category": [
      "62b89bcd44a9b10198fd1187"
    ],
    "mission": "An algorithmic carbon-backed currency 🌳 🌳",
    "website": "https://www.klimadao.finance/",
    "twitter": "https://twitter.com/KlimaDAO",
    "discord": "https://discord.com/invite/KlimaDAO",
    "chain": [
      "62c763bb9f8333d677143391"
    ],
    "token": {
      "_id": "62bdc7c2d0ae3274e4dd48aa",
      "name": "KlimaDAO",
      "symbol": "KLIMA",
      "contractAddress": "0x4e78011ce80ee02d2c3e649fb657e45898257815",
      "decimal": 9,
      "live": true,
      "dao": "6204183eec11c39c6fcd97ad",
      "cmcId": "12873",
      "chain": "62c763bb9f8333d677143391",
      "livePrice": true,
      "chart24h": "https://daohq-dao-images.s3.amazonaws.com/dao-ticker-charts-24h/e6e1b2deec9019652bb54935098436c7826442e03a34940c8b239c7579cbdd62.svg"
    },
    "live": true,
    "createdAt": "2022-02-09T19:38:38.838Z",
    "updatedAt": "2022-05-16T06:51:26.045Z",
    "__v": 0,
    "twitterid": "1400139779480731651",
    "whitepaper": "https://docs.klimadao.finance/",
    "slug": "klimadao",
    "verified": true,
    "description": "KlimaDAO is the center of a new green economy. Built on the energy efficient Polygon network, KlimaDAO uses a stack of technologies to reduce market fragmentation and accelerate the delivery of climate finance to sustainability projects globally.",
    "telegram": "https://t.me/joinchat/Zb06f_mnMosyYTYy",
    "tokenomics": "https://docs.klimadao.finance/tokenomics-and-mechanisms/primer-on-klima",
    "isOtc": true,
    "snapshotName": "klimadao.eth",
    "treasuryAddress": [
      ""
    ]
  }
]

400: Bad Request Permission denied

500: Internal Server Error

Tip: The /daos route can be used as a 'search' by using the name query. Results queried by name are case insensitive which makes searching easy.

Governance data

Returns governance data for a given DAO

GET https://api.daohq.co/data/daos/governance

Returns governance data for a given DAO. Either the DAO's name or id is required.

Query Parameters

Name	Type	Description
	string	The id of DAO.
name	string	The name of the DAO.
limit	integer	Default limit is 10

200: OK Returns an object containing all-time DAO governance data

{
  "_id": "6204183eec11c39c6fcd977f",
  "votes": {
    "count": 64,
    "uniqueVotingAddresses": [
      "0xD04F6A06B57F78456b3cb054ab219A99cdEE66C8",
      "0x3c56394817CF9723540aA9B419642ee9090694A1",
      "0xc23e674877dc505d651579dCF5a0ab61347deBAB",
      "0x4F6976beE5233Fa69375Ef2ED3bc718492656aF2",
      "0x39a22FC8F9794f50B40c20D7D1871E19099358c8",
      "0x86e08435248155F1D9B48Affa1Eb51f89689f2Fe",
      "0x5E642f8C81DE40E7e49b6a2B606dFB94A005bC44",
      "0x61Af81A525462B0117695eab47C28c90d591E482",
      "0xE9BCDe8D4b3129AaE66FC4AFd31cf3B16fF0C609",
      "0xC1aA6c04BAD0A0Dad9dEeA33a3e40999627942CE",
      "0xEBa7E3411960642868091F6E2006C458ec1c87c8"
    ],
    "uniqueAddressesCount": 11
  },
  "proposals": 15
}

Note: This endpoint only returns data for the specified DAO, and does not take array queries.

Treasury data

Returns treasury data for array of DAOs

GET https://api.daohq.co/data/daos/treasury

Returns a snapshot of realtime treasury data for an array of DAOs. Query can be an array of id and / or name. If neither id or name is passed in, the query will return data for all DAOs where the data is present, with a default limit of 10.

Query Parameters

Name	Type	Description
id	string[]	DAO's id
name	string[]	DAO's name
limit	integer	Defaults to 10

200: OK An array objects for each DAO's treasury data

[
  {
    "_id": "6204183eec11c39c6fcd97e3",
    "name": "Decentraland",
    "treasuryData": {
      "lastUpdated": "2023-01-16T14:02:40.089Z",
      "tokens": [
        {
          "token": "ETH",
          "quantity": 0,
          "valueUsd": 0
        },
        {
          "token": "MANA",
          "quantity": 226841074.27432337,
          "valueUsd": 159159533.90033633
        },
        {
          "token": "USDC",
          "quantity": 2749.173095,
          "valueUsd": 2749.0027280477625
        }
      ],
      "valueUsd": 159843720.3214861,
      "percentChange24h": -0.8213357013522549,
      "percentChange30d": -0.8213357013522549,
      "percentChange7d": -0.8213357013522549
    }
  }
]

400: Bad Request

500: Internal Server Error

{
    // Response
}

Ratings

Returns

GET https://api.daohq.co/data/daos/ratings

In partnership with PrimeDAO, we use their API to offer built-in detailed ratings on various DAOs. Each DAO is rated on various factors, ranging from documentation to community and team.

Query can be an array of id and / or name. If neither id or name is passed in, the query will return data for all DAOs where the data is present, with a default limit of 10.

Query Parameters

Name	Type	Description
id	string[]	The DAO's id
limit	integer	Defaults to 10
name	string[]	The DAO's name

200: OK

[
  {
    "_id": "6204183eec11c39c6fcd97e3",
    "name": "Decentraland",
    "ratings": {
      "overallRating": 77,
      "fundamentalRating": 77,
      "fundamentals": {
        "governance": 93,
        "team": 70,
        "competitiveMoat": 70,
        "valueProposition": 82,
        "tokenEconomics": 76
      },
      "lastUpdated": "2022-12-31T17:07:32.335Z"
    }
  },
  ...
]

400: Bad Request

{
    // Response
}

500: Internal Server Error

{
    // Response
}

Please note: We are aware of some ongoing issues with Ratings data. We will remove this warning when the error is fixed ✌️

Social data

Returns social snap shots for array of DAOs

GET https://api.daohq.co/data/daos/socials

Returns a snapshot of realtime social data for an array of DAOs. Query can be an array of id and / or name.

If neither id or name is passed in, the query will return data for all DAOs where the data is present, with a default limit of 10.

Query Parameters

Name	Type	Description
id	string[]	DAO id(s)
name	string[]	DAO name(s)
limit	integer	Defaults to 10

200: OK An array of objects for each DAO's social data

[
  {
    "_id": "6204183eec11c39c6fcd97e3",
    "name": "Decentraland",
    "discordData": {
      "activeMembers": null,
      "lastUpdated": "2022-05-24T18:01:22.032Z",
      "totalMembers": null
    },
    "twitterData": {
      "followers": 635369,
      "following": 825,
      "lastUpdated": "2023-01-15T18:05:32.385Z",
      "tweets": 6401,
      "percentChange24h": 0.00173130738889693,
      "percentChange30d": 0.00173130738889693,
      "percentChange7d": 0.00173130738889693
    }
  }
]

400: Bad Request

{
    // Response
}

500: Internal Server Error

{
    // Response
}

Twitter sentiment

Returns a sentiment analysis for array of DAOs

GET https://api.daohq.co/data/daos/twitter-sentiment

Returns a snapshot of our ML-enabled Twitter Sentiment Analysis for an array of DAOs. Query can be an array of id and / or name.

If neither id or name is passed in, the query will return data for all DAOs where the data is present, with a default limit of 10.

Query Parameters

Name	Type	Description
id	string[]	DAO id(s)
name	string[]	DAO name(s)
limit	integer	Defaults to 10

200: OK Array of objects for each DAO's Twitter sentiment

[
  {
    "_id": "6204183eec11c39c6fcd97e3",
    "name": "Decentraland",
    "twitterSentiment": {
      "positive": 0.6469589999999998,
      "neutral": 0.30021200000000003,
      "negative": 0.05282599999999997,
      "lastUpdated": "2023-01-16T01:31:33.861Z"
    }
  }
]

400: Bad Request

{
    // Response
}

500: Internal Server Error

{
    // Response
}

Historic social data

These endpoints return historic time series data for a single DAO

Returns historic time series Twitter data

GET https://api.daohq.co/data/daos/socials/historic-twitter

Returns time series Twitter followers data for a given DAO. Either the DAO's name or id is required.

Data points are updated daily.

Query Parameters

Name	Type	Description
id	string	The DAO's id
name	string	The DAO's name
period	integer	The number of days back in time the query is for. Defaults to 30.

200: OK An array of time series objects

[
  {
    "lastUpdated": "2023-01-15T18:03:38.489Z",
    "_id": "63c440734e08db88533809d0",
    "followers": 265650,
    "dao": "620cd644b9c9c9f0795a6405",
    "following": 84,
    "tweets": 2818
  },
  {
    "lastUpdated": "2023-01-14T18:12:01.630Z",
    "_id": "63c2f0e94e08db88533492f1",
    "followers": 265657,
    "following": 84,
    "tweets": 2818,
    "dao": "620cd644b9c9c9f0795a6405"
  },
  ...
]

400: Bad Request

{
    // Response
}

500: Internal Server Error

{
    // Response
}

Returns historic time series Discord data

GET https://api.daohq.co/data/daos/socials/historic-discord

Returns time series Discord server members data for a given DAO. Either the DAO's name or id is required.

Data points are updated daily.

Query Parameters

Name	Type	Description
id	string	The DAO's id
name	string	The DAO's name
period	integer	The number of days back in time the query is for. Defaults to 30.

200: OK An array of time series objects

[
  {
    "lastUpdated": "2023-01-15T17:43:36.139Z",
    "_id": "63c43e1e4e08db88533801e5",
    "activeMembers": 920,
    "dao": "620cd644b9c9c9f0795a6405",
    "totalMembers": 18575
  },
  {
    "lastUpdated": "2023-01-14T17:53:49.095Z",
    "_id": "63c2ee9d4e08db8853348b41",
    "dao": "620cd644b9c9c9f0795a6405",
    "activeMembers": 930,
    "totalMembers": 18574
  },
  ...
]

400: Bad Request

{
    // Response
}

500: Internal Server Error

{
    // Response
}

Returns historic time series Telegram data

GET https://api.daohq.co/data/daos/socials/historic-telegram

Returns time series Telegram members data for a given DAO. Either the DAO's name or id is required.

Data points are updated daily.

Query Parameters

Name	Type	Description
id	string	The DAO's id
name	string	The DAO's name
period	integer	The number of days back in time the query is for. Defaults to 30.

200: OK An array of time series objects

[
  {
    "recordedAt": "2023-01-15T17:55:46.810Z",
    "_id": "63c43fdd4e08db88533806b3",
    "activeMembers": 1031,
    "totalMembers": 13532,
    "dao": "62c4cd110eb136b9b05fa60b"
  },
  {
    "recordedAt": "2023-01-14T18:04:18.418Z",
    "_id": "63c2f0554e08db8853348fdc",
    "activeMembers": 975,
    "totalMembers": 13557,
    "dao": "62c4cd110eb136b9b05fa60b"
  },
  ...
]

400: Bad Request

{
    // Response
}

500: Internal Server Error

{
    // Response
}

Historic Twitter Sentiment

Returns historic time series Twitter Sentiment data

GET

Returns time series data from our ML-enabled Twitter Sentiment for a given DAO. Either the DAO's name or id is required.

Data points are updated daily.

Query Parameters

Name	Type	Description
id	string	The DAO's id
name	string	The DAO's name
period	integer	The number of days back in time the query is for. Defaults to 30.

200: OK

[
  {
    "recordedAt": "2023-01-15T00:02:11.151Z",
    "dao": "620cd644b9c9c9f0795a6405",
    "_id": "634c9bd9326074552ee311a4",
    "sentiment": {
      "positive": 0.5273870000000002,
      "neutral": 0.41622600000000015,
      "negative": 0.05639499999999997
    }
  },
  {
    "recordedAt": "2023-01-14T00:01:35.202Z",
    "_id": "634b4a33056adf6f6934b640",
    "dao": "620cd644b9c9c9f0795a6405",
    "sentiment": {
      "positive": 0.5273870000000002,
      "neutral": 0.41622600000000015,
      "negative": 0.05639499999999997
    }
  },
  ...
]

400: Bad Request

{
    // Response
}

500: Internal Server Error

{
    // Response
}