Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.ifalabs.com/llms.txt

Use this file to discover all available pages before exploring further.

This page walks you through three ways to fetch a price from the IFÁ Labs oracle. All three work on Base Mainnet and Base Sepolia. Choose the one that fits where you are in your development workflow.
MethodBest ForSetup Required
Remix IDEBeginners, quick prototypingNone — browser-based
BasescanInstant read, no codingNone
ethers.js ScriptFrontend integrations, automationNode.js

​
Method 1: Remix IDE

The fastest way to fetch a price without any local setup.
1

Open Remix IDE

Go to remix.ethereum.org in your browser.
2

Create a new file

In the File Explorer, create a new file called PriceReader.sol and paste the following:
    // SPDX-License-Identifier: MIT
    pragma solidity ^0.8.0;

    interface IIfaPriceFeed {
        struct PriceFeed {
            int256 price;
            int8 decimal;
            uint256 lastUpdateTime;
        }

        function getAssetInfo(bytes32 assetId)
            external
            view
            returns (PriceFeed memory assetInfo, bool exists);
    }

    contract PriceReader {
        // Base Mainnet oracle address
        IIfaPriceFeed public constant ORACLE =
            IIfaPriceFeed(0xA9F17344689C2c2328F94464998db1d3e35B80dC);

        // USDT/USD asset ID
        bytes32 public constant USDT_ASSET_ID =
            0x6ca0cef6107263f3b09a51448617b659278cff744f0e702c24a2f88c91e65a0d;

        function getUSDTPrice()
            external
            view
            returns (
                int256 price,
                int8 decimal,
                uint256 timestamp,
                bool exists
            )
        {
            (IIfaPriceFeed.PriceFeed memory info, bool _exists) =
                ORACLE.getAssetInfo(USDT_ASSET_ID);

            return (info.price, info.decimal, info.lastUpdateTime, _exists);
        }
    }
3

Compile the contract

Open the Solidity Compiler tab. Set the compiler version to 0.8.0 or higher and click Compile PriceReader.sol.
4

Deploy and call

Open the Deploy & Run Transactions tab.
  • Set Environment to Injected Provider - MetaMask
  • Make sure MetaMask is connected to Base Mainnet or Base Sepolia
  • Click Deploy
  • Once deployed, click getUSDTPrice under the deployed contract
You’ll see four return values: price, decimal, timestamp, and exists.
Interpreting the result: 
price:      1000000000000000000  (1e18)
decimal:    -18
timestamp:  1748601234           (Unix timestamp)
exists:     true
Human-readable price = price ÷ 10^(-decimal) = 1e18 ÷ 10^18 = $1.00 For any stablecoin near its peg, expect a value close to 1e18 with decimal = -18.

​
Method 2: Basescan

No coding required. Read directly from the deployed contract via the block explorer.
1

Open the contract on Basescan

2

Find getAssetInfo

Scroll to the getAssetInfo function in the Read Contract tab.
3

Enter an asset ID and query

Paste an asset ID from the table below and click Query.Results appear instantly — no wallet connection needed for read calls.

​
Method 3: ethers.js Script

For developers integrating IFÁ Labs into a frontend, backend, or automated workflow. 
const { ethers } = require("ethers");

const ORACLE_ADDRESS = "0xA9F17344689C2c2328F94464998db1d3e35B80dC"; // Base Mainnet
const RPC_URL = "https://mainnet.base.org";

const ABI = [
  "function getAssetInfo(bytes32 assetId) view returns ((int256 price, int8 decimal, uint256 lastUpdateTime) assetInfo, bool exists)"
];

const ASSET_IDS = {
  "USDT/USD": "0x6ca0cef6107263f3b09a51448617b659278cff744f0e702c24a2f88c91e65a0d",
  "USDC/USD": "0xf989296bde68043d307a2bc0e59de3445defc5f292eb390b80d78162c8a6b13d",
  "CNGN/USD": "0x83a18c73cf75a028a24b79cbedb3b8d8ba363b748a3210ddbcaa95eec3b87b3a",
  "BRZ/USD":  "0xbc60b55b031dce1ee5679098bf2f35d66a94a566124e2b233324d2bafcc6d5b5",
  "ZARP/USD": "0x12373a3b1c4827c84bf6d7b11df100442695d0abfdb7a20d30a41d67d58e75a8"
};

async function getPrice(symbol) {
  const provider = new ethers.JsonRpcProvider(RPC_URL);
  const oracle = new ethers.Contract(ORACLE_ADDRESS, ABI, provider);

  const assetId = ASSET_IDS[symbol];
  const [info, exists] = await oracle.getAssetInfo(assetId);

  if (!exists) {
    throw new Error(`Asset ${symbol} not supported`);
  }

  const humanPrice = Number(info.price) / 10 ** Number(-info.decimal);
  const age = Math.floor(Date.now() / 1000) - Number(info.lastUpdateTime);

  return {
    symbol,
    price: humanPrice.toFixed(6),
    lastUpdated: `${age}s ago`,
    raw: {
      price: info.price.toString(),
      decimal: info.decimal,
      timestamp: info.lastUpdateTime.toString(),
    },
  };
}

// Example usage
getPrice("USDT/USD").then(console.log).catch(console.error);
Example output: 
{
  "symbol": "USDT/USD",
  "price": "1.000124",
  "lastUpdated": "412s ago",
  "raw": {
    "price": "1000124000000000000",
    "decimal": -18,
    "timestamp": "1748600822"
  }
}

​
Common Asset IDs

Use these in any of the three methods above:
AssetAsset ID
USDT/USD0x6ca0cef6107263f3b09a51448617b659278cff744f0e702c24a2f88c91e65a0d
USDC/USD0xf989296bde68043d307a2bc0e59de3445defc5f292eb390b80d78162c8a6b13d
CNGN/USD0x83a18c73cf75a028a24b79cbedb3b8d8ba363b748a3210ddbcaa95eec3b87b3a
BRZ/USD0xbc60b55b031dce1ee5679098bf2f35d66a94a566124e2b233324d2bafcc6d5b5
ETH/USD0x8c3fb07cab369fe230ca4e45d095f796c4c1a30131f1799766d4fec5ee1325c0
ZARP/USD0x12373a3b1c4827c84bf6d7b11df100442695d0abfdb7a20d30a41d67d58e75a8

​
What’s Happening Under the Hood

Every call to getAssetInfo reads directly from an audited smart contract on-chain. There is no API server, no middleware, and no off-chain dependency in the read path. The price you get is exactly what was last pushed by IFÁ Labs’ decentralized relayer network — verifiable by anyone on the blockchain. This also means price reads cost zero gas. View calls on EVM chains are free. The only gas cost in your integration is if you’re writing price data into your own contract’s storage.

​
Next Steps

Verify Price Integrity

Add staleness checks and deviation guards before going to production.

EVM Integration Guide

Build a full production integration into your smart contracts.