💹Tokens

The /tokens path is centered around data tied directly to the DAO's token. This includes financial, token holders and DEX data.

Good to know: All the methods shown below are synced to an example Swagger file URL and are kept up to date automatically with changes to the API.

Tokens

Looks up all live Tokens

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

Looks up all Tokens by name or id and returns basic Token data including financial snap shot for each.

Default limit is 10.

Query Parameters

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

200: OK Array of Token objects

[
  {
    "_id": "62bdc7c2d0ae3274e4dd48aa",
    "name": "KlimaDAO",
    "symbol": "KLIMA",
    "contractAddress": "0x4e78011ce80ee02d2c3e649fb657e45898257815",
    "decimal": 9,
    "live": true,
    "dao": "6204183eec11c39c6fcd97ad",
    "cmcId": "12873",
    "chain": "62c763bb9f8333d677143391",
    "financialData": {
      "lastUpdated": "2023-01-16T18:31:00.000Z",
      "marketCap": 0,
      "percentChange1h": -0.01190213,
      "percentChange24h": 0.43807951,
      "percentChange30d": -9.48674842,
      "percentChange60d": -20.16590587,
      "percentChange7d": 10.14020571,
      "percentChanged90d": -47.67333408,
      "price": 1.712211775939304,
      "volume24h": 13727.02589389,
      "volumeChange24h": -66.4179,
      "totalSupply": 1697205,
      "circulatingSupply": 0,
      "fullyDilutedMarketCap": 2905974.39,
      "maxSupply": null,
      "tvl": null
    },
    "livePrice": true,
    "chart24h": "https://daohq-dao-images.s3.amazonaws.com/dao-ticker-charts-24h/e6e1b2deec9019652bb54935098436c7826442e03a34940c8b239c7579cbdd62.svg"
  }
]

400: Bad Request

{
    // Response
}

500: Internal Server Error

{
    // Response
}

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

Holders

Returns snapshot of token holder data

GET https://api.daohq.co/data/tokens/holders

Returns a snapshot of realtime token holder data. 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 Tokens where the data is present, with a default limit of 10.

Query Parameters

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

200: OK Array of Token holder objects

[
  {
    "_id": "62bdc7c2d0ae3274e4dd48aa",
    "name": "KlimaDAO",
    "holdersData": {
      "totalHolders": 23085,
      "top100Share": 100,
      "topHolders": [
        {
          "address": "0x25d28a24ceb6f81015bb0b2007d795acac411b4d",
          "amount": 6147058.41,
          "amountUsd": 10122818.88,
          "share": 77.31
        },
        ...
      ]
    },
    ...
  ]

400: Bad Request

{
    // Response
}

500: Internal Server Error

{
    // Response
}

DEX data

Returns snapshot of token DEX data

GET https://api.daohq.co/data/tokens/dex-data

Returns a snapshot of realtime token DEX data. 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 Tokens where the data is present, with a default limit of 10.

Query Parameters

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

200: OK Array of token DEX data objects

[
  {
    "_id": "623fc39617f99988906aa2a0",
    "name": "0x",
    "dexData": {
      "totalTrades": 297758,
      "totalMakers": 14058,
      "totalTakers": 36806,
      "inflow": {
        "amountUsd24h": 56194.218197018694,
        "amountUsd7d": 467285.66539078485,
        "amountUsd30d": 782952.5911132256,
        "amountUsdMax": 236045995.36811453
      },
      "outflow": {
        "amountUsd24h": 66246.55817908804,
        "amountUsd7d": 439387.67939752375,
        "amountUsd30d": 716224.5950086854,
        "amountUsdMax": 243184315.8183054
      },
      "totalDexs": 34,
      "price": 0.2040616124868393,
      "lastUpdated": "2023-01-16T18:24:46.541Z"
    }
  },
  ...
]

400: Bad Request

{
    // Response
}

500: Internal Server Error

{
    // Response
}

Historic data

These endpoints return historic time series data for a single Token.

Returns historic time series financial data

GET https://api.daohq.co/data/tokens/historic-financial

Returns time series financial data for a given Token. Either the Token's name or id is required.

Data points are updated every 5 minutes.

Query Parameters

Name	Type	Description
id	string	The Token's id
interval*	string	Options: 5m, 30m, 1h, 4h, 1d, 7d
start*	date	The data starting point, as far back as 01 Feb 2022.
name	string	The Token's name

200: OK

{
  "name": "1inch Network",
  "id": "623fb4705d68f16a7b80d16f",
  "data": [
    {
      "timestamp": "2022-02-01T01:00:00.000Z",
      "quote": {
        "USD": {
          "price": 1.6891067258277033,
          "volume_24h": 52843940.75500819,
          "market_cap": 790712345.6175218,
          "total_supply": 1500000000,
          "circulating_supply": 468124561.65554225,
          "timestamp": "2022-02-01T01:00:00.000Z"
        }
      }
    },
    {
      "timestamp": "2022-02-01T02:00:00.000Z",
      "quote": {
        "USD": {
          "price": 1.6907037753450092,
          "volume_24h": 51955008.16220203,
          "market_cap": 791459963.7227528,
          "total_supply": 1500000000,
          "circulating_supply": 468124561.65554225,
          "timestamp": "2022-02-01T02:00:00.000Z"
        }
      }
    },
    ...
  ]
}

400: Bad Request

{
    // Response
}

500: Internal Server Error

{
    // Response
}

Returns details of the latest DEX transactions

GET https://api.daohq.co/data/tokens/historic-dex-trades

Returns the latest DEX transactions as objects for a given Token. Either the Token's id or name is required.

Data is updated hourly and limits to the most recent 100 trades by default.

Query Parameters

Name	Type	Description
id	string	The Token's id
	String
limit	integer	Defaults to 100
name	string	The Token's name

200: OK

[
  {
    "recordedAt": "2022-08-02T15:20:31.000Z",
    "transactionHash": "0x45b5ffc2ce50400b41ba3e1982ea34c6f29e3d75906dcccf73d157b30aaf98be",
    "_id": "62e9435cc5deffa7db51b921",
    "amount": 4775.334877006673,
    "token": "623fb4705d68f16a7b80d16f",
    "amountUsd": 3560.4463813770626,
    "type": "BUY",
    "price": 0.7455909319617936
  },
  {
    "recordedAt": "2022-08-02T15:31:41.000Z",
    "transactionHash": "0x22a44de0d86c351f63067b6b63f061dadf463526fd2ede705752fba9ad059fa6",
    "_id": "62e945b79e3eeb3bf2b5061b",
    "amount": 4648.952462763687,
    "token": "623fb4705d68f16a7b80d16f",
    "amountUsd": 3463.967658654461,
    "type": "BUY",
    "price": 0.7451071368011403
  },
  ...
]

400: Bad Request

{
    // Response
}

500: Internal Server Error

{
    // Response
}