Asset Integration

List or accept syrupUSDC & syrupUSDT as collateral or liquidity in your protocol.

syrupUSDC and syrupUSDT are ERC-4626 vault tokens on Ethereum mainnet. This page covers token addresses and three methods for obtaining pricing data.

Token addresses

Token

Address

syrupUSDC

0x80ac24aA929eaF5013f6436cdA2a7ba190f5Cc0b

syrupUSDT

0x356b8d89c1e1239cbbb9de4815c39a1474d5ba7d

Pricing

Option 1: Smart contract (ERC-4626)

syrupUSDC and syrupUSDT use the ERC-4626 tokenized vault standard. You can query the token price directly from the contract using two functions:

convertToAssets(uint256 shares_) - Returns the amount of underlying assets (USDC/USDT) that would be received for a given number of shares. Use this for display purposes and general price calculations.
convertToExitAssets(uint256 shares_) - Returns the amount of underlying assets accounting for any unrealized losses in the pool. Use this when calculating actual redemption values.

Both tokens use 6 decimals. To get the price per token, call either function with 1000000 (1 share):

uint256 pricePerShare = ISyrupToken(syrupUSDC).convertToAssets(1000000);

const syrupUSDC = new ethers.Contract(
  "0x80ac24aA929eaF5013f6436cdA2a7ba190f5Cc0b",
  ["function convertToAssets(uint256) view returns (uint256)"],
  provider
);
const price = await syrupUSDC.convertToAssets(1000000n); // 1 share

import { createPublicClient, http } from 'viem';
import { mainnet } from 'viem/chains';

const client = createPublicClient({
  chain: mainnet,
  transport: http()
});

const price = await client.readContract({
  address: '0x80ac24aA929eaF5013f6436cdA2a7ba190f5Cc0b',
  abi: [{ inputs: [{ type: 'uint256' }], name: 'convertToAssets', outputs: [{ type: 'uint256' }], stateMutability: 'view', type: 'function' }],
  functionName: 'convertToAssets',
  args: [1000000n]
});

# web3.py
from web3 import Web3

w3 = Web3(Web3.HTTPProvider("https://eth-mainnet.g.alchemy.com/v2/YOUR_KEY"))
abi = [{"inputs":[{"type":"uint256"}],"name":"convertToAssets","outputs":[{"type":"uint256"}],"stateMutability":"view","type":"function"}]
contract = w3.eth.contract(address="0x80ac24aA929eaF5013f6436cdA2a7ba190f5Cc0b", abi=abi)
price = contract.functions.convertToAssets(1000000).call()

Option 2: Pyth Oracle

Pyth Network provides low-latency, high-fidelity price feeds for syrupUSDC and syrupUSDT. Pyth calculates pricing using the smart contract ERC-4626 functions.

Feed IDs

Token

Price Feed ID

syrupUSDC/USDC

0x2ad31d1c4a85fbf2156ce57fab4104124c5ef76a6386375ecfc8da1ed5ce1486

syrupUSDT/USDT

0x7e10170c23d7df62d301b2ade26854200ee584f3f3b84cb2e5195adf35c5b97f

Contract addresses

Network

Pyth Contract

Ethereum

0x4305FB66699C3B2702D4d05CF36551390A4c69C6

Sepolia Testnet

0xDd24F84d36BF92C65F92307595335bdFab5Bbd21

Get price from Pyth

Offchain: Fetch price from Pyth Hermes API

bash

# Get latest syrupUSDC price
curl "https://hermes.pyth.network/v2/updates/price/latest?ids[]=0x2ad31d1c4a85fbf2156ce57fab4104124c5ef76a6386375ecfc8da1ed5ce1486"

javascript

const feedId = "0x2ad31d1c4a85fbf2156ce57fab4104124c5ef76a6386375ecfc8da1ed5ce1486";
const response = await fetch(
  `https://hermes.pyth.network/v2/updates/price/latest?ids[]=${feedId}`
);
const data = await response.json();
const priceData = data.parsed[0].price;
const price = Number(priceData.price) * Math.pow(10, priceData.expo);

Onchain: Read price from Pyth contract

import "@pythnetwork/pyth-sdk-solidity/IPyth.sol";
import "@pythnetwork/pyth-sdk-solidity/PythStructs.sol";

contract MyContract {
    IPyth pyth = IPyth(0x4305FB66699C3B2702D4d05CF36551390A4c69C6);
    bytes32 constant SYRUP_USDC_FEED = 0x2ad31d1c4a85fbf2156ce57fab4104124c5ef76a6386375ecfc8da1ed5ce1486;

    function getSyrupUSDCPrice(bytes[] calldata priceUpdateData) public payable returns (int64) {
        uint fee = pyth.getUpdateFee(priceUpdateData);
        pyth.updatePriceFeeds{value: fee}(priceUpdateData);
        PythStructs.Price memory price = pyth.getPrice(SYRUP_USDC_FEED);
        return price.price;
    }
}

See Pyth documentation for complete integration guides.

Option 3: CoinGecko / CoinMarketCap APIs

CoinGecko and CoinMarketCap track syrupUSDC and syrupUSDT prices via DEX pool data. These prices can fluctuate with onchain swaps, so we recommend Options 1 & 2.

Which price to use

Use case

Recommended method

DeFi protocols requiring oracle feeds

Option 1 (ERC-4626 functions) or Option 2 (Pyth)

Frontend display / portfolios

Option 1 (ERC-4626 functions) or Option 2 (Pyth)

Smart contract integrations

Option 1 (ERC-4626 functions)

Resources & contact

Partnerships & queries: [email protected]
Pyth Price Feeds
CoinGecko API
CoinMarketCap API

PreviousEthereum Mainnet NextFrontend Integration

Last updated 1 day ago

Was this helpful?

hashtagToken addresses

hashtagPricing

hashtagOption 1: Smart contract (ERC-4626)

hashtagOption 2: Pyth Oracle

hashtagOption 3: CoinGecko / CoinMarketCap APIs

hashtagWhich price to use

hashtagResources & contact