CDR #059: Souq | GRAIL and GNS Price Feed

21 August, 2023


Protocol: Souq

Integration: Souq will use DIA oracles to deliver the spot prices of the underlying assets in their bonding curve.



Following assets will be included in the Oracle:

Asset Ticker Asset Blockchain Asset Address Asset Markets Overview Comments
GRAIL Arbitrum 0x3d9907F9a368ad0a51Be60f7Da3b97cf940982D8 GRAIL Asset Information
GNS Arbitrum 0x18c11FD286C5EC11c3b683Caa813B77f5163A122 GNS Asset Information


  • Volume Weighted Average Price with Interquartile Range (VWAPIR) will be used to calculate the price for the assets. Learn more about it here.
  • .5% deviation threshold for updates trigger will be applied
  • 120s trades aggregation window size will be applied
  • 24h update frequency will be applied for all assets


Delivery Method Oracle on Arbitrum
Is testnet deployment required? No
1 Like

Thank you for requesting a data feed via DIA CDR. We confirm the CDR specifications were requested correctly. Find the oracle information below:


The oracle is deployed and can be accessed here.

You can query for assets by calling the read function getValue() with parameters such as “GNS/USD”. It will return two values:

  1. The price of the asset queried with 8 decimals
  2. The unix timestamp of the last update

You can see Solidity and Vyper code integration examples here or use a dedicated DIA oracles integration library described in detail here.


Each deployed oracle has a separate gas wallet which is the only entity allowed to update oracle values based on selected parameters. To find out more information on how it works, visit the following link.

Please make sure to top up the gas wallet, as we only put in some gas to deploy and start the oracle.

Gas Wallet address: 0x7cf618e3bf42554c6907583aac64250cb92d096e


You can view the markets included for each feed by pressing on a link to DIA App in the deployed assets list:

  1. Arbitrum-0x3d9907F9a368ad0a51Be60f7Da3b97cf940982D8
  2. Arbitrum-0x18c11FD286C5EC11c3b683Caa813B77f5163A122

Note: DIA uses Blockchain-Address querying formatting to ensure asset selection precision (token symbols might duplicate)

You can also query current asset prices and find other market information on the asset by using the DIA API as described here.

1 Like

Please add USDC.e to the above oracle. Contract address on arbitrum is 0xFF970A61A04b1cA14834A43f5dE4533eBDDB5CC8 (Arbitrum: USDC Token | Address 0xff970a61a04b1ca14834a43f5de4533ebddb5cc8 | Arbiscan)

Hey @Ken the asset USDC.e has been added. It can be queried using “USDC.e/USD” as query parameter.