Spectra yields
Spectra splits interest-bearing tokens into a Principal Token (PT), which trades at a discount and locks a fixed rate when held to maturity, barring negative yield in its yield source, and a Yield Token (YT), which collects the variable yield until maturity. PT/IBT pools pay LPs; MetaVaults are curated vaults that allocate across pools and roll maturities.
Get the data (in order of preference)
- Spectra MCP tools, if connected:
spectra_find_yields, spectra_get_market, spectra_get_market_history, spectra_get_metavault, spectra_get_portfolio, spectra_protocol_info. The server is https://mcp.spectra.finance/mcp (no account or key).
- REST API directly, see references/api.md.
Workflow for "where should I earn yield on X?"
spectra_find_yields with asset (and chain / product if the user said so). Default ranking is by APY and hides thin or anomalous markets.
- For the top 2–3 candidates call
spectra_get_market (or spectra_get_metavault) to check liquidity, maturity, the APY breakdown and flags.
- If the user names an amount and
spectra_prepare_pt_trade is available (the trade endpoint), quote it without a receiver (quote only): the fixed APY for size can be lower than the headline rate. Without that tool, say so and link the market in the app.
- Answer with a compact table: product, asset, network, APY (fixed or variable), maturity, liquidity, link. State the
as_of time.
How to present numbers
- APYs are percent (4.8 = 4.8%). Say which kind: fixed (PT held to maturity), variable (LP, vault, underlying), implied (market-priced).
- A fixed rate is only fixed if the PT is held to maturity; selling early realises the market price.
- Always include the app link from the result so the user can verify, and the timestamp.
- Surface flags in plain words:
low_liquidity → price impact on size; near_maturity → little time left; apy_outlier → data looks wrong, do not recommend; expired → redeem, do not buy.
- Mention the main risks briefly (smart contract, underlying protocol, liquidity, curator for MetaVaults). Never call returns guaranteed; this is information, not financial advice.
- Tokenized-equity markets are not offered to persons in the US, UK, Canada, Australia or Singapore; the tools hide them.
Comparing with variable rates
Fixed APY vs the market's variable_apy_pct tells the user what the market expects: fixed above variable means they lock in more than the current floating yield (as long as it stays below). Use spectra_get_market_history (implied APY) to show the trend.
Portfolio questions
spectra_get_portfolio returns PT, YT (with claimable yield) and LP positions with USD values and suggested actions. Highlight matured PTs to redeem, claimable YT yield and positions maturing soon. For any action, hand off to the spectra-transactions skill if it is installed; otherwise give the app link from the result.
See references/concepts.md for definitions and edge cases.
1---2name: spectra-yields3description: Find, compare and explain Spectra fixed-rate yields, liquidity pools and MetaVaults across chains, and read a wallet's Spectra positions. Use when the user asks about fixed rates, Principal Tokens (PT), Yield Tokens (YT), "best yield on USDC/ETH/XRP", stablecoin yields, Spectra markets or MetaVaults, or what they hold on Spectra.4metadata:5 source: https://skillmd.com/skills/jiayaoqijia/spectra-yields6---78# Spectra yields910Spectra splits interest-bearing tokens into a **Principal Token (PT)**, which trades at a discount and locks a fixed rate when held to maturity, barring negative yield in its yield source, and a **Yield Token (YT)**, which collects the variable yield until maturity. PT/IBT pools pay LPs; **MetaVaults** are curated vaults that allocate across pools and roll maturities.1112## Get the data (in order of preference)13141. **Spectra MCP tools**, if connected: `spectra_find_yields`, `spectra_get_market`, `spectra_get_market_history`, `spectra_get_metavault`, `spectra_get_portfolio`, `spectra_protocol_info`. The server is `https://mcp.spectra.finance/mcp` (no account or key).152. **REST API** directly, see [references/api.md](references/api.md).1617## Workflow for "where should I earn yield on X?"18191. `spectra_find_yields` with `asset` (and `chain` / `product` if the user said so). Default ranking is by APY and hides thin or anomalous markets.202. For the top 2–3 candidates call `spectra_get_market` (or `spectra_get_metavault`) to check liquidity, maturity, the APY breakdown and flags.213. If the user names an amount and `spectra_prepare_pt_trade` is available (the trade endpoint), quote it without a receiver (quote only): the fixed APY for size can be lower than the headline rate. Without that tool, say so and link the market in the app.224. Answer with a compact table: product, asset, network, APY (fixed or variable), maturity, liquidity, link. State the `as_of` time.2324## How to present numbers2526- APYs are **percent** (4.8 = 4.8%). Say which kind: *fixed* (PT held to maturity), *variable* (LP, vault, underlying), *implied* (market-priced).27- A fixed rate is only fixed if the PT is **held to maturity**; selling early realises the market price.28- Always include the app link from the result so the user can verify, and the timestamp.29- Surface flags in plain words: `low_liquidity` → price impact on size; `near_maturity` → little time left; `apy_outlier` → data looks wrong, do not recommend; `expired` → redeem, do not buy.30- Mention the main risks briefly (smart contract, underlying protocol, liquidity, curator for MetaVaults). Never call returns guaranteed; this is information, not financial advice.31- Tokenized-equity markets are not offered to persons in the US, UK, Canada, Australia or Singapore; the tools hide them.3233## Comparing with variable rates3435Fixed APY vs the market's `variable_apy_pct` tells the user what the market expects: fixed above variable means they lock in more than the current floating yield (as long as it stays below). Use `spectra_get_market_history` (implied APY) to show the trend.3637## Portfolio questions3839`spectra_get_portfolio` returns PT, YT (with claimable yield) and LP positions with USD values and suggested actions. Highlight matured PTs to redeem, claimable YT yield and positions maturing soon. For any action, hand off to the `spectra-transactions` skill if it is installed; otherwise give the app link from the result.4041See [references/concepts.md](references/concepts.md) for definitions and edge cases.