GraphQL

As part of our migration to DIA’s next-generation oracle infrastructure, Lumina, the hosted DIA GraphQL API is being deprecated and will be discontinued on 20 December 2026. This affects the GraphQL endpoint at https://api.diadata.org/graphql.If your protocol relies on this, please email support@diadata.org and confirm that you are using it. We will provide you with a migration path so you can continue accessing the same data through Lumina without interruption. Integrations that don’t reach out may lose access after the deprecation date.

You can use the following link to send GraphQL requests: https://api.diadata.org/graphql/query Also you can use a dedicated front-end to try out queries: https://api.diadata.org/graphql/ Currently only tokens price feed data is available on GraphQL. Example of schema that can be used for quoting data:

query  {
     GetFeed(
      Filter: "mair",
      BlockSizeSeconds: 480,
      BlockShiftSeconds: 480,
      StartTime: 1690449575,
      EndTime: 1690535975,
      FeedSelection: [
        {
          Address: "0x6B175474E89094C44Da98b954EedeAC495271d0F",
          Blockchain:"Ethereum",
          Exchangepairs:[],
        },
      ],
    )
  {
    Name
    Time
    Value
    Pools
    Pairs
  }
}

The schema will return the moving average price of ETH calculated every 5min (300 sec) by counting 2min trade blocks.

Query parameters rundown

Parameter	Description
`filter`	Select trades processing methodology (e.g. `VWAP`, `MAIR`, find out all available filters here)
`BlockSizeSeconds`	Determine the window for trades inclusion in seconds (e.g. `120` will include all trades into price calculation that happened during the last 2 minutes)
`BlockShiftSeconds`	Determine the frequency of price updates in seconds during the selected timeframe (e.g. `600` will return price for every 5min during the selected period)
`StartTime`	The start time of the preferred period for price calculation in timestamp format (e.g. `1655084380` will start calculating price from 13.06.2022 01:39:40 GMT time)
`EndTime`	The end time of the preferred period for price calculation in timestamp format (e.g. `1655090649` will calculate price until 13.06.2022 03:24:09 GMT time)
`FeedSelection`	This is the main module of the query which is responsible for parametrizing asset(s) for which the price data should be retrieved. Available parameters for `FeedSelection` are described in detail below.

`FeedSelection` filtering options

There are a number of ways to filter out exchanges with DIA’s GraphQL endpoints. First of all, you should define the desired asset. DIA uses blockchain-address asset identification methodology. You can search for available assets and find out blockchain/address information in the DIA APP asset explorer. Here’s an example how to define FeedSelection query to return a price for a given range with all sources included:

FeedSelection: [
        {
          Address: "0x6B175474E89094C44Da98b954EedeAC495271d0F",
          Blockchain:"Ethereum",
          Exchangepairs:[],
        },
      ]

There are number of ways to filter desired sources from the entire sources library for a given asset. We’ll go over examples of these filters. To select specific exchanges you can use the following format:

FeedSelection: [
        {
          Address: "0x6B175474E89094C44Da98b954EedeAC495271d0F",
          Blockchain:"Ethereum",
          Exchangepairs:[{Exchange:"CoinBase"},{Exchange:"UniswapV3"}],
        },
      ]

It is also possible to select specific pairs from a given exchange. The query would look as follows:

FeedSelection: [
        {
          Address: "0x6B175474E89094C44Da98b954EedeAC495271d0F",
          Blockchain:"Ethereum",
          Exchangepairs:[
            {
              Exchange: "CoinBase",
              Pairs:["DAI-USD"],
            },
            {
              Exchange: "UniswapV3",
              Pairs:["0x60594a405d53811d3BC4766596EFD80fd545A270","0x6f48ECa74B38d2936B02ab603FF4e36A6C0E3A77"],
            },
       ]

Another filtering option is to include sources based on available liquidity in the pool. For example if you select a liquidity threshold of

5 000 000, the response will calculate the price of an asset only by including liquidity pools from DEXes which have higher than

5 000 000 liquidity. The query looks as follows:

FeedSelection: [
          {
          Address: "0x2260FAC5E5542a773Aa44fBCfeDf7C193bc2C599",
          Blockchain:"Ethereum",
          LiquidityThreshold:5000000.0
          Exchangepairs: [],
          },
       ]

It is also possible to merge pairs selection with LiquidityThreshold, which would result in such query:

FeedSelection: [
        {
          Address: "0x2260FAC5E5542a773Aa44fBCfeDf7C193bc2C599",
          Blockchain:"Ethereum",
          Exchangepairs:[
            {
              Exchange: "CoinBase",
              Pairs:["DAI-USD"],
            },
          ]
        },
        {
          Address: "0x2260FAC5E5542a773Aa44fBCfeDf7C193bc2C599",
          Blockchain:"Ethereum",
          LiquidityThreshold:5000000.0
          Exchangepairs: [],
        },
      ],

One more option is to use two different assets to calculate one unified price. It might be useful for cross-chain assets, e.g. DAI on ETH mainnet & DAI on Arbitrum One. The query which can be used for such cases would look as follows:

FeedSelection: [
        {
          Address: "0x2260FAC5E5542a773Aa44fBCfeDf7C193bc2C599",
          Blockchain:"Ethereum",
          Exchangepairs:[]
        },
        {
          Address: "0xda10009cbd5d07dd0cecc66161fc93d7c9000da1",
          Blockchain:"Arbitrum",
          Exchangepairs:[]
        },
      ],

Response fields

In the table below you can find the description of response fields:

Field	Description
Time	Time at which the value was generated
Value	Price of an asset at a give time
Pools	Pools which had a trade during the block time period and were involved in the price calculation
Pairs	CEX pairs which had a trade during the block time period and were involved in the price calculation
Blockchain	Blockchain of an asset
Address	Address of an asset

Token Prices

RWA Prices

Query parameters rundown

`FeedSelection` filtering options

Response fields

​Query parameters rundown

​FeedSelection filtering options

​Response fields

Query parameters rundown

`FeedSelection` filtering options

Response fields