Yields

Supply rate, borrow rate, utilization, and oracle price for a lending market.

Yields is a GraphQL endpoint, separate from the REST resources above. It returns lending and borrowing market history: rates, utilization, size, and the oracle price used to value the loan asset.

Request#

POST the query as JSON to https://api.syncrone.fi/api/yields/graphql. Use the same x-api-Key header as the rest of the API. Filter with market_id and a created_at window.

Query

query GetMetrics {
  metrics(
    limit: 100
    where: {
      created_at: { _gt: "2025-09-12", _lt: "2025-09-15" }
      market_id: { _eq: "euler-ethereum-0xe415952f5ee06f8a548f4f7d5be18fbf144b4e4d" }
    }
  ) {
    block
    id
    borrow_apy
    supply_apy
    utilization
    nefture_price
    oracle_price
    total_borrowed
    total_borrowed_usd
    total_supplied
    total_supplied_usd
    market_id
    created_at
    oracle_last_update
    timestamp
    market {
      chain
      market_address
      collateral_asset
      collateral_asset_symbol
      collateral_asset_decimals
      loan_asset
      loan_asset_symbol
      loan_asset_decimals
      oracle
    }
  }
}

Example

curl -X POST "https://api.syncrone.fi/api/yields/graphql" \
  -H "x-api-Key: $SYNCRONE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"{ metrics(limit: 100) { market_id supply_apy borrow_apy utilization timestamp } }"}'

Metric fields#

Each metrics row is one observation of a market. Rates are fractions (0.05 is 5%). Amounts are in token units unless the field ends in _usd.

block	Chain block of the observation
id	Row identifier
market_id	Stable id, usually protocol-chain-address
timestamp	Observation time
created_at	When the row was written
supply_apy	Supply APY
borrow_apy	Borrow APY
utilization	Borrowed amount divided by supplied amount
total_supplied	Supplied token units
total_supplied_usd	Supplied value in USD
total_borrowed	Borrowed token units
total_borrowed_usd	Borrowed value in USD
oracle_price	Loan asset price from the market oracle
nefture_price	Loan asset price from the Syncrone price stack
oracle_last_update	Last time the market oracle updated

Market object#

market is the lending market the metric belongs to. Collateral and loan fields describe the two assets.

chain	Network name
market_address	Market or pool contract
oracle	Oracle contract
collateral_asset	Collateral token address
collateral_asset_symbol	Collateral symbol
collateral_asset_decimals	Collateral decimals
loan_asset	Loan token address
loan_asset_symbol	Loan symbol
loan_asset_decimals	Loan decimals

← PreviousModels Next →Overview