Skip to main content

Documentation Index

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

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

​
Price Oracle API

The PriceOracle contract provides a simple interface for querying on-chain asset prices by ticker symbol.

​
Contract Interface

interface IPriceOracle {
    function getTokenPrice(string calldata ticker) external view returns (uint256 priceUsd18);
    function getTokenPrices(string[] calldata tickers) external view returns (uint256[] memory);
    function resolveToken(string calldata ticker) external view returns (address);
}

​
Functions

​
getTokenPrice(string ticker)

Returns the current USD price of a single asset in 18-decimal precision. Parameters:
  • ticker — Asset symbol (e.g., "NVDA", "AAPL", "ETH")
Returns:
  • uint256 — Price in USD with 18 decimals (e.g., 192000000000000000000 = $192.00)
Reverts:
  • TokenNotFound(ticker) if the ticker doesn’t resolve to a known token
  • PriceNotSet(ticker) if the token exists but has no price data
Example: 
const price = await oracle.getTokenPrice("NVDA");
// 192000000000000000000 → $192.00

​
getTokenPrices(string[] tickers)

Batch query for multiple asset prices. More gas-efficient than individual calls. Parameters:
  • tickers — Array of ticker symbols
Returns:
  • uint256[] — Array of prices in the same order as input
Example: 
const prices = await oracle.getTokenPrices(["AAPL", "MSFT", "TSLA"]);
// [232..., 420..., 250...]

​
resolveToken(string ticker)

Resolves a ticker symbol to its on-chain token address. Useful for building transactions that reference tokens directly. Parameters:
  • ticker — Asset symbol
Returns:
  • address — The ERC-20 token address on Robinhood L2

​
Ticker Resolution

The oracle accepts both raw and prefixed tickers:
InputResolved To
"NVDA"tiltNVDA token address
"tiltNVDA"tiltNVDA token address
"AAPL"tiltAAPL token address
"tiltAAPL"tiltAAPL token address
Internally, the oracle first checks StockTokenFactory.tokenBySymbol(ticker). If not found, it tries tokenBySymbol("tilt" + ticker).

​
Price Freshness

Prices are updated by the backend oracle service at regular intervals (approximately every few minutes). The TokenRouter stores the latest price for each token. Prices reflect aggregated data from multiple sources (Yahoo Finance, Financial Modeling Prep, Alpha Vantage).
On testnet, prices are updated by a centralized reporter. On mainnet, prices will be sourced from decentralized oracle networks with additional freshness guarantees.

​
Usage in Smart Contracts

import {IPriceOracle} from "./interfaces/IPriceOracle.sol";

contract MyStrategy {
    IPriceOracle public oracle;

    function checkPrice() external view returns (uint256) {
        return oracle.getTokenPrice("NVDA");
    }

    function isUndervalued(string calldata ticker, uint256 threshold) external view returns (bool) {
        uint256 price = oracle.getTokenPrice(ticker);
        return price < threshold;
    }
}