Skip to main content

With Solidity

We have implemented a new StdReference interface contract to allow anyone to query data from our Standard Dataset.

To query prices from Band Protocol's oracle, a smart contract should reference Band's StdReference contract, specifically the getReferenceData and getReferenceDatabulk methods.


getReferenceData takes two strings (the base and quote symbol) as the inputs, respectively. It then queries the StdReference contract for the latest rates for those two tokens, and returns a ReferenceData struct, shown below.


  • The base symbol as type string
  • The quote symbol as type string


The base quote pair result as type ReferenceData

struct ReferenceData {
uint256 rate;
uint256 lastUpdatedBase;
uint256 lastUpdatedQuote;

The ReferenceData struct has the following elements:

  • Rate: the exchange rate in terms of base/quote. The value returned is multiplied by 1e18
  • Last updated base: the last time when the base price was updated (since UNIX epoch)
  • Last updated quote: the last time when the quoted price was updated (since UNIX epoch)


For example, if we wanted to query the price of BTC/USD, the demo contract below shows how this can be done.

import interfaces/IStdReference.sol

contract Demo {
IStdReference public ref;

constructor(IStdReference _ref) public {
ref = _ref;

function demo() external view returns (IStdReference.ReferenceData memory) {
return ref.getReferenceData("BTC", "USD");

The result from Demo() would yield:

ReferenceData(23131270000000000000000, 1659588229, 1659589497)

Where the results can be interpreted as:

rate: 23131270000000000000000, // 23131.27 of BTC/USD
lastUpdatedBase: 1659588229, // 2022-08-04 04:43:49
lastUpdatedQuote: 1659589497 // 2022-08-04 05:04:57


The second function, getReferenceDataBulk, takes information as data arrays. For example, if you pass in ['BTC','BTC','ETH'] as base and ['USD','ETH','EUR'] as quote, the ReferenceDatareturned array contains the information regarding the following pairs:



  • An array of base symbols as type string[]
  • An array of quote symbol as type string[]


  • An array of the base quote pair results as type ReferenceData[]

Example Contract

The following smart contract code provides some simple examples of the StdReference contract and the getReferenceData function - these are not meant for production. The IStdReference.sol interface defines ReferenceData structure and the functions available to make the queries.

pragma solidity 0.6.11;
pragma experimental ABIEncoderV2;

interface IStdReference {
/// A structure returned whenever someone requests for standard reference data.
struct ReferenceData {
uint256 rate; // base/quote exchange rate, multiplied by 1e18.
uint256 lastUpdatedBase; // UNIX epoch of the last time when base price gets updated.
uint256 lastUpdatedQuote; // UNIX epoch of the last time when quote price gets updated.

/// Returns the price data for the given base/quote pair. Revert if not available.
function getReferenceData(string memory _base, string memory _quote)
returns (ReferenceData memory);

/// Similar to getReferenceData, but with multiple base/quote pairs at once.
function getReferenceDataBulk(string[] memory _bases, string[] memory _quotes)
returns (ReferenceData[] memory);

contract DemoOracle {
IStdReference ref;

uint256 public price;

constructor(IStdReference _ref) public {
ref = _ref;

function getPrice() external view returns (uint256){
IStdReference.ReferenceData memory data = ref.getReferenceData("BTC","USD");
return data.rate;

function getMultiPrices() external view returns (uint256[] memory){
string[] memory baseSymbols = new string[](2);
baseSymbols[0] = "BTC";
baseSymbols[1] = "BTC";

string[] memory quoteSymbols = new string[](2);
quoteSymbols[0] = "USD";
quoteSymbols[1] = "ETH";
IStdReference.ReferenceData[] memory data = ref.getReferenceDataBulk(baseSymbols,quoteSymbols);

uint256[] memory prices = new uint256[](2);
prices[0] = data[0].rate;
prices[1] = data[1].rate;

return prices;

function savePrice(string memory base, string memory quote) external {
IStdReference.ReferenceData memory data = ref.getReferenceData(base,quote);
price = data.rate;

Available Reference Data Contracts

You can access the StdReference data aggregator contract on the following supported networks